モジュール 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を返す。