public final class AccessControlContext extends Object
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)
AccessController
Constructor and Description |
---|
AccessControlContext(AccessControlContext acc,
DomainCombiner combiner)
Create a new
AccessControlContext with the given
AccessControlContext and DomainCombiner . |
AccessControlContext(ProtectionDomain[] context)
Create an AccessControlContext with the given array of ProtectionDomains.
|
Modifier and Type | Method and Description |
---|---|
void |
checkPermission(Permission perm)
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.
|
boolean |
equals(Object obj)
Checks two AccessControlContext objects for equality.
|
DomainCombiner |
getDomainCombiner()
Get the
DomainCombiner associated with this
AccessControlContext . |
int |
hashCode()
Returns the hash code value for this context.
|
public AccessControlContext(ProtectionDomain[] context)
context
- the ProtectionDomains associated with this context.
The non-duplicate domains are copied from the array. Subsequent
changes to the array will not affect this AccessControlContext.NullPointerException
- if context
is null
public AccessControlContext(AccessControlContext acc, DomainCombiner combiner)
AccessControlContext
with the given
AccessControlContext
and DomainCombiner
.
This constructor associates the provided
DomainCombiner
with the provided
AccessControlContext
.
acc
- the AccessControlContext
associated
with the provided DomainCombiner
.combiner
- the DomainCombiner
to be associated
with the provided AccessControlContext
.NullPointerException
- if the provided
context
is null
.SecurityException
- if a security manager is installed and the
caller does not have the "createAccessControlContext"
SecurityPermission
public DomainCombiner getDomainCombiner()
DomainCombiner
associated with this
AccessControlContext
.
DomainCombiner
associated with this
AccessControlContext
, or null
if there is none.SecurityException
- if a security manager is installed and
the caller does not have the "getDomainCombiner"
SecurityPermission
public void checkPermission(Permission perm) throws AccessControlException
This method quietly returns if the access request is permitted, or throws a suitable AccessControlException otherwise.
perm
- the requested permission.AccessControlException
- if the specified permission
is not permitted, based on the current security policy and the
context encapsulated by this object.NullPointerException
- if the permission to check for is null.public boolean equals(Object obj)
equals
in class Object
obj
- the object we are testing for equality with this object.Object.hashCode()
,
HashMap
public int hashCode()
hashCode
in class Object
Object.equals(java.lang.Object)
,
System.identityHashCode(java.lang.Object)
Submit a bug or feature
For further API reference and developer documentation, see Java SE Documentation. That documentation contains more detailed, developer-targeted descriptions, with conceptual overviews, definitions of terms, workarounds, and working code examples.
Copyright © 1993, 2022, Oracle and/or its affiliates. All rights reserved. Use is subject to license terms. Also see the documentation redistribution policy.