AccessControlContext JDK 1.6)

Description

publicfinal class AccessControlContext

An AccessControlContext is used to make system resource access decisions based on the context it encapsulates.

More specifically, it encapsulates a context and has a single method, checkPermission, that is equivalent to the checkPermission method in the AccessController class, with one difference: The AccessControlContext checkPermission method makes access decisions based on the context it encapsulates, rather than that of the current execution thread.

Thus, the purpose of AccessControlContext is for those situations where a security check that should be made within a given context actually needs to be done from within a different context (for example, from within a worker thread).

An AccessControlContext is created by calling the AccessController.getContext method. The getContext method takes a "snapshot" of the current calling context, and places it in an AccessControlContext object, which it returns. A sample call is the following:

 
   AccessControlContext acc = AccessController.getContext()

Code within a different context can subsequently call the checkPermission method on the previously-saved AccessControlContext object. A sample call is the following:

 
   acc.checkPermission(permission)

See also: AccessController

Constructors

public AccessControlContext (AccessControlContext acc, DomainCombiner combiner)

Create a new AccessControlContext with the given AccessControlContext and DomainCombiner.

Create a new AccessControlContext with the given AccessControlContext and DomainCombiner. This constructor associates the provided DomainCombiner with the provided AccessControlContext.

Parameters:
- acc - the AccessControlContext associated with the provided DomainCombiner.

- combiner - the DomainCombiner to be associated with the provided AccessControlContext.
Throws:
- NullPointerException - if the provided context is null.

- SecurityException - if the caller does not have permission to invoke this constructor.
Since: 1.3

public AccessControlContext (ProtectionDomain context)

Create an AccessControlContext with the given set of ProtectionDomains.

pack-private AccessControlContext (ProtectionDomain context, boolean isPrivileged)

package private constructor for AccessController.getContext()

pack-private AccessControlContext (ProtectionDomain context, DomainCombiner combiner)

package private for AccessController

Methods

Hide/Show inherited methods

public void checkPermission (Permission perm) throws AccessControlException

Determines whether the access request indicated by the specified permission should be allowed or denied, based on the security policy currently in effect, and the context in this object.

public boolean equals (Object obj)

Checks two AccessControlContext objects for equality.

pack-private DomainCombiner getAssignedCombiner ()

get the assigned combiner from the privileged or inherited context

pack-privatestatic sun.security.util.Debug getDebug ()

public DomainCombiner getDomainCombiner ()

Get the DomainCombiner associated with this AccessControlContext.

Returns: the DomainCombiner associated with this AccessControlContext, or null if there is none.
Throws:
- SecurityException - if the caller does not have permission to get the DomainCombiner associated with this AccessControlContext.
Since: 1.3

public int hashCode ()

Returns the hash code value for this context.

pack-private boolean isPrivileged ()

Returns true if this context is privileged.

pack-private AccessControlContext optimize ()

Take the stack-based context (this) and combine it with the privileged or inherited context, if need be.