Class: java.security.ProtectionDomain

  • public class ProtectionDomain

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.

Authors:
@author Li Gong
@author Roland Schemers
@author Gary Ellison

Inheritance

Superclass tree:

Methods

  • ProtectionDomaintop

    public ProtectionDomain(CodeSource codesource, PermissionCollection permissions)
    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:
    @param codesource the codesource associated with this domain
    @param permissions the permissions granted to this domain
    Related Links:
    Google Code Search
    Stack Overflow

  • ProtectionDomaintop

    public ProtectionDomain(CodeSource codesource, PermissionCollection permissions, ClassLoader classloader, Principal[] principals)
    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 ClassLoaders and 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:
    @param codesource the CodeSource associated with this domain
    @param permissions the permissions granted to this domain
    @param classloader the ClassLoader associated with this domain
    @param principals the array of Principals associated with this domain. The contents of the array are copied to protect against subsequent modification.
    See:
    @see java.security.Policy.refresh()
    @see java.security.Policy.getPermissions(java.security.ProtectionDomain)
    Since:
    @since 1.4
    Related Links:
    Google Code Search
    Stack Overflow

  • getClassLoadertop

    public final ClassLoader getClassLoader()
    Returns the ClassLoader of this domain.
    Return:
    @return the ClassLoader of this domain which may be null.
    Since:
    @since 1.4
    Related Links:
    Google Code Search
    Stack Overflow

  • getCodeSourcetop

    public final CodeSource getCodeSource()
    Returns the CodeSource of this domain.
    Return:
    @return the CodeSource of this domain which may be null.
    Since:
    @since 1.2
    Related Links:
    Google Code Search
    Stack Overflow

  • getPermissionstop

    public final PermissionCollection getPermissions()
    Returns the static permissions granted to this domain.
    Return:
    @return the static set of permissions for this domain which may be null.
    See:
    @see java.security.Policy.refresh()
    @see java.security.Policy.getPermissions(java.security.ProtectionDomain)
    Related Links:
    Google Code Search
    Stack Overflow

  • getPrincipalstop

    public final Principal[] getPrincipals()
    Returns an array of principals for this domain.
    Return:
    @return a non-null array of principals for this domain. Returns a new array each time this method is called.
    Since:
    @since 1.4
    Related Links:
    Google Code Search
    Stack Overflow

  • impliestop

    public boolean implies(Permission permission)
    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 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 dynamically binding permissions, then the permission will be checked against the combination of the PermissionCollection supplied at construction and the current Policy binding.

    Parameters:
    @param permission the Permission object to check.
    Return:
    @return true if "permission" is implicit to this ProtectionDomain.
    Related Links:
    Google Code Search
    Stack Overflow

  • toStringtop

    public String toString()
    Convert a ProtectionDomain to a String.
    Return:
    @return a string representation of the object.
    Override hierarchy:
    toString from Object
    Related Links:
    Google Code Search
    Stack Overflow