JavaTM Platform
Standard Ed. 6

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()
          このノードの親を返します。
 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、または特別な値「any-policy」。 ルートノードでは、常に特別な値「any-policy」を返す

getPolicyQualifiers

Set<? extends PolicyQualifierInfo> getPolicyQualifiers()
このノードが表す有効なポリシーに関連付けられたポリシー修飾子のセットを返します。

戻り値:
PolicyQualifierInfo の不変の Set。ルートノードでは、常に空の Set を返す

getExpectedPolicies

Set<String> getExpectedPolicies()
処理される次の証明書でこのノードの有効なポリシーを満たすと期待されるポリシーのセットを返します。

戻り値:
期待されるポリシーの String OID の不変の Set、または特別な値「any-policy」だけを持つ不変の Set。 ルートノードでは、常に単一値「any-policy」を持つ Set を返す

isCritical

boolean isCritical()
処理された最新の証明書の、証明書ポリシー拡張機能のクリティカルインジケータを返します。

戻り値:
拡張機能がクリティカルであるとマークされた場合は true、そうでない場合は false。ルートノードでは、常に false を返す

JavaTM Platform
Standard Ed. 6

バグの報告と機能のリクエスト
さらに詳しい API リファレンスおよび開発者ドキュメントについては、Java SE 開発者用ドキュメントを参照してください。開発者向けの詳細な解説、概念の概要、用語の定義、バグの回避策、およびコード実例が含まれています。

Copyright 2006 Sun Microsystems, Inc. All rights reserved. Use is subject to license terms. Documentation Redistribution Policy も参照してください。