compact1, compact2, compact3

java.security

Class Permission

java.lang.Object

java.security.Permission

All Implemented Interfaces:

Serializable， Guard

已知直接子类：

AllPermission， BasicPermission， FilePermission， MBeanPermission， PrivateCredentialPermission， ServicePermission， SocketPermission， UnresolvedPermission， URLPermission

public abstract class Permission
extends Object
implements Guard, Serializable

用于表示对系统资源的访问的抽象类。所有权限都有一个名称（其解释取决于子类），以及用于定义特定权限子类的语义的抽象函数。

大多数权限对象还包括一个告诉该对象允许的操作的“操作”列表。例如，一个java.io.FilePermission对象权限的名字是一个文件的路径名（或目录），和行动清单（如“读、写”）指定哪些行为是授予指定的文件（或在指定目录下的文件）。行动清单是权限对象可选，如java.lang.RuntimePermission，不需要那样的列表；你可以有命名的许可（如“系统退出”）或你不喜欢的。

必须在每个子类实现的一个重要方法是比较implies权限的方法。基本上，“许可意味着允许P1 P2”意味着，如果一个人允许P1，一个自然是允许P2。因此，这不是一个平等的测试，而是更多的一个子集测试。

权限对象类似于字符串对象，当它们被创建时，它们是不可变的。子类不应该提供方法，它可以改变一个权限的状态，一旦它被创建。

另请参见：

Permissions， PermissionCollection， Serialized Form

构造方法摘要

构造方法

Constructor and Description
Permission(String name) 用指定名称构造一个权限。

方法摘要

Modifier and Type	Method and Description
void	checkGuard(Object object) 实现权限的保护接口。
abstract boolean	equals(Object obj) 检查两个权限对象的相等性。
abstract String	getActions() 返回字符串的动作。
String	getName() 返回此权限的名称。
abstract int	hashCode() 返回此权限对象的哈希代码值。
abstract boolean	implies(Permission permission) 检查指定的权限的操作是否是“此对象的操作所暗示的”。
PermissionCollection	newPermissionCollection() 返回一个空PermissionCollection对于一个给定的权限对象，或空如果不定义。
String	toString() 返回描述此权限的字符串。

Methods inherited from class java.lang.Object

clone, finalize, getClass, notify, notifyAll, wait, wait, wait

Constructor Detail

Permission

public Permission(String name)

用指定名称构造一个权限。

参数

name -允许对象被创建的名字。

方法详细信息

checkGuard

public void checkGuard(Object object)
                throws SecurityException

实现权限的保护接口。的 SecurityManager.checkPermission方法被调用时，通过该权限对象的权限检查。如果访问是被授予的，则返回。否则，抛出SecurityException。

Specified by:

checkGuard 接口 Guard

参数

object -被保护对象（目前忽略）。

异常

SecurityException -如果存在一个安全管理及其 checkPermission方法不允许访问。

另请参见：

Guard， GuardedObject， SecurityManager.checkPermission(java.security.Permission)

implies

public abstract boolean implies(Permission permission)

检查指定的权限的操作是否是“此对象的操作所暗示的”。

这必须通过权限的子类来实现，因为它们是唯一可以在权限对象上强制执行语义的子类。

的implies方法由AccessController用来确定是否一个请求是由另一个权限，称在当前执行的上下文中是有效的暗示。

参数

permission的权限检查。

结果

如果此对象所暗示的指定权限，则为假如果不是。

equals

public abstract boolean equals(Object obj)

检查两个权限对象的相等性。

不要使用equals方法访问控制决策；使用implies方法。

重写：

equals 方法重写，继承类 Object

参数

obj对象--我们为这个对象相等性测试。

结果

如果两个权限对象都是等效的。

另请参见：

Object.hashCode()， HashMap

hashCode

public abstract int hashCode()

返回此权限对象的哈希代码值。

许可对象所需的hashCode行为如下：

• 不管是在同一个权限对象超过一个java应用程序执行期间调用的方法，hashCode必须始终返回相同的整数。这个整数不需要保持一致，从一个应用程序的一个执行到另一个执行相同的应用程序。
• 如果根据equals方法两个权限对象是相等的，那么调用hashCode方法每一个权限对象必须产生相同的整数结果。

重写：

hashCode 方法重写，继承类 Object

结果

此对象的哈希代码值。

另请参见：

Object.equals(java.lang.Object)， System.identityHashCode(java.lang.Object)

getName

public final String getName()

返回此权限的名称。例如，在一个 java.io.FilePermission的情况下，该名称是一个路径名。

结果

此权限的名称。

getActions

public abstract String getActions()

返回字符串的动作。这是抽象的，所以子类可以推迟创建一个字符串表示，直到一个需要。子类应该总是返回它们所认为是它们的正则形式的行为。例如，两filepermission创建的对象通过以下：

perm1 =新filepermission（P1，“读、写”）；perm2 =新filepermission（P2，“写、读”）；

都返回“读、写”的方法被调用时 getActions。

结果

本许可的行为。

newPermissionCollection

public PermissionCollection newPermissionCollection()

返回一个空PermissionCollection对于一个给定的权限对象，或空如果不定义。类允许子类应重写此如果他们需要存储他们的权限为特别PermissionCollection对象提供正确的语义时， PermissionCollection.implies方法称为。如果返回null，那么方法的调用者自由存储任意PermissionCollection他们选择这种类型的权限（一个使用一个哈希表，一个使用一个向量，等）。

结果

这类许可的新对象或空PermissionCollection，如果没有定义。

toString

public String toString()

返回描述此权限的字符串。该公约是指定类的名称，该许可的名字，并在下面的格式：“行动（“类名”“名称”“行动”）”，或“（“类名”的“名”）“如果行动清单是null或空。

重写：

toString 方法重写，继承类 Object

结果

有关此权限的信息。