Build 1.0_r1(from source)

java.security
Class ProtectionDomain

java.lang.Object
  extended by 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.

Build 1.0_r1(from source)

Please submit a feedback, bug or feature