java.security.cert
类 PolicyQualifierInfo

java.lang.Object
  java.security.cert.PolicyQualifierInfo

public class PolicyQualifierInfo
extends Object

由 ASN.1 PolicyQualifierInfo 结构所表示的、不可变的策略限定符。

ASN.1 的定义如下：

   PolicyQualifierInfo ::= SEQUENCE {
        policyQualifierId       PolicyQualifierId,
        qualifier               ANY DEFINED BY policyQualifierId }
 

如果在 X.509 第 3 版的证书中有证书策略扩展，则该扩展包含一个或多个策略信息项的序列，每一项都由一个对象标识符 (OID) 和可选的限定符组成。在最终实体证书中，这些策略信息项指示了策略（根据此策略发布证书）和目的（该证书的可能用途）。在 CA 证书中，这些策略信息项则限制了包括此证书的证书路径的策略集。

PolicyQualifierInfo 对象的 Set 由 PolicyNode.getPolicyQualifiers 方法返回。这就允许带有具体策略要求的应用程序处理并验证每个策略限定符。处理策略限定符的应用程序在验证一个证书路径前，应该显式地将 policyQualifiersRejected 标志设置为 false（通过调用 PKIXParameters.setPolicyQualifiersRejected 方法）。

注意，PKIX 证书路径验证算法规定，对标记为关键的证书策略扩展中的策略限定符必须加以处理和验证。否则必须放弃该证书路径。如果 policyQualifiersRejected 标志设置为 false，那么为了遵守 PKIX ，由应用程序以此方式来验证所有的策略限定符。

并发访问

所有 PolicyQualifierInfo 对象必须是不可变的和线程安全的。也就是说，多个线程在单个 PolicyQualifierInfo 对象（或多个对象）上并发调用此类中所定义的各种方法不会产生坏的影响。要求 PolicyQualifierInfo 对象是不可变的并且是线程安全的，就允许将其传递到各种代码片断中，而无需担心协调访问。

从以下版本开始：

1.4

构造方法摘要

PolicyQualifierInfo(byte[] encoded)
根据已编码的字节创建一个 PolicyQualifierInfo 实例。

方法摘要

byte[]	getEncoded() 返回此 PolicyQualifierInfo 的 ASN.1 DER 编码形式。
byte[]	getPolicyQualifier() 返回此 PolicyQualifierInfo 的 qualifier 字段的 ASN.1 DER 编码形式。
String	getPolicyQualifierId() 返回此 PolicyQualifierInfo 的 policyQualifierId 字段。
String	toString() 返回此 PolicyQualifierInfo 的可打印表示形式。

从类 java.lang.Object 继承的方法

clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait

构造方法详细信息

PolicyQualifierInfo

public PolicyQualifierInfo(byte[] encoded)
                    throws IOException

根据已编码的字节创建一个 PolicyQualifierInfo 实例。在构造时复制该已编码的 byte 数组。

参数：

encoded - 包含 DER 编码中限定符的 byte 数组

抛出：

IOException - 如果该 byte 数组不表示一个有效并且可解析的策略限定符

方法详细信息

getPolicyQualifierId

public final String getPolicyQualifierId()

返回此 PolicyQualifierInfo 的 policyQualifierId 字段。policyQualifierId 是一个对象标识符 (OID)，由一组句点分隔的非负整数来表示。

返回：

OID（从不为 null）

getEncoded

public final byte[] getEncoded()

返回此 PolicyQualifierInfo 的 ASN.1 DER 编码形式。

返回：

以 ASN.1 DER 编码的字节（从不为 null）。注意，返回的是一个副本，所以每次调用此方法时都复制数据。

getPolicyQualifier

public final byte[] getPolicyQualifier()

返回此 PolicyQualifierInfo 的 qualifier 字段的 ASN.1 DER 编码形式。

返回：

qualifier 字段以 ASN.1 DER 编码的字节。注意，返回的是一个副本，所以每次调用此方法时都复制数据。

toString

public String toString()

返回此 PolicyQualifierInfo 的可打印表示形式。

覆盖：

类 Object 中的 toString

返回：

描述此 PolicyQualifierInfo 内容的 String