模块  java.base
软件包  java.security.cert

Class 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证书中，这些策略信息术语限制了包含此证书的证书路径的策略集。

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

    请注意，PKIX证书路径验证算法指定必须处理和验证证书策略扩展中标记为“关键”的任何策略限定符。 否则，必须拒绝证书路径。 如果policyQualifiersRejected标志设置为false， policyQualifiersRejected应用程序以此方式验证所有策略限定符以符合PKIX。

    并发访问

    所有PolicyQualifierInfo对象必须是不可变且线程安全的。 也就是说，多个线程可以同时在单个PolicyQualifierInfo对象（或多个）上调用此类中定义的方法，而不会产生任何不良影响。 要求PolicyQualifierInfo对象是不可变的并且线程安全允许它们被传递到各种代码而不必担心协调访问。

    从以下版本开始：
    1.4

    • 构造方法详细信息

      • PolicyQualifierInfo

        public PolicyQualifierInfo​(byte[] encoded)
                    throws IOException
        从编码的字节创建PolicyQualifierInfo的实例。 编码的字节数组在构造时复制。
        参数
        encoded - 包含DER编码中限定符的字节数组
        异常
        IOException - 如果字节数组不表示有效且可分析的策略限定符，则抛出此异常

    • 方法详细信息

      • 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的可打印表示 PolicyQualifierInfo 。
        重写：
        toString ，类 Object
        结果
        a String describing the contents of this PolicyQualifierInfo