程序包 java.security

类 UnresolvedPermission

java.lang.Object

java.security.Permission

java.security.UnresolvedPermission

所有已实现的接口:

Serializable, Guard

public final class UnresolvedPermission
extends Permission
implements Serializable

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.

另请参阅:

Permission, Permissions, PermissionCollection, Policy, 序列化表格

构造器概要

构造器

构造器	说明
UnresolvedPermission(String type, String name, String actions, 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.

方法概要

限定符和类型	方法	说明
String	getActions()	Returns the canonical string representation of the actions, which currently is the empty string "", since there are no actions for an UnresolvedPermission.
String	getUnresolvedActions()	Get the actions for the underlying permission that has not been resolved.
Certificate[]	getUnresolvedCerts()	Get the signer certificates (without any supporting chain) for the underlying permission that has not been resolved.
String	getUnresolvedName()	Get the target name of the underlying permission that has not been resolved.
String	getUnresolvedType()	Get the type (class name) of the underlying permission that has not been resolved.
boolean	implies(Permission p)	This method always returns false for unresolved permissions.

从类继承的方法 java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

从类继承的方法 java.security.Permission

checkGuard, getName, newPermissionCollection

构造器详细资料

UnresolvedPermission

public UnresolvedPermission(String type,
                            String name,
                            String actions,
                            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.

参数:

type - the class name of the Permission class that will be created when this unresolved permission is resolved.

name - the name of the permission.

actions - the actions of the permission.

certs - the certificates the permission's class was signed with. This is a list of certificate chains, where each chain is composed of a signer certificate and optionally its supporting certificate chain. Each chain is ordered bottom-to-top (i.e., with the signer certificate first and the (root) certificate authority last). The signer certificates are copied from the array. Subsequent changes to the array will not affect this UnsolvedPermission.

方法详细资料

implies

public boolean implies(Permission p)

This method always returns false for unresolved permissions. That is, an UnresolvedPermission is never considered to imply another permission.

指定者:

implies 在类中 Permission

参数:

p - the permission to check against.

返回:

false.

getActions

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. 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.

指定者:

getActions 在类中 Permission

返回:

the empty string "".

getUnresolvedType

public String getUnresolvedType()

Get the type (class name) of the underlying permission that has not been resolved.

返回:

the type (class name) of the underlying permission that has not been resolved

从以下版本开始:

1.5

getUnresolvedName

public String getUnresolvedName()

Get the target name of the underlying permission that has not been resolved.

返回:

the target name of the underlying permission that has not been resolved, or null, if there is no target name

从以下版本开始:

1.5

getUnresolvedActions

public String getUnresolvedActions()

Get the actions for the underlying permission that has not been resolved.

返回:

the actions for the underlying permission that has not been resolved, or null if there are no actions

从以下版本开始:

1.5

getUnresolvedCerts

public Certificate[] getUnresolvedCerts()

Get the signer certificates (without any supporting chain) for the underlying permission that has not been resolved.

返回:

the signer certificates for the underlying permission that has not been resolved, or null, if there are no signer certificates. Returns a new array each time this method is called.

从以下版本开始:

1.5