JavaTM 2 Platform
Standard Ed. 6

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 - 如果 namenull
IllegalArgumentException - 如果 name 為空或者 actions 無效。
方法詳細資訊

implies

public boolean implies(Permission p)
檢查 PropertyPermission 物件是否「暗指」指定的權限。

更明確地說,如果此方法滿足以下條件,則返回 true:

覆寫:
類別 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 物件。

JavaTM 2 Platform
Standard Ed. 6

提交錯誤或意見

版權所有 2008 Sun Microsystems, Inc. 保留所有權利。請遵守GNU General Public License, version 2 only