javax.net.ssl

クラス TrustManagerFactory

java.lang.Object

javax.net.ssl.TrustManagerFactory

public class TrustManagerFactory
extends Object

このクラスは、信頼データのソースに基づいて、信頼マネージャーのファクトリとして機能します。各信頼マネージャーは、セキュアソケットが使用する信頼データを管理します。信頼データは、キーストア、またはプロバイダ固有のソース、あるいはその両方に基づきます。

導入されたバージョン:

1.4

関連項目:

TrustManager

コンストラクタのサマリー

コンストラクタ

修飾子	コンストラクタと説明
protected	TrustManagerFactory(TrustManagerFactorySpi factorySpi, Provider provider, String algorithm) TrustManagerFactory オブジェクトを生成します。

メソッドのサマリー

メソッド

修飾子と型	メソッドと説明
String	getAlgorithm() この TrustManagerFactory オブジェクトのアルゴリズム名を返します。
static String	getDefaultAlgorithm() デフォルトの TrustManagerFactory アルゴリズム名を取得します。
static TrustManagerFactory	getInstance(String algorithm) 鍵マネージャーのファクトリとして機能する TrustManagerFactory オブジェクトを返します。
static TrustManagerFactory	getInstance(String algorithm, Provider provider) 鍵マネージャーのファクトリとして機能する TrustManagerFactory オブジェクトを返します。
static TrustManagerFactory	getInstance(String algorithm, String provider) 鍵マネージャーのファクトリとして機能する TrustManagerFactory オブジェクトを返します。
Provider	getProvider() この TrustManagerFactory オブジェクトのプロバイダを返します。
TrustManager[]	getTrustManagers() 信頼データの種類ごとに 1 つの信頼マネージャーを返します。
void	init(KeyStore ks) 証明書発行局と関連する信頼データのソースを使用して、このファクトリを初期化します。
void	init(ManagerFactoryParameters spec) プロバイダ固有の信頼データのソースを使用して、このファクトリを初期化します。

クラス java.lang.Object から継承されたメソッド

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

コンストラクタの詳細

TrustManagerFactory

protected TrustManagerFactory(TrustManagerFactorySpi factorySpi,
                   Provider provider,
                   String algorithm)

TrustManagerFactory オブジェクトを生成します。

パラメータ:

factorySpi - 委譲先

provider - プロバイダ

algorithm - アルゴリズム

メソッドの詳細

getDefaultAlgorithm

public static final String getDefaultAlgorithm()

デフォルトの TrustManagerFactory アルゴリズム名を取得します。

デフォルトの TrustManager は、ssl.TrustManagerFactory.algorithm セキュリティープロパティーの値を目的のアルゴリズム名に設定することによって、実行時に変更できます。アルゴリズム名は、Java セキュリティープロパティーファイルで設定するか、Security.setProperty(String, String) を呼び出すことによって設定します。

戻り値:

Java セキュリティープロパティーファイルに指定されているデフォルトのアルゴリズム名。プロパティーが存在しない場合は、実装固有のデフォルト。

getAlgorithm

public final String getAlgorithm()

この TrustManagerFactory オブジェクトのアルゴリズム名を返します。

これは、この TrustManagerFactory オブジェクトを作成した getInstance 呼び出しのいずれかに指定された名前と同じです。

戻り値:

この TrustManagerFactory オブジェクトのアルゴリズム名

getInstance

public static final TrustManagerFactory getInstance(String algorithm)
                                             throws NoSuchAlgorithmException

鍵マネージャーのファクトリとして機能する TrustManagerFactory オブジェクトを返します。

このメソッドは、最優先の Provider から順に、登録済みのセキュリティー Provider のリストをトラバースします。指定されたアルゴリズムをサポートする最初のプロバイダからの TrustManagerFactorySpi の実装をカプセル化する新しい TrustManagerFactory オブジェクトが返されます。

登録済みプロバイダのリストは、Security.getProviders() メソッド経由で取得できます。

パラメータ:

algorithm - 要求された信頼管理アルゴリズムの標準名。標準のアルゴリズム名については、『Java Secure Socket Extension リファレンスガイド』を参照。

戻り値:

新しい TrustManagerFactory オブジェクト。

例外:

NoSuchAlgorithmException - 指定したアルゴリズムの TrustManagerFactorySpi の実装をサポートするプロバイダが存在しない場合。

NullPointerException - アルゴリズムが null である場合。

関連項目:

Provider

getInstance

public static final TrustManagerFactory getInstance(String algorithm,
                              String provider)
                                             throws NoSuchAlgorithmException,
                                                    NoSuchProviderException

鍵マネージャーのファクトリとして機能する TrustManagerFactory オブジェクトを返します。

指定されたプロバイダからの KeyManagerFactorySpi の実装をカプセル化する新しい KeyManagerFactory オブジェクトが返されます。指定したプロバイダは、セキュリティープロバイダリストに登録する必要があります。

登録済みプロバイダのリストは、Security.getProviders() メソッド経由で取得できます。

パラメータ:

algorithm - 要求された信頼管理アルゴリズムの標準名。標準のアルゴリズム名については、『Java Secure Socket Extension リファレンスガイド』を参照。

provider - プロバイダ名。

戻り値:

新しい TrustManagerFactory オブジェクト

例外:

NoSuchAlgorithmException - 指定されたプロバイダに指定されたアルゴリズムの TrustManagerFactorySpi の実装がない場合。

NoSuchProviderException - 指定されたプロバイダがセキュリティープロバイダリストに登録されていない場合。

IllegalArgumentException - プロバイダ名が null または空の場合。

NullPointerException - アルゴリズムが null である場合。

関連項目:

Provider

getInstance

public static final TrustManagerFactory getInstance(String algorithm,
                              Provider provider)
                                             throws NoSuchAlgorithmException

鍵マネージャーのファクトリとして機能する TrustManagerFactory オブジェクトを返します。

指定された Provider オブジェクトからの TrustManagerFactorySpi の実装をカプセル化する新しい TrustManagerFactory オブジェクトが返されます。指定された Provider オブジェクトは、プロバイダリストに登録する必要はありません。

パラメータ:

algorithm - 要求された信頼管理アルゴリズムの標準名。標準のアルゴリズム名については、『Java Secure Socket Extension リファレンスガイド』を参照。

provider - プロバイダのインスタンス。

戻り値:

新しい TrustManagerFactory オブジェクト。

例外:

NoSuchAlgorithmException - 指定された Provider オブジェクトに指定されたアルゴリズムの TrustManagerFactorySpi の実装がない場合。

IllegalArgumentException - プロバイダが null である場合。

NullPointerException - アルゴリズムが null である場合。

関連項目:

Provider

getProvider

public final Provider getProvider()

この TrustManagerFactory オブジェクトのプロバイダを返します。

戻り値:

この TrustManagerFactory オブジェクトのプロバイダ

init

public final void init(KeyStore ks)
                throws KeyStoreException

証明書発行局と関連する信頼データのソースを使用して、このファクトリを初期化します。

プロバイダは通常、キーストアを使用して、信頼を判断します。

より柔軟に初期化を行うには、init(ManagerFactoryParameters) を参照してください。

パラメータ:

ks - キーストアまたは null

例外:

KeyStoreException - この操作が失敗した場合

init

public final void init(ManagerFactoryParameters spec)
                throws InvalidAlgorithmParameterException

プロバイダ固有の信頼データのソースを使用して、このファクトリを初期化します。

一部のプロバイダでは、キーストア以外に、初期化パラメータを必要とすることがあります。特定のプロバイダの利用者は、プロバイダによる定義に従って、適切な ManagerFactoryParameters の実装を渡す必要があります。その後、プロバイダは ManagerFactoryParameters 実装の特定のメソッドを呼び出し、必要な情報を取得できます。

パラメータ:

spec - プロバイダ固有のパラメータ仕様の実装

例外:

InvalidAlgorithmParameterException - エラーが検出された場合

getTrustManagers

public final TrustManager[] getTrustManagers()

信頼データの種類ごとに 1 つの信頼マネージャーを返します。

戻り値:

信頼マネージャー

例外:

IllegalStateException - ファクトリが初期化されていない場合。