javax.security.auth
类 PrivateCredentialPermission

java.lang.Object
  java.security.Permission
      javax.security.auth.PrivateCredentialPermission

所有已实现的接口：

Serializable, Guard

public final class PrivateCredentialPermission
extends Permission

此类用来保护对属于特定 Subject 的私有 Credential 的访问。Subject 通过 Principals Set 表示。

此 Permission 的目标名称指定了一个 Credential 类名和一个 Principals Set。此 Permission 的操作的唯一有效值是 "read"。目标名称必须遵守下面的语法：

        CredentialClass {PrincipalClass "PrincipalName"}*
 

    grant {
        permission javax.security.auth.PrivateCredentialPermission
                "com.sun.PrivateCredential com.sun.Principal \"duke\"",
                "read";
    };
 

    grant {
        permission javax.security.auth.PrivateCredentialPermission
                "a.b.Credential a.b.Principal "*"",
                "read";
    };
 

另外，PrincipalClass/PrincipalName 对可以重复：

    grant {
        permission javax.security.auth.PrivateCredentialPermission
                "a.b.Credential a.b.Principal "duke" c.d.Principal "dukette"",
                "read";
    };
 

另请参见：

序列化表格

PrivateCredentialPermission

public PrivateCredentialPermission(String name,
                                   String actions)

创建具有指定 name 的新 PrivateCredentialPermission。name 指定了一个 Credential 类和一个 Principal 集合。

参数：

name - 指定 Credential 类和 Principal 集合的名称。

actions - 指定 Credential 能够被读取的操作。

抛出：

IllegalArgumentException - 如果 name 没有遵循正确的语法或者如果 actions 不是 "read"。

getCredentialClass

public String getCredentialClass()

返回与此 PrivateCredentialPermission 相关联的 Credential 的 Class 名称。

返回：

与此 PrivateCredentialPermission 相关联的 Credential 的 Class 名称。

getPrincipals

public String[][] getPrincipals()

返回与此 PrivateCredentialPermission 相关联的 Principal 类和名称。信息以二维数组 (array[x][y]) 的形式返回。'x' 值对应于 Principal 的类和名称对的数目。当 (y==0) 时，它对应于 Principal 类值，当 (y==1) 时,它对应于 Principal 名称值。例如，array[0][0] 对应于数组中的第一个 Principal 的类名。array[0][1] 对应于数组中的第一个 Principal 的 Principal 名。

返回：

与此 PrivateCredentialPermission 相关联的 Principal 类和名称。

implies

public boolean implies(Permission p)

检查此 PrivateCredentialPermission 是否暗含指定的Permission。

如果满足下面的条件，则此方法返回 true：

• p 是 PrivateCredentialPermission 的一个实例，且

• 此对象的目标名称隐含了 p 的目标名称。例如：

          [* P1 "duke"] implies [a.b.Credential P1 "duke"].
          [C1 P1 "duke"] implies [C1 P1 "duke" P2 "dukette"].
          [C1 P2 "dukette"] implies [C1 P1 "duke" P2 "dukette"].
   

指定者：

类 Permission 中的 implies

参数：

p - 所要检查的 Permission。

返回：

如果此 PrivateCredentialPermission 隐含了指定的 Permission，则返回 true；否则返回 false。

equals

public boolean equals(Object obj)

检查两个 PrivateCredentialPermission 对象是否相等。检查 obj 是否为 PrivateCredentialPermission，是否与此对象具有相同的证书类以及相同的 Principals。在各自的 Permission 的目标名称中的 Principals 的顺序是无关的。

指定者：

类 Permission 中的 equals

参数：

obj - 要与此对象进行相等性测试的对象。

返回：

如果 obj 为 PrivateCredentialPermission，与此对象具有相同的证书类以及相同的 Principals，则返回 true。

另请参见：

Object.hashCode(), Hashtable

hashCode

public int hashCode()

返回此对象的哈希码值。

指定者：

类 Permission 中的 hashCode

返回：

此对象的哈希码值。

另请参见：

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

getActions

public String getActions()

返回操作的“规范的字符串表示形式”。此方法总是返回 String "read"。

指定者：

类 Permission 中的 getActions

返回：

操作（总是返回 "read"）。

newPermissionCollection

public PermissionCollection newPermissionCollection()

返回 PermissionCollection 中同类的 PrivateCredentialPermissions 集合。没有定义这种 PermissionCollection，所以此方法总是返回 null。

覆盖：

类 Permission 中的 newPermissionCollection

返回：

所有情况下都返回 null。

版权所有 2007 Sun Microsystems, Inc. 保留所有权利。 请遵守许可证条款。另请参阅文档重新分发政策。