クラスProvider.Service

java.lang.Object
java.security.Provider.Service
含まれているクラス:
Provider
public static class Provider.Service extends Object
特定のセキュリティ・サービスを記述したものです。 このクラスには、特定のサービスのプロパティがカプセル化されるほか、そのサービスの新しい実装インスタンスを取得するためのファクトリ・メソッドが含まれます。

各サービスは、そのサービスを提供するプロバイダ、タイプ、アルゴリズ 名、およびそのサービスを実装するクラス名を含みます。 オプションで、このサービス(aliases)および属性((名前、値) Stringペアのマップ)の代替アルゴリズ 名のリストも含まれます。

このクラスに定義されているsupportsParameter()とnewInstance()メソッドは、Javaセキュリティ・フレー ワークが条件に合致するサービスを検索してインスタンス化する際に使用されます。 これらのメソッドに対する有効な引数は、サービスのタイプごとに異なります。 Java SEで定義されたサービス・タイプについては、有効な値については「Java暗号化アーキテクチャ(JCA)リファレンス・ガイド」を参照してく さい。 Java SEの外部のコンポーネントでは、その他のサービス・タイプおよびその動作を定義することができます。

このクラスのインスタンスは不変です。

導入されたバージョン:
1.5

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

    コンストラクタ
    コンストラクタ
    説明
    Service(Provider provider, String type, String algorithm, String className, List<String> aliases, Map<String,String> attributes)
    新しいサービスを構築します。

  • メソッドのサマリー

    修飾子と型
    メソッド
    説明
    final String
    getAlgorithm()
    このサービスのアルゴリズ 名を返します。
    final String
    getAttribute(String name)
    指定された属性の値を返すか、このサービスに対してこの属性が設定されていない 合はnullを返します。
    final String
    getClassName()
    このサービスを実装するクラスの名前を返します。
    final Provider
    getProvider()
    このサービスのProviderを返します。
    final String
    getType()
    このサービスのタイプを取得します。
    Object
    newInstance(Object constructorParameter)
    このサービスが記述する実装の新しいインスタンスを返します。
    boolean
    supportsParameter(Object parameter)
    このServiceが指定されたパラメータを使用できるかどうかを判定します。
    String
    toString()
    このサービスのString表現を返します。

    クラスjava.lang.Objectで宣言されたメソッド

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

  • コンストラクタの詳細

    • Service

      public Service(Provider provider, String type, String algorithm, String className, List<String> aliases, Map<String,String> attributes)
      新しいサービスを構築します。
      パラメータ:
      provider - このサービスを提供するプロバイダ
      type - このサービスのタイプ
      algorithm - アルゴリズ 名
      className - このサービスを実装するクラスの名前
      aliases - 別名のリスト、またはアルゴリズ に別名がない 合はnull
      attributes - 属性のマップ、またはこの実装に属性がない 合はnull
      スロー:
      NullPointerException - プロバイダ、タイプ、アルゴリズ またはclassNameがnullの 合

  • メソッドの詳細

    • getType

      public final String getType()
      このサービスのタイプを取得します。 たとえば、MessageDigestです。
      戻り値:
      このサービスのタイプ

    • getAlgorithm

      public final String getAlgorithm()
      このサービスのアルゴリズ 名を返します。 たとえば、SHA-1です。
      戻り値:
      このサービスのアルゴリズ 

    • getProvider

      public final Provider getProvider()
      このサービスのProviderを返します。
      戻り値:
      このサービスのProvider

    • getClassName

      public final String getClassName()
      このサービスを実装するクラスの名前を返します。
      戻り値:
      このサービスを実装するクラスの名前

    • getAttribute

      public final String getAttribute(String name)
      指定された属性の値を返すか、このサービスに対してこの属性が設定されていない 合はnullを返します。
      パラメータ:
      name - 要求された属性の名前
      戻り値:
      指定された属性の値、または属性が存在しない 合はnull
      スロー:
      NullPointerException - nameがnullの 合

    • newInstance

      public Object newInstance(Object constructorParameter) throws NoSuchAlgorithmException
      このサービスが記述する実装の新しいインスタンスを返します。 セキュリティ・プロバイダ・フレー ワークは、このメソッドを使って実装の構築を行います。 通常の 合、アプリケーションからこのメソッドを呼び出す必要はありません。

      デフォルト実装は、リフレクションを使ってこのサービス・タイプに対する標準のコンストラクタを呼び出します。 セキュリティ・プロバイダは、このメソッドをオーバーライドすることで、インスタンス化を別の方法で実装できます。 様々なタイプのサービスに対して有効なconstructorParameterの詳細および値については、「Java暗号化アーキテクチャ(JCA)リファレンス・ガイド」を参照してく さい。

      パラメータ:
      constructorParameter - コンストラクタに渡す値。このタイプのサービスがconstructorParameterを使用しない 合はnull。
      戻り値:
      このサービスの新しい実装
      スロー:
      InvalidParameterException - constructorParameterの値がこのサービス・タイプに対して無効である 合。
      NoSuchAlgorithmException - なんらかの理由でインスタンス化が失敗した 合。

    • supportsParameter

      public boolean supportsParameter(Object parameter)
      このServiceが指定されたパラメータを使用できるかどうかを判定します。 このサービスでパラメータを使用できない 合は、falseを返します。 このサービスがパラメータを使用できる 合、高速テストを実行できない 合、またはステータスが不明な 合は、trueを返します。

      セキュリティ・プロバイダ・フレー ワークは、一部のサービス・タイプでこのメソッドを使用することで、条件に合致しない実装を処理対象からすばやく除外します。 通常の 合、アプリケーションからこのメソッドを呼び出す必要はありません。

      様々なタイプのサービスに対して有効なパラメータの詳細および値については、このクラスの上部および「Java暗号化アーキテクチャ(JCA)リファレンス・ガイド」を参照してく さい。 セキュリティ・プロバイダは、このメソッドをオーバーライドすることで独自の判定ロジックを実装できます。

      パラメータ:
      parameter - 判定対象のパラメータ
      戻り値:
      このサービスが指定されたパラメータを使用できない 合はfalse、パラメータを使用できる 合はtrue
      スロー:
      InvalidParameterException - パラメータの値がこのサービス・タイプに対して無効である 合、またはこのメソッドがこのサービス・タイプで使用できない 合

    • toString

      public String toString()
      このサービスのString表現を返します。
      オーバーライド:
      toString、クラスObject
      戻り値:
      このサービスのString表現。