| java.lang.Object
 java.security.ProtectionDomain
| ProtectionDomain | | public class ProtectionDomain (Code) | |
This ProtectionDomain class encapsulates the characteristics of a domain,
which encloses a set of classes whose instances are granted a set
of permissions when being executed on behalf of a given set of Principals.
A static set of permissions can be bound to a ProtectionDomain when it is
constructed; such permissions are granted to the domain regardless of the
Policy in force. However, to support dynamic security policies, a
ProtectionDomain can also be constructed such that it is dynamically
mapped to a set of permissions by the current Policy whenever a permission
is checked.
version:
1.33, 10/10/06
author:
Li Gong
author:
Roland Schemers
author:
Gary Ellison |
| ProtectionDomain | | public ProtectionDomain(CodeSource codesource, PermissionCollection permissions)(Code) | | Creates a new ProtectionDomain with the given CodeSource and
Permissions. If the permissions object is not null, then
setReadOnly()) will be called on the passed in
Permissions object. The only permissions granted to this domain
are the ones specified; the current Policy will not be consulted.
Parameters:
codesource - the codesource associated with this domain
Parameters:
permissions - the permissions granted to this domain |
| ProtectionDomain | | public ProtectionDomain(CodeSource codesource, PermissionCollection permissions, ClassLoader classloader, Principal[] principals)(Code) | | Creates a new ProtectionDomain qualified by the given CodeSource,
Permissions, ClassLoader and array of Principals. If the
permissions object is not null, then setReadOnly()
will be called on the passed in Permissions object.
The permissions granted to this domain are dynamic; they include
both the static permissions passed to this constructor, and any
permissions granted to this domain by the current Policy at the
time a permission is checked.
This constructor is typically used by
SecureClassLoader ClassLoaders and
DomainCombiner DomainCombiners which delegate to
Policy to actively associate the permissions granted to
this domain. This constructor affords the
Policy provider the opportunity to augment the supplied
PermissionCollection to reflect policy changes.
Parameters:
codesource - the CodeSource associated with this domain
Parameters:
permissions - the permissions granted to this domain
Parameters:
classloader - the ClassLoader associated with this domain
Parameters:
principals - the array of Principals associated with this domain
See Also: Policy.refresh
See Also: Policy.getPermissions(ProtectionDomain)
since:
1.4 |
| getClassLoader | | final public ClassLoader getClassLoader()(Code) | | Returns the ClassLoader of this domain.
the ClassLoader of this domain which may be null.
since:
1.4 |
| getCodeSource | | final public CodeSource getCodeSource()(Code) | | Returns the CodeSource of this domain.
the CodeSource of this domain which may be null.
since:
1.2 |
| getPrincipals | | final public Principal[] getPrincipals()(Code) | | Returns an array of principals for this domain.
returns a non-null array of principals for this domain.Changes to this array will have no impact on the ProtectionDomain.
since:
1.4 |
| implies | | public boolean implies(Permission permission)(Code) | | Check and see if this ProtectionDomain implies the permissions
expressed in the Permission object.
The set of permissions evaluated is a function of whether the
ProtectionDomain was constructed with a static set of permissions
or it was bound to a dynamically mapped set of permissions.
If the ProtectionDomain was constructed to a
ProtectionDomain.ProtectionDomain(CodeSource,PermissionCollection)statically bound PermissionCollection then the permission will
only be checked against the PermissionCollection supplied at
construction.
However, if the ProtectionDomain was constructed with
the constructor variant which supports
ProtectionDomain.ProtectionDomain(CodeSource,PermissionCollection,ClassLoader,java.security.Principal[]) dynamically binding permissions, then the permission will be checked against the
combination of the PermissionCollection supplied at construction and
the current Policy binding.
Parameters:
permission - the Permission object to check. true if "permission" is implicit to this ProtectionDomain. |
| toString | | public String toString()(Code) | | Convert a ProtectionDomain to a String.
|
|
|