モジュール java.base
パッケージ java.security.cert

インタフェースPolicyNode


  • public interface PolicyNode
    PKIX証明書パス検査アルゴリズムで定義されている、不変で有効なポリシー・ツリー・ノードです。

    PKIX証明書パス検査アルゴリズムの出力の1つに有効なポリシー・ツリーがあります。このポリシー・ツリーには、有効であると判断されたポリシー、その判断をした手段、および検出されたポリシー修飾子が含まれています。 ツリーの深さnは、検査された証明書パスの長さnになります。

    ほとんどのアプリケーションでは、有効なポリシー・ツリーを検査する必要はありません。 PKIXParametersでポリシー関連のパラメータを設定することにより、アプリケーションのポリシー処理目標を実現できます。 ただし、有効なポリシー・ツリーは、より複雑なアプリケーション、特にポリシー修飾子を処理するアプリケーションに利用できます。

    PKIXCertPathValidatorResult.getPolicyTreeは、有効なポリシー・ツリーのルート・ノードを返します。 getChildrenメソッドとgetParentメソッドを使用すると、ツリーをトラバースできます。 あるノードに関するデータは、PolicyNodeのほかのメソッドで取得できます。

    並行アクセス

    すべてのPolicyNodeオブジェクトは、不変で、スレッドに対して安全である必要があります。 このクラスで定義されたメソッドは、悪影響を与えることなく、複数スレッドが並行して単一PolicyNodeオブジェクト(または1つ以上)上で呼び出すことができます。 このことは、このクラスのすべてのpublicフィールドとメソッド、そしてサブクラスで追加またはオーバーライドされたpublicフィールドとメソッドに当てはまります。

    導入されたバージョン:
    1.4
    • メソッドのサマリー

      すべてのメソッド インスタンス・メソッド 抽象メソッド 
      修飾子と型 メソッド 説明
      Iterator<? extends PolicyNode> getChildren()
      このノードの子のイテレータを返します。
      int getDepth()
      有効なポリシー・ツリーで、このノードの深さを返します。
      Set<String> getExpectedPolicies()
      処理される次の証明書でこのノードの有効なポリシーを満たすと期待されるポリシーのセットを返します。
      PolicyNode getParent()
      このノードの親を返します。このノードがルート・ノードである場合はnullを返します。
      Set<? extends PolicyQualifierInfo> getPolicyQualifiers()
      このノードが表す有効なポリシーに関連付けられたポリシー修飾子のセットを返します。
      String getValidPolicy()
      このノードが表す有効なポリシーを返します。
      boolean isCritical()
      処理された最新の証明書の、証明書ポリシー拡張機能のクリティカル・インジケータを返します。
    • メソッドの詳細

      • getParent

        PolicyNode getParent()
        このノードの親を返します。このノードがルート・ノードである場合はnullを返します。
        戻り値:
        このノードの親。このノードがルート・ノードである場合はnull
      • getChildren

        Iterator<? extends PolicyNode> getChildren()
        このノードの子のイテレータを返します。 Iteratorのremoveメソッドを使用してこのノードの子を変更しようとすると、UnsupportedOperationExceptionがスローされます。
        戻り値:
        このノードの子のイテレータ
      • getDepth

        int getDepth()
        有効なポリシー・ツリーで、このノードの深さを返します。
        戻り値:
        このノードの深さ。0はルート・ノード、1はルート・ノードの子、など
      • getValidPolicy

        String getValidPolicy()
        このノードが表す有効なポリシーを返します。
        戻り値:
        このノードが表す有効なポリシーのString OID。 ルート・ノードでは、このメソッドは、常に特別なanyPolicy OID「2.5.29.32.0」を返す。
      • getPolicyQualifiers

        Set<? extends PolicyQualifierInfo> getPolicyQualifiers()
        このノードが表す有効なポリシーに関連付けられたポリシー修飾子のセットを返します。
        戻り値:
        PolicyQualifierInfoの不変のSet ルート・ノードでは、常に空のSetを返す。
      • getExpectedPolicies

        Set<String> getExpectedPolicies()
        処理される次の証明書でこのノードの有効なポリシーを満たすと期待されるポリシーのセットを返します。
        戻り値:
        期待されるポリシーのString OIDの不変のSet ルート・ノードでは、このメソッドは1つの要素、つまり特別なanyPolicy OID「2.5.29.32.0」を持つSetを常に返す。
      • isCritical

        boolean isCritical()
        処理された最新の証明書の、証明書ポリシー拡張機能のクリティカル・インジケータを返します。
        戻り値:
        拡張機能がクリティカルであるとマークされた場合はtrue、そうでない場合はfalse ルート・ノードでは、常にfalseを返す。