compact1, compact2, compact3

javax.security.auth

Class PrivateCredentialPermission

java.lang.Object

java.security.Permission

javax.security.auth.PrivateCredentialPermission

All Implemented Interfaces:

Serializable ， Guard

public final class PrivateCredentialPermission
extends Permission

此类用于保护对属于特定Subject私有凭据的访问。 该Subject由一组校长表示。

此Permission的目标名称指定了凭证类名称和一组主体。 此权限操作的唯一有效值是“读取”。 目标名称必须遵守以下语法：

  CredentialClass {PrincipalClass "PrincipalName"}* 

例如，以下权限授予对主体拥有的com.sun.PrivateCredential的访问权限，该对象具有名称为“duke”的com.sun.Principal。 请注意，尽管此示例以及以下所有示例在grant语句中不包含Codebase，SignedBy或Principal信息（出于简单的原因），但实际的策略配置应在适当时指定该信息。

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

如果CredentialClass为“*”，则授予对属于指定的Subject的所有私有凭据的访问Subject 。 如果“PrincipalName”为“*”，那么授权给具有指定的Principal （实际PrincipalName无关紧要）的任何Subject所拥有的指定Principal的访问Principal 。 例如，以下授权访问由具有abPrincipal的任何Subject拥有的abCredential。

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

如果PrincipalClass和“PrincipalName”均为“*”，则访问权限将被授予由任何Subject拥有的指定Subject 。

此外，可以重复PrincipalClass / PrincipalName配对：

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

上述授权访问私有证书，“abCredential”，属于Subject与至少两个相关联的校长：“abPrincipal”的名称，“公爵”和“cdPrincipal”，名称为“dukette”。

另请参见：

Serialized Form

构造方法摘要

构造方法

Constructor and Description
PrivateCredentialPermission(String name, String actions) 创建一个新的 PrivateCredentialPermission与指定的 name 。

方法摘要

Modifier and Type	Method and Description
boolean	equals(Object obj) 检查两个 PrivateCredentialPermission对象的相等性。
String	getActions() 返回动作的“规范字符串表示”。
String	getCredentialClass() 返回与此 PrivateCredentialPermission关联的凭据的类名。
String[][]	getPrincipals() 返回与此 PrivateCredentialPermission的 Principal类和名称。
int	hashCode() 返回此对象的哈希码值。
boolean	implies(Permission p) 检查这 PrivateCredentialPermission意味着指定的 Permission 。
PermissionCollection	newPermissionCollection() 在PermissionCollection中返回PrivateCredentialPermissions的均匀 PermissionCollection 。

Methods inherited from class java.security.Permission

checkGuard, getName, toString

Methods inherited from class java.lang.Object

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

构造方法详细信息

PrivateCredentialPermission

public PrivateCredentialPermission(String name,
                                   String actions)

创建一个新的PrivateCredentialPermission与指定的name 。 该name同时指定凭证类和Principal集。

参数

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

actions - 指定可以读取 actions的操作。

异常

IllegalArgumentException - 如果 name不符合正确的语法，或 actions不是“读”。

方法详细信息

getCredentialClass

public String getCredentialClass()

返回与此 PrivateCredentialPermission关联的凭据的类名。

结果

与该 PrivateCredentialPermission相关联的凭证的类名称。

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名称。

结果

这个 Principal类和名字与这个 PrivateCredentialPermission 。

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"]. 

Specified by:

implies在类别 Permission

参数

p - 要检查的 Permission 。

结果

如果这个 PrivateCredentialPermission意味着指定的 Permission ，则为true，否则为false。

equals

public boolean equals(Object obj)

检查两个PrivateCredentialPermission对象的相等性。 检查obj是否为PrivateCredentialPermission ，并且具有与该对象相同的凭据类，以及与该对象相同的主体。 校长在各自的权限目标名称中的顺序是不相关的。

Specified by:

equals在类别 Permission

参数

obj - 我们正在测试与此对象相等的对象。

结果

如果obj为 PrivateCredentialPermission ，则为true，与该对象具有相同的凭证类，并具有与此对象相同的主体。

另请参见：

Object.hashCode() ， HashMap

hashCode

public int hashCode()

返回此对象的哈希码值。

Specified by:

hashCode在类别 Permission

结果

该对象的哈希码值。

另请参见：

Object.equals(java.lang.Object) ， System.identityHashCode(java.lang.Object)

getActions

public String getActions()

返回动作的“规范字符串表示”。 这个方法总是返回String，“read”。

Specified by:

getActions在类 Permission

结果

动作（总是返回“read”）。

newPermissionCollection

public PermissionCollection newPermissionCollection()

在PermissionCollection中返回PrivateCredentialPermissions的均匀PermissionCollection 。 没有这样定义PermissionCollection ，所以这个方法总是返回null 。

重写：

newPermissionCollection在类别 Permission

结果

在所有情况下都为null。