| java.lang.Object
 java.security.Permission
java.security.UnresolvedPermission
| UnresolvedPermission | | final public class UnresolvedPermission extends Permission implements java.io.Serializable(Code) | | The UnresolvedPermission class is used to hold Permissions that
were "unresolved" when the Policy was initialized.
An unresolved permission is one whose actual Permission class
does not yet exist at the time the Policy is initialized (see below).
The policy for a Java runtime (specifying
which permissions are available for code from various principals)
is represented by a Policy object.
Whenever a Policy is initialized or refreshed, Permission objects of
appropriate classes are created for all permissions
allowed by the Policy.
Many permission class types
referenced by the policy configuration are ones that exist
locally (i.e., ones that can be found on CLASSPATH).
Objects for such permissions can be instantiated during
Policy initialization. For example, it is always possible
to instantiate a java.io.FilePermission, since the
FilePermission class is found on the CLASSPATH.
Other permission classes may not yet exist during Policy
initialization. For example, a referenced permission class may
be in a JAR file that will later be loaded.
For each such class, an UnresolvedPermission is instantiated.
Thus, an UnresolvedPermission is essentially a "placeholder"
containing information about the permission.
Later, when code calls AccessController.checkPermission
on a permission of a type that was previously unresolved,
but whose class has since been loaded, previously-unresolved
permissions of that type are "resolved". That is,
for each such UnresolvedPermission, a new object of
the appropriate class type is instantiated, based on the
information in the UnresolvedPermission.
To instantiate the new class, UnresolvedPermission assumes
the class provides a zero, one, and/or two-argument constructor.
The zero-argument constructor would be used to instantiate
a permission without a name and without actions.
A one-arg constructor is assumed to take a String
name as input, and a two-arg constructor is assumed to take a
String name and String actions
as input. UnresolvedPermission may invoke a
constructor with a null name and/or actions.
If an appropriate permission constructor is not available,
the UnresolvedPermission is ignored and the relevant permission
will not be granted to executing code.
The newly created permission object replaces the
UnresolvedPermission, which is removed.
Note that the getName method for an
UnresolvedPermission returns the
type (class name) for the underlying permission
that has not been resolved.
See Also: java.security.Permission
See Also: java.security.Permissions
See Also: java.security.PermissionCollection
See Also: java.security.Policy
version:
1.38 07/05/05
author:
Roland Schemers |
| Constructor Summary | |
| public | UnresolvedPermission(String type, String name, String actions, java.security.cert.Certificate certs)
Creates a new UnresolvedPermission containing the permission
information needed later to actually create a Permission of the
specified class, when the permission is resolved.
Parameters:
type - the class name of the Permission class that will becreated when this unresolved permission is resolved.
Parameters:
name - the name of the permission.
Parameters:
actions - the actions of the permission.
Parameters:
certs - the certificates the permission's class was signed with.This is a list of certificate chains, where each chain is composed of asigner certificate and optionally its supporting certificate chain.Each chain is ordered bottom-to-top (i.e., with the signer certificatefirst and the (root) certificate authority last). |
| Method Summary | |
| public boolean | equals(Object obj)
Checks two UnresolvedPermission objects for equality. | | public String | getActions()
Returns the canonical string representation of the actions,
which currently is the empty string "", since there are no actions for
an UnresolvedPermission. | | public String | getUnresolvedActions()
Get the actions for the underlying permission that
has not been resolved. | | public java.security.cert.Certificate[] | getUnresolvedCerts()
Get the signer certificates (without any supporting chain)
for the underlying permission that has not been resolved. | | public String | getUnresolvedName()
Get the target name of the underlying permission that
has not been resolved. | | public String | getUnresolvedType()
Get the type (class name) of the underlying permission that
has not been resolved. | | public int | hashCode()
Returns the hash code value for this object. | | public boolean | implies(Permission p)
This method always returns false for unresolved permissions.
That is, an UnresolvedPermission is never considered to
imply another permission.
Parameters:
p - the permission to check against. | | public PermissionCollection | newPermissionCollection()
Returns a new PermissionCollection object for storing
UnresolvedPermission objects. | | Permission | resolve(Permission p, java.security.cert.Certificate certs)
try and resolve this permission using the class loader of the permission
that was passed in. | | public String | toString()
Returns a string describing this UnresolvedPermission. |
| UnresolvedPermission | | public UnresolvedPermission(String type, String name, String actions, java.security.cert.Certificate certs)(Code) | | Creates a new UnresolvedPermission containing the permission
information needed later to actually create a Permission of the
specified class, when the permission is resolved.
Parameters:
type - the class name of the Permission class that will becreated when this unresolved permission is resolved.
Parameters:
name - the name of the permission.
Parameters:
actions - the actions of the permission.
Parameters:
certs - the certificates the permission's class was signed with.This is a list of certificate chains, where each chain is composed of asigner certificate and optionally its supporting certificate chain.Each chain is ordered bottom-to-top (i.e., with the signer certificatefirst and the (root) certificate authority last). The signer certificates are copied from the array. Subsequent changes tothe array will not affect this UnsolvedPermission. |
| equals | | public boolean equals(Object obj)(Code) | | Checks two UnresolvedPermission objects for equality.
Checks that obj is an UnresolvedPermission, and has
the same type (class) name, permission name, actions, and
certificates as this object.
To determine certificate equality, this method only compares
actual signer certificates. Supporting certificate chains
are not taken into consideration by this method.
Parameters:
obj - the object we are testing for equality with this object. true if obj is an UnresolvedPermission, and has the same type (class) name, permission name, actions, andcertificates as this object. |
| getActions | | public String getActions()(Code) | | Returns the canonical string representation of the actions,
which currently is the empty string "", since there are no actions for
an UnresolvedPermission. That is, the actions for the
permission that will be created when this UnresolvedPermission
is resolved may be non-null, but an UnresolvedPermission
itself is never considered to have any actions.
the empty string "". |
| getUnresolvedActions | | public String getUnresolvedActions()(Code) | | Get the actions for the underlying permission that
has not been resolved.
the actions for the underlying permission thathas not been resolved, or nullif there are no actions
since:
1.5 |
| getUnresolvedCerts | | public java.security.cert.Certificate[] getUnresolvedCerts()(Code) | | Get the signer certificates (without any supporting chain)
for the underlying permission that has not been resolved.
the signer certificates for the underlying permission thathas not been resolved, or null, if there are no signer certificates.Returns a new array each time this method is called.
since:
1.5 |
| getUnresolvedName | | public String getUnresolvedName()(Code) | | Get the target name of the underlying permission that
has not been resolved.
the target name of the underlying permission thathas not been resolved, or null,if there is no targe name
since:
1.5 |
| getUnresolvedType | | public String getUnresolvedType()(Code) | | Get the type (class name) of the underlying permission that
has not been resolved.
the type (class name) of the underlying permission thathas not been resolved
since:
1.5 |
| hashCode | | public int hashCode()(Code) | | Returns the hash code value for this object.
a hash code value for this object. |
| implies | | public boolean implies(Permission p)(Code) | | This method always returns false for unresolved permissions.
That is, an UnresolvedPermission is never considered to
imply another permission.
Parameters:
p - the permission to check against. false. |
| newPermissionCollection | | public PermissionCollection newPermissionCollection()(Code) | | Returns a new PermissionCollection object for storing
UnresolvedPermission objects.
a new PermissionCollection object suitable for storing UnresolvedPermissions. |
| toString | | public String toString()(Code) | | Returns a string describing this UnresolvedPermission. The convention
is to specify the class name, the permission name, and the actions, in
the following format: '(unresolved "ClassName" "name" "actions")'.
information about this UnresolvedPermission. |
|
|