模块 java.base
包 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”则不是。

要授予的操作以包含一个或多个逗号分隔关键字列表的字符串形式传递给构造方法。可能的关键字是“读”和“写”。它们的含义定义如下：

读
读取权限。允许调用 System.getProperty。
write
写权限。允许调用 System.setProperty。

操作字符串在处理之前被转换为小写。

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

自从：
1.2
参见：

  • 构造方法详细信息

    • PropertyPermission

      public PropertyPermission(String  name, String  actions)
      创建具有指定名称的新 PropertyPermission 对象。名称是系统属性的名称，并且动作包含对属性授予的所需操作的逗号分隔列表。可能的操作是“读”和“写”。
      参数：
      name - PropertyPermission 的名称。
      actions - 操作字符串。
      抛出：
      NullPointerException - 如果 name 是 null。
      IllegalArgumentException - 如果 name 为空或 actions 无效。

  • 方法详情

    • implies

      public boolean implies(Permission  p)
      检查此 PropertyPermission 对象是否“暗示”了指定的权限。

      更具体地说，如果出现以下情况，此方法将返回 true：

      • p是 PropertyPermission 的实例，
      • p的动作是该对象动作的子集，并且
      • p的名称由此对象的名称隐含。例如，“java.*”表示“java.home”。
      重写：
      implies 在类 BasicPermission 中
      参数：
      p - 检查的权限。
      返回：
      如果此对象隐含了指定的权限，则为 true，否则为 false。

    • equals

      public boolean equals(Object  obj)
      检查两个 PropertyPermission 对象是否相等。检查那个对象是一个 PropertyPermission，并且与此对象具有相同的名称和操作。
      重写：
      equals 在类 BasicPermission 中
      参数：
      obj - 我们正在测试与此对象是否相等的对象。
      返回：
      如果 obj 是 PropertyPermission，并且与此 PropertyPermission 对象具有相同的名称和操作，则为 true。
      参见：

    • hashCode

      public int hashCode()
      返回此对象的哈希码值。使用的散列码是此权限名称的散列码，即 getName().hashCode() ，其中 getName 来自 Permission 超类。
      重写：
      hashCode 在类 BasicPermission 中
      返回：
      此对象的哈希码值。
      参见：

    • getActions

      public String  getActions()
      返回操作的“规范字符串表示”。也就是说，此方法始终按以下顺序返回当前操作：读、写。例如，如果此 PropertyPermission 对象允许写入和读取操作，则对 getActions 的调用将返回字符串“read,write”。
      重写：
      getActions 在类 BasicPermission 中
      返回：
      动作的规范字符串表示。

    • newPermissionCollection

      public PermissionCollection  newPermissionCollection()
      返回一个新的 PermissionCollection 对象，用于存储 PropertyPermission 对象。
      重写：
      newPermissionCollection 在类 BasicPermission 中
      返回：
      适合存储 PropertyPermissions 的新 PermissionCollection 对象。