java.util
类 PropertyPermission

java.lang.Object
  java.security.Permission
      java.security.BasicPermission
          java.util.PropertyPermission

所有已实现的接口：

Serializable, Guard

public final class PropertyPermission
extends BasicPermission

此类用于属性权限。

其名称就是属性名（"java.home"、"os.name"，等等）。命名约定遵守层次结构属性命名约定。另外，名称的末尾可能有一个星号，星号前有一个 "."，用来表示通配符。例如："java.*" 或 "*" 是有效的，而 "java.*" 或 "a*b"则无效。

将所要授予的动作权限以字符串的形式传递给构造方法，该字符串包含一个零列表或多个由逗号分隔的关键字。可能的关键字有 "read" 和 "write"。其含义定义如下：

read

读权限。允许调用 System.getProperty。

write

写权限。允许调用 System.setProperty。

处理前会将动作字符串转换为小写字母。

授予代码访问某些系统属性的权限前应该小心。例如，授予访问 "java.home" 系统属性的权限就会将有关系统环境（Java 安装目录）的敏感信息给予潜在的恶意代码。另外，授予访问 "user.name" 和 "user.home" 系统属性的权限就会将有关用户环境（用户的帐户名和主目录）的敏感信息给予潜在的恶意代码。

从以下版本开始：

1.2

另请参见：

BasicPermission, Permission, Permissions, PermissionCollection, SecurityManager

PropertyPermission

public PropertyPermission(String name,
                          String actions)

创建带指定名称的新 PropertyPermission 对象。其名称就是属性名，并且 actions 包含在该属性上授予的所需动作列表，各动作用逗号分隔。可能的动作有 "read" 和 "write"。

参数：

name - PropertyPermission 的名称。

actions - 动作字符串。

抛出：

NullPointerException - 如果 name 为 null。

IllegalArgumentException - 如果 name 为空或者 actions 无效。

implies

public boolean implies(Permission p)

检查 PropertyPermission 对象是否“暗指”指定的权限。

更明确地说，如果此方法满足以下条件，则返回 true：

• p 是 PropertyPermission 的一个实例，

• p 的动作是此对象的动作的一个子集，并且

• 此对象的名称暗指了 p 的名字。例如，"java.*" 暗指 "java.home"。

覆盖：

类 BasicPermission 中的 implies

参数：

p - 所要检查的权限。

返回：

如果对象暗指了指定的权限，则返回 true；否则返回 false。

equals

public boolean equals(Object obj)

检查两个 PropertyPermission 对象是否相等。检查 obj 是否为一个 PropertyPermission，并且与此对象具有相同的名称和动作。

覆盖：

类 BasicPermission 中的 equals

参数：

obj - 要与此对象进行相等性测试的对象。

返回：

如果 obj 是一个 PropertyPermission，并且与此 PropertyPermission 对象具有相同的名称和动作，则返回 true。

另请参见：

Object.hashCode(), Hashtable

hashCode

public int hashCode()

返回对象的哈希码值。所用的哈希码是此权限名的哈希码，也就是 getName().hashCode()，其中 getName 来自 Permission 超类。

覆盖：

类 BasicPermission 中的 hashCode

返回：

对象的哈希码值。

另请参见：

Object.equals(java.lang.Object), Hashtable

getActions

public String getActions()

返回动作的“规范化字符串表示形式”。也就是说，此方法总是以下列顺序返回存在的动作：read, write。例如，如果此 PropertyPermission 对象允许写和读操作，则调用 getActions 将返回字符串 "read,write"。

覆盖：

类 BasicPermission 中的 getActions

返回：

动作的规范化字符串表示形式。

newPermissionCollection

public PermissionCollection newPermissionCollection()

用于存储 PropertyPermission 对象的新 PermissionCollection 对象。

覆盖：

类 BasicPermission 中的 newPermissionCollection

返回：

适合存储 PropertyPermissions 的新 PermissionCollection 对象。

版权所有 2007 Sun Microsystems, Inc. 保留所有权利。 请遵守许可证条款。另请参阅文档重新分发政策。