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

Interface PolicyNode

  • public interface PolicyNode
    由PKIX证书路径验证算法定义的不可变有效策略树节点。

    PKIX认证路径验证算法的输出之一是有效的策略树，其中包括确定为有效的策略，如何达到此确定以及遇到的任何策略限定符。 此树的深度为n ，其中n是已验证的证书路径的长度。

    大多数应用程序不需要检查有效的策略树。 他们可以通过在PKIXParameters设置与策略相关的参数来实现其策略处理目标。 但是，有效的策略树可用于更复杂的应用程序，尤其是那些处理策略限定符的应用程序。

    PKIXCertPathValidatorResult.getPolicyTree返回有效策略树的根节点。 可以使用getChildren和getParent方法遍历树。 可以使用PolicyNode其他方法检索关于特定节点的数据。

    并发访问

    所有PolicyNode对象必须是不可变且线程安全的。 多个线程可以在单个PolicyNode对象（或多个）上同时调用此类中定义的方法，而不会产生任何不良影响。 此规定适用于此类的所有公共字段和方法以及由子类添加或重写的任何公共字段和方法。

    从以下版本开始：
    1.4

    • 方法详细信息

      • getParent

        PolicyNode getParent()
        返回此节点的父节点，如果这是根节点，则返回 null 。
        结果
        此节点的父节点，如果这是根节点， null

      • getChildren

        Iterator<? extends PolicyNode> getChildren()
        返回此节点的子节点上的迭代器。 任何通过Iterator的remove方法修改此节点的子节点的Iterator必须抛出UnsupportedOperationException 。
        结果
        这个节点的子节点上的迭代器

      • getDepth

        int getDepth()
        返回有效策略树中此节点的深度。
        结果
        此节点的深度（根节点为0，子节点为1，依此类推）

      • getValidPolicy

        String getValidPolicy()
        返回此节点表示的有效策略。
        结果
        String此节点表示的有效策略的OID。 对于根节点，此方法始终返回特殊的anyPolicy OID：“2.5.29.32.0”。

      • getPolicyQualifiers

        Set<? extends PolicyQualifierInfo> getPolicyQualifiers()
        返回与此节点表示的有效策略关联的策略限定符集。
        结果
        不可变的Set of PolicyQualifierInfo s。 对于根节点，此值始终为空Set 。

      • getExpectedPolicies

        Set<String> getExpectedPolicies()
        返回在下一个要处理的证书中满足此节点的有效策略的预期策略集。
        结果
        不可变的Set预期政策String OID。 对于根节点，此方法始终返回带有一个元素的Set ，特殊的anyPolicy OID：“2.5.29.32.0”。

      • isCritical

        boolean isCritical()
        返回最近处理的证书中证书策略扩展的关键性指示符。
        结果
        true如果扩展标记为严重， false 。 对于根节点，始终返回false 。