java.security
類別 BasicPermission

java.lang.Object
  java.security.Permission
      java.security.BasicPermission

所有已實作的介面：

Serializable, Guard

直接已知子類別：

AudioPermission, AuthPermission, AWTPermission, DelegationPermission, LoggingPermission, ManagementPermission, MBeanServerPermission, MBeanTrustPermission, NetPermission, PropertyPermission, ReflectPermission, RuntimePermission, SecurityPermission, SerializablePermission, SQLPermission, SSLPermission, SubjectDelegationPermission, WebServicePermission

public abstract class BasicPermission
extends Permission
implements Serializable

BasicPermission 類別擴展 Permission 類別，並且可以用作希望與 BasicPermission 遵守相同命名約定的權限的基礎類別。

BasicPermission 的名稱就是給定權限的名稱（例如，"exit"、"setFactory"、"print.queueJob" 等）。命名約定遵守層次結構屬性命名約定。星號可能單獨出現，也可能緊跟在 "." 後面出現在名稱的末尾，它表示通配符比對。例如，"*" 和 "java.*" 有效，而 "*java"、"a*b" 和 "java*" 無效。

不使用（從 Permission 繼承的）操作字元串。因此，BasicPermission 通常用作“指定”權限（包含名稱但不包含操作列表的權限；或者具有指定權限或者不具有）的基礎類別。需要時子類別可以在 BasicPermission 之上實作操作。

另請參見：

Permission, Permissions, PermissionCollection, RuntimePermission, SecurityPermission, PropertyPermission, AWTPermission, NetPermission, SecurityManager, 序列化表格

建構子摘要

BasicPermission(String name)
創建具有指定名稱的新 BasicPermission。

BasicPermission(String name, String actions)
創建具有指定名稱的新 BasicPermission 物件。

方法摘要

boolean	equals(Object obj) 檢查兩個 BasicPermission 物件是否相等。
String	getActions() 返回操作的規範化字元串表示形式，該表示形式當前為空字元串 ""，因為不存在 BasicPermission 的操作。
int	hashCode() 返回此物件的雜湊碼值。
boolean	implies(Permission p) 檢查此物件是否“暗含”指定的權限。
PermissionCollection	newPermissionCollection() 用於存儲 BasicPermission 物件的新 PermissionCollection 物件。

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

checkGuard, getName, toString

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

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

建構子詳細資訊

BasicPermission

public BasicPermission(String name)

創建具有指定名稱的新 BasicPermission。name 是權限的符號名，如 "setFactory"、"print.queueJob" 或 "topLevelWindow"，等等。

參數：

name - BasicPermission 的名稱。

拋出：

NullPointerException - 如果 name 為 null

IllegalArgumentException - 如果 name 為空。

BasicPermission

public BasicPermission(String name,
                       String actions)

創建具有指定名稱的新 BasicPermission 物件。該名稱是 BasicPermission 的符號名，以及當前不使用操作 String。

參數：

name - BasicPermission 的名稱。

actions - 忽略。

拋出：

NullPointerException - 如果 name 為 null

IllegalArgumentException - 如果 name 為空。

方法詳細資訊

implies

public boolean implies(Permission p)

檢查此物件是否“暗含”指定的權限。

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

• p 的類別與此物件的類別相同，並且

• p 的名稱等於此物件的名稱或者（在使用通配符的情況下）此物件的名稱暗含它的名稱。例如，"a.b.*" 暗含 "a.b.c"。

指定者：

類別 Permission 中的 implies

參數：

p - 所要檢查的權限。

返回：

如果傳遞的權限等於此權限或者暗含於此權限，則返回 true；否則返回 false。

equals

public boolean equals(Object obj)

檢查兩個 BasicPermission 物件是否相等。檢查 obj 的類別是否與此物件的類別相同並且具有與此物件相同的名稱。

指定者：

類別 Permission 中的 equals

參數：

obj - 要與此物件進行相等性測試的物件。

返回：

如果 obj 為 BasicPermission 並且具有與此 BasicPermission 物件相同的名稱，則返回 true；否則返回 false。

另請參見：

Object.hashCode(), Hashtable

hashCode

public int hashCode()

返回此物件的雜湊碼值。所用的雜湊碼是名稱的雜湊碼，也就是 getName().hashCode()，其中 getName 來自 Permission 父級類別。

指定者：

類別 Permission 中的 hashCode

返回：

此物件的雜湊碼值。

另請參見：

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

getActions

public String getActions()

返回操作的規範化字元串表示形式，該表示形式當前為空字元串 ""，因為不存在 BasicPermission 的操作。

指定者：

類別 Permission 中的 getActions

返回：

空字元串 ""。

newPermissionCollection

public PermissionCollection newPermissionCollection()

用於存儲 BasicPermission 物件的新 PermissionCollection 物件。

BasicPermissionCollection 存儲 BasicPermission 權限的集合。

BasicPermission 物件必須以允許將它們按任意順序插入的方式來存儲，但同時也允許以有效（並一致）的方式實作 PermissionCollection 的 implies 方法。

覆寫：

類別 Permission 中的 newPermissionCollection

返回：

適合存儲 BasicPermissions 的新 PermissionCollection 物件。