PrivateCredentialPermission (Java Platform SE 8 )

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。

Class PrivateCredentialPermission

构造方法摘要

方法摘要

Methods inherited from class java.security.Permission

Methods inherited from class java.lang.Object

构造方法详细信息

PrivateCredentialPermission

方法详细信息

getCredentialClass

getPrincipals

implies

equals

hashCode

getActions

newPermissionCollection