クラスTrustManagerFactory

java.lang.Object
javax.net.ssl.TrustManagerFactory
public class TrustManagerFactory extends Object
このクラスは、信頼データのソースに基づいて、信頼マネージャのファクトリとして機能します。 各信頼マネージャは、セキュア・ソケットが使用する信頼データを管理します。 信頼資料は、KeyStoreまたはプロバイダ固有のソース(あるいはその両方)に基づいています。

Javaプラットフォームのすべての実装は、次の標準のTrustManagerFactoryアルゴリズムをサポートする必要があります:

  • PKIX
このアルゴリズムは、Javaセキュリティ標準アルゴリズム名仕様の「TrustManagerFactoryセクション」で説明されています。 サポートされているその他のアルゴリズムについては、実装のリリース・ドキュメントを参照してください。

導入されたバージョン:
1.4
関連項目:

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

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

  • メソッドのサマリー

    修飾子と型
    メソッド
    説明
    final String
    getAlgorithm()
    このTrustManagerFactoryオブジェクトのアルゴリズム名を返します。
    static final String
    getDefaultAlgorithm()
    デフォルトのTrustManagerFactoryアルゴリズム名を取得します。
    static final TrustManagerFactory
    getInstance(String algorithm)
    キー・マネージャのファクトリとして機能するTrustManagerFactoryオブジェクトを返します。
    static final TrustManagerFactory
    getInstance(String algorithm, String provider)
    キー・マネージャのファクトリとして機能するTrustManagerFactoryオブジェクトを返します。
    static final TrustManagerFactory
    getInstance(String algorithm, Provider provider)
    キー・マネージャのファクトリとして機能するTrustManagerFactoryオブジェクトを返します。
    final Provider
    getProvider()
    このTrustManagerFactoryオブジェクトのプロバイダを返します。
    final TrustManager[]
    getTrustManagers()
    信頼データの種類ごとに1つの信頼マネージャを返します。
    final void
    init(KeyStore ks)
    証明書発行局と関連する信頼データのソースを使用して、このファクトリを初期化します。
    final 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セキュリティ・プロパティの値を目的のアルゴリズム名に設定します。

      戻り値:
      ssl.TrustManagerFactory.algorithmセキュリティ・プロパティにより指定されているデフォルトのアルゴリズム名。そのようなプロパティが存在しない場合は実装固有のデフォルト。
      関連項目:

    • 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()メソッド経由で取得できます。

      実装上のノート:
      JDKリファレンス実装では、さらにjdk.security.provider.preferred Securityプロパティを使用して、指定したアルゴリズムの優先プロバイダ順序を決定します。 これは、Security.getProviders()によって返されるプロバイダの順序とは異なる場合があります。
      パラメータ:
      algorithm - 要求された信頼管理アルゴリズムの標準名。 標準のアルゴリズム名の詳細は、Java Security Standard Algorithm Names Specificationの「TrustManagerFactoryセクション」を参照してください。
      戻り値:
      新しいTrustManagerFactoryオブジェクト
      スロー:
      NoSuchAlgorithmException - Providerが、指定されたアルゴリズムのTrustManagerFactorySpi実装をサポートしていない場合
      NullPointerException - algorithmがnullである場合
      関連項目:

    • getInstance

      public static final TrustManagerFactory getInstance(String algorithm, String provider) throws NoSuchAlgorithmException, NoSuchProviderException
      キー・マネージャのファクトリとして機能するTrustManagerFactoryオブジェクトを返します。

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

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

      パラメータ:
      algorithm - 要求された信頼管理アルゴリズムの標準名。 標準のアルゴリズム名の詳細は、Java Security Standard Algorithm Names Specificationの「TrustManagerFactoryセクション」を参照してください。
      provider - プロバイダ名。
      戻り値:
      新しいTrustManagerFactoryオブジェクト
      スロー:
      IllegalArgumentException - プロバイダ名がnullまたは空の場合
      NoSuchAlgorithmException - 指定されたアルゴリズムのTrustManagerFactorySpi実装が、指定されたプロバイダから利用可能でない場合
      NoSuchProviderException - 指定されたプロバイダがセキュリティ・プロバイダ・リストに登録されていない場合
      NullPointerException - algorithmがnullである場合
      関連項目:

    • getInstance

      public static final TrustManagerFactory getInstance(String algorithm, Provider provider) throws NoSuchAlgorithmException
      キー・マネージャのファクトリとして機能するTrustManagerFactoryオブジェクトを返します。

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

      パラメータ:
      algorithm - 要求された信頼管理アルゴリズムの標準名。 標準のアルゴリズム名の詳細は、Java Security Standard Algorithm Names Specificationの「TrustManagerFactoryセクション」を参照してください。
      provider - プロバイダのインスタンス。
      戻り値:
      新しいTrustManagerFactoryオブジェクト
      スロー:
      IllegalArgumentException - プロバイダがnullの場合
      NoSuchAlgorithmException - 指定されたアルゴリズムのTrustManagerFactorySpi実装が、指定されたProviderオブジェクトから使用できない場合
      NullPointerException - algorithmがnullである場合
      関連項目:

    • 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 - ファクトリが初期化されていない場合。