java.security
Class ProtectionDomain

java.lang.Object
  java.security.ProtectionDomain

public class ProtectionDomain
extends Object

This class represents a domain in which classes from the same source (URL) and signed by the same keys are stored. All the classes inside are given the same permissions.

Note: a class can only belong to one and only one protection domain.

Constructor Summary

ProtectionDomain(CodeSource cs, PermissionCollection permissions)
Constructs a protection domain from the given code source and the permissions that that should be granted to the classes which are encapsulated in it.

ProtectionDomain(CodeSource cs, PermissionCollection permissions, ClassLoader cl, Principal[] principals)
Constructs a protection domain from the given code source and the permissions that that should be granted to the classes which are encapsulated in it.

Method Summary

ClassLoader	getClassLoader() Returns the ClassLoader associated with the ProtectionDomain
CodeSource	getCodeSource() Returns the code source of this domain.
PermissionCollection	getPermissions() Returns the permissions that should be granted to the classes which are encapsulated in this domain.
Principal[]	getPrincipals() Returns the Principals associated with this ProtectionDomain.
boolean	implies(Permission permission) Determines whether the permission collection of this domain implies the argument permission.
String	toString() Returns a string containing a concise, human-readable description of the receiver.

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait

Constructor Detail

ProtectionDomain

public ProtectionDomain(CodeSource cs,
                        PermissionCollection permissions)

Constructs a protection domain from the given code source and the permissions that that should be granted to the classes which are encapsulated in it.

Parameters:

cs -

permissions -

ProtectionDomain

public ProtectionDomain(CodeSource cs,
                        PermissionCollection permissions,
                        ClassLoader cl,
                        Principal[] principals)

Constructs a protection domain from the given code source and the permissions that that should be granted to the classes which are encapsulated in it. This constructor also allows the association of a ClassLoader and group of Principals.

Parameters:

cs - the CodeSource associated with this domain

permissions - the Permissions associated with this domain

cl - the ClassLoader associated with this domain

principals - the Principals associated with this domain

Method Detail

getClassLoader

public final ClassLoader getClassLoader()

Returns the ClassLoader associated with the ProtectionDomain

Returns:

ClassLoader associated ClassLoader

getCodeSource

public final CodeSource getCodeSource()

Returns the code source of this domain.

Returns:

java.security.CodeSource the code source of this domain

getPermissions

public final PermissionCollection getPermissions()

Returns the permissions that should be granted to the classes which are encapsulated in this domain.

Returns:

java.security.PermissionCollection collection of permissions associated with this domain.

getPrincipals

public final Principal[] getPrincipals()

Returns the Principals associated with this ProtectionDomain. A change to the returned array will not impact the ProtectionDomain.

Returns:

Principals[] Principals associated with the ProtectionDomain.

implies

public boolean implies(Permission permission)

Determines whether the permission collection of this domain implies the argument permission.

Parameters:

permission - java.security.Permission the permission to check.

Returns:

boolean true if this permission collection implies the argument and false otherwise.

toString

public String toString()

Returns a string containing a concise, human-readable description of the receiver.

Overrides:

toString in class Object

Returns:

String a printable representation for the receiver.