compact1, compact2, compact3

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を返す。