java.security.cert

インタフェース PolicyNode

public interface PolicyNode

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

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