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(String name, String actions)
創建帶指定名稱的新 PropertyPermission 物件。

方法摘要

boolean	equals(Object obj) 檢查兩個 PropertyPermission 物件是否相等。
String	getActions() 返回動作的「規範化字元串表示形式」。
int	hashCode() 返回物件的雜湊碼值。
boolean	implies(Permission p) 檢查 PropertyPermission 物件是否「暗指」指定的權限。
PermissionCollection	newPermissionCollection() 用於存儲 PropertyPermission 物件的新 PermissionCollection 物件。

從類別 java.security.Permission 繼承的方法

checkGuard, getName, toString

從類別 java.lang.Object 繼承的方法

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

建構子詳細資訊

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 物件。