public class ProtectionDomain extends Object

Since:

1.2

• Constructor Summary

  Constructors

  Creates a new ProtectionDomain with the given CodeSource and permissions.

  Creates a new ProtectionDomain qualified by the given CodeSource, permissions, ClassLoader and array of principals.

• Method Summary

  Returns the ClassLoader of this domain.

  Returns the CodeSource of this domain.

  Returns the static permissions granted to this domain.

  Returns an array of principals for this domain.

  boolean

  Check and see if this ProtectionDomain implies the permissions expressed in the Permission object.

  final boolean

  Returns true if this domain contains only static permissions and does not check the current Policy at the time of permission checking.

  toString()

  Convert a ProtectionDomain to a String.

• Constructor Details

  • ProtectionDomain

    Creates a new ProtectionDomain with the given CodeSource and permissions. If permissions is not null, then setReadOnly() will be called on the passed in permissions.

    The permissions granted to this domain are static, i.e. invoking the staticPermissionsOnly() method returns true. They contain only the ones passed to this constructor and the current policy will not be consulted.

    Parameters:

    codesource - the codesource associated with this domain

    permissions - the permissions granted to this domain

  • ProtectionDomain

    Creates a new ProtectionDomain qualified by the given CodeSource, permissions, ClassLoader and array of principals. If permissions is not null, then setReadOnly() will be called on the passed in permissions.

    The permissions granted to this domain are dynamic, i.e. invoking the staticPermissionsOnly() method returns false. 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 ClassLoaders and DomainCombiners which delegate to the Policy object 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

    permissions - the permissions granted to this domain

    classloader - the ClassLoader associated with this domain

    principals - the array of Principal objects associated with this domain. The contents of the array are copied to protect against subsequent modification.

    Since:

    1.4

    See Also:

    • Policy.refresh()
    • Policy.getPermissions(ProtectionDomain)

• Method Details

  • getCodeSource

    Returns the CodeSource of this domain.

    Returns:

    the CodeSource of this domain which may be null.

    Since:

    1.2

  • getClassLoader

    Returns the ClassLoader of this domain.

    Returns:

    the ClassLoader of this domain which may be null.

    Since:

    1.4

  • getPrincipals

    public final Principal[] getPrincipals()

    Returns an array of principals for this domain.

    Returns:

    a non-null array of principals for this domain. Returns a new array each time this method is called.

    Since:

    1.4

  • getPermissions

    Returns the static permissions granted to this domain.

    Returns:

    the static set of permissions for this domain which may be null.

    See Also:

    • Policy.refresh()
    • Policy.getPermissions(ProtectionDomain)

  • staticPermissionsOnly

    public final boolean staticPermissionsOnly()

    Returns true if this domain contains only static permissions and does not check the current Policy at the time of permission checking.

    Returns:

    true if this domain contains only static permissions.

    Since:

    9

  • implies

    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 staticPermissionsOnly() method returns true, then the permission will only be checked against the PermissionCollection supplied at construction.

    Otherwise, the permission will be checked against the combination of the PermissionCollection supplied at construction and the current policy binding.

    Parameters:

    perm - the {code Permission} object to check.

    Returns:

    true if perm is implied by this ProtectionDomain.

  • toString

    Convert a ProtectionDomain to a String.

    Overrides:

    toString in class Object

    Returns:

    a string representation of the object.