JavaTM 2 Platform
Standard Ed. 6

java.security
類別 Permissions

java.lang.Object
  繼承者 java.security.PermissionCollection
      繼承者 java.security.Permissions
所有已實作的介面:
Serializable

public final class Permissions
extends PermissionCollection
implements Serializable

此類別表示一個不同種類別的 Permission 集合。也就是說,它包含組編到 PermissionCollection 中的不同型別的 Permission 物件。例如,如果將任何 java.io.FilePermission 物件添加到此類別的實例中,它們都將被存儲在單個 PermissionCollection 中。調用 FilePermission 類別的 newPermissionCollection 方法返回的是 PermissionCollection。類似的,任何 java.lang.RuntimePermission 物件都存儲在調用 RuntimePermission 類別的 newPermissionCollection 方法所返回的 PermissionCollection 中。因此,此類別表示 PermissionCollection 的集合。

當調用 add 方法添加 Permission 時,Permission 將被存儲在合適的 PermissionCollection 中。如果還沒有這樣的集合存在,則確定 Permission 物件的類別並對該類別調用 newPermissionCollection 方法來創建 PermissionCollection,然後將其添加到 Permissions 物件中。如果 newPermissionCollection 返回 null,那麼將創建和使用一個預設使用 hashtable 的 PermissionCollection。每個 hashtable 項存儲了一個 Permission 物件作為鍵和值。

通過 elements 方法返回的列舉不是快速失敗 的。正在對一個集合進行列舉時,不應該修改該集合。

另請參見:
Permission, PermissionCollection, AllPermission

建構子摘要
Permissions()
          創建一個不包含任何 PermissionCollection 的新 Permissions 物件。
 
方法摘要
 void add(Permission permission)
          將一個 permission 物件添加到該權限所屬的類別的 PermissionCollection 中。
 Enumeration<Permission> elements()
          返回此 Permissions 物件中所有 PermissionCollection 中的所有 Permission 物件的列舉。
 boolean implies(Permission permission)
          查看此物件用於指定 permission 類別的 permissions 的 PermissionCollection 是否暗含了 permission 物件中表示的權限。
 
從類別 java.security.PermissionCollection 繼承的方法
isReadOnly, setReadOnly, toString
 
從類別 java.lang.Object 繼承的方法
clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait
 

建構子詳細資訊

Permissions

public Permissions()
創建一個不包含任何 PermissionCollection 的新 Permissions 物件。

方法詳細資訊

add

public void add(Permission permission)
將一個 permission 物件添加到該權限所屬的類別的 PermissionCollection 中。例如,如果 permission 是 FilePermission,則將它添加到存儲在此 Permissions 物件中的 FilePermissionCollection 中。 如果不存在合適的 collection,則此方法創建一個新的 PermissionCollection 物件(並且向其中添加權限)。

指定者:
類別 PermissionCollection 中的 add
參數:
permission - 要添加的 Permission 物件。
拋出:
SecurityException - 如果此 Permissions 物件被標記為只讀。
另請參見:
PermissionCollection.isReadOnly()

implies

public boolean implies(Permission permission)
查看此物件用於指定 permission 類別的 permissions 的 PermissionCollection 是否暗含了 permission 物件中表示的權限。如果合適的 PermissionCollection(例如,用於 FilePermission 的 FilePermissionCollection)中權限的組合一起暗含了指定的權限,則返回 true。

例如,假定在此 Permissions 物件中有一個 FilePermissionCollection,它包含一個指定對 "/tmp" 目錄所有子目錄下的所有檔案進行 "read" 存取的 FilePermission,以及另一個指定對 "/tmp/scratch/foo" 目錄下所有檔案進行 "write" 存取的 FilePermission。那麼如果使用指定對 "/tmp/scratch/foo" 目錄下的檔案進行 "read" 和 "write" 存取權限的 permission 作為參數調用 implies 方法,則返回 true

此外,如果此 PermissionCollection 套件含 AllPermission,此方法將總是返回 true。

指定者:
類別 PermissionCollection 中的 implies
參數:
permission - 要檢查的 Permission 物件。
返回:
如果 "permission" 所屬的 PermissionCollection 中的權限暗含了 "permission",則返回 true;否則,返回 false。

elements

public Enumeration<Permission> elements()
返回此 Permissions 物件中所有 PermissionCollection 中的所有 Permission 物件的列舉。

指定者:
類別 PermissionCollection 中的 elements
返回:
所有 Permission 的列舉。

JavaTM 2 Platform
Standard Ed. 6

提交錯誤或意見

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