Module  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的删除方法修改此节点的子节点都必须抛出一个UnsupportedOperationException 。
        结果
        这个节点的孩子的迭代器

      • getDepth

        int getDepth​()
        返回此节点在有效策略树中的深度。
        结果
        该节点的深度（根节点为0，其子节点为1，等等）

      • getValidPolicy

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

      • getPolicyQualifiers

        Set<? extends PolicyQualifierInfo> getPolicyQualifiers​()
        返回与此节点所表示的有效策略相关联的策略限定符集。
        结果
        一个不变的Set的PolicyQualifierInfo 。 对于根节点，这总是一个空的Set 。

      • getExpectedPolicies

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

      • isCritical

        boolean isCritical​()
        返回最近处理的证书中的证书策略扩展的关键指标。
        结果
        true如果扩展标记为关键，否则为false 。 对于根节点，总是返回false 。