Provider (Java Platform SE 7)

java.lang.Object
- java.util.Dictionary<K,V>
- - java.util.Hashtable<Object,Object>
  - - java.util.Properties
    - - java.security.Provider

すべての実装されたインタフェース:: Serializable, Cloneable, Map<Object,Object>

直系の既知のサブクラス:: AuthProvider

public abstract class Provider
extends Properties

このクラスは、Java Security API の「プロバイダ」を表します。プロバイダとは、Java セキュリティーの全体または一部を実装するものです。プロバイダが実装するのは次のようなサービスです。

アルゴリズム (DSA, RSA, MD5、SHA-1 など)。
鍵生成、鍵変換、および (アルゴリズム固有の鍵に対する) 管理機能。

各プロバイダには名前とバージョン番号があり、インストールされているランタイムクラスごとに構成されます。

プロバイダの特定の型、暗号化サービスプロバイダの処理およびインストール方法については、「Java 暗号化アーキテクチャー API 仕様リファレンス」の「Provider Class」を参照してください。その際、プロバイダが下層に適した実装を選択して、プラグイン可能なアーキテクチャーを使用していると、Java のどのセキュリティーサービスの実装にも使用できます。

プロバイダ実装によっては、セキュリティートークンとの通信エラーなどの、処理中に復旧できない内部エラーが発生する可能性があります。そのようなエラーを通知するには ProviderException を使用してください。

サービスタイプ Provider はセキュリティーフレームワーク用に予約されています。このタイプのサービスをアプリケーションから追加、削除、または変更することはできません。各 Provider オブジェクト内には次の属性が自動的に格納されます。

名前	値
`Provider.id name`	`String.valueOf(provider.getName())`
`Provider.id version`	`String.valueOf(provider.getVersion())`
`Provider.id info`	`String.valueOf(provider.getInfo())`
`Provider.id className`	`provider.getClass().getName()`

関連項目:: 直列化された形式

ネストされたクラスのサマリー

ネストされたクラス
修飾子と型クラスと説明

static class Provider.Service
特定のセキュリティーサービスを記述したものです。

ネストされたクラス
修飾子と型	クラスと説明
`static class`	`Provider.Service` 特定のセキュリティーサービスを記述したものです。

フィールドのサマリー
- クラス java.util.Properties から継承されたフィールド
  defaults

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

コンストラクタ
修飾子	コンストラクタと説明
`protected`	`Provider(String name, double version, String info)` 指定された名前、バージョン番号、および情報を使用してプロバイダを構築します。

メソッドのサマリー

メソッド
修飾子と型	メソッドと説明
`void`	`clear()` このプロバイダをクリアして、プロバイダが実装した機能を検索するときに使うプロパティーを含まないようにします。
`Enumeration<Object>`	`elements()` ハッシュテーブルにある値のリストを返します。
`Set<Map.Entry<Object,Object>>`	`entrySet()` このプロバイダに含まれるプロパティーエントリの変更不可能な Set のビューを返します。
`Object`	`get(Object key)` 指定されたキーがマップされている値を返します。そのキーのマッピングがこのマップに含まれていない場合は `null` を返します。
`String`	`getInfo()` プロバイダとそのサービス内容を、人間が読める形式で返します。
`String`	`getName()` このプロバイダの名前を返します。
`String`	`getProperty(String key)` 指定されたキーを持つプロパティーを、プロパティーリストから探します。
`Provider.Service`	`getService(String type, String algorithm)` 指定されたタイプの指定されたアルゴリズムまたは別名に対するこの Provider の実装を記述したサービスを取得します。
`Set<Provider.Service>`	`getServices()` この Provider がサポートするすべてのサービスの変更不可能な Set を取得します。
`double`	`getVersion()` このプロバイダのバージョン番号を返します。
`Enumeration<Object>`	`keys()` ハッシュテーブルにあるキーのリストを返します。
`Set<Object>`	`keySet()` このプロバイダに含まれるプロパティーキーの変更不可能な Set のビューを返します。
`void`	`load(InputStream inStream)` 入力ストリームからキーと要素が対になったプロパティーリストを読み込みます。
`Object`	`put(Object key, Object value)` `key` プロパティーが、指定された `value` を持つように設定します。
`void`	`putAll(Map<?,?> t)` 指定された Map からこのプロバイダへすべてのマッピングをコピーします。
`protected void`	`putService(Provider.Service s)` サービスを追加します。
`Object`	`remove(Object key)` `key` プロパティーとそれに対応する `value` を削除します。
`protected void`	`removeService(Provider.Service s)` 以前に `putService()` を使用して追加されたサービスを削除します。
`String`	`toString()` このプロバイダの名前とバージョン番号を文字列で返します。
`Collection<Object>`	`values()` このプロバイダに含まれるプロパティー値の変更不可能な Collection のビューを返します。

クラス java.util.Properties から継承されたメソッド
getProperty, list, list, load, loadFromXML, propertyNames, save, setProperty, store, store, storeToXML, storeToXML, stringPropertyNames

クラス java.util.Hashtable から継承されたメソッド
clone, contains, containsKey, containsValue, equals, hashCode, isEmpty, rehash, size

クラス java.lang.Object から継承されたメソッド
finalize, getClass, notify, notifyAll, wait, wait, wait

- コンストラクタの詳細
  - Provider
```
protected Provider(String name,
        double version,
        String info)
```
    指定された名前、バージョン番号、および情報を使用してプロバイダを構築します。
    
    パラメータ:
    name - プロバイダの名前。
    version - プロバイダのバージョン番号。
    info - プロバイダとそのサービスの記述。
- メソッドの詳細
  - getName
```
public String getName()
```
    このプロバイダの名前を返します。
    
    戻り値:
    このプロバイダの名前。
  - getVersion
```
public double getVersion()
```
    このプロバイダのバージョン番号を返します。
    
    戻り値:
    このプロバイダのバージョン番号。
  - getInfo
```
public String getInfo()
```
    プロバイダとそのサービス内容を、人間が読める形式で返します。関連するリンクを持つ HTML ページを返すこともあります。
    
    戻り値:
    プロバイダとそのサービスの記述。
  - toString
```
public String toString()
```
    このプロバイダの名前とバージョン番号を文字列で返します。
    
    オーバーライド:
    
    toString、クラス: Hashtable<Object,Object>
    
    戻り値:
    このプロバイダの名前とバージョン番号の文字列。
  - clear
```
public void clear()
```
    このプロバイダをクリアして、プロバイダが実装した機能を検索するときに使うプロパティーを含まないようにします。
    セキュリティーマネージャーが存在する場合、まずセキュリティーマネージャーの checkSecurityAccess メソッドが文字列 "clearProviderProperties."+name (name はプロバイダの名前) を指定して呼び出され、このプロバイダをクリアしてもよいかどうかが確認されます。checkSecurityAccess のデフォルトの実装が使用される (つまり、そのメソッドがオーバーライドされない) 場合は、これにより、セキュリティーマネージャーの checkPermission メソッドが SecurityPermission("clearProviderProperties."+name) アクセス権で呼び出されます。
    
    定義:
    
    clear、インタフェース: Map<Object,Object>
    
    オーバーライド:
    
    clear、クラス: Hashtable<Object,Object>
    
    例外:
    
    SecurityException - セキュリティーマネージャーが存在し、その SecurityManager.checkSecurityAccess(java.lang.String) メソッドがこのプロバイダをクリアするアクセスを許可しない場合
    導入されたバージョン:
    
    1.2
  - ロード
```
public void load(InputStream inStream)
          throws IOException
```
    入力ストリームからキーと要素が対になったプロパティーリストを読み込みます。
    
    オーバーライド:
    
    load、クラス: Properties
    
    パラメータ:
    inStream - 入力ストリーム。
    
    例外:
    
    IOException - 入力ストリームからの読み込み中にエラーが発生した場合。
    関連項目:
    Properties.load(java.io.Reader)
  - putAll
```
public void putAll(Map<?,?> t)
```
    指定された Map からこのプロバイダへすべてのマッピングをコピーします。これらのマッピングは、指定された Map 内に存在するすべてのキーに対応するプロパティーを、このプロバイダが持っているプロパティーと置き換えます。
    
    定義:
    
    putAll、インタフェース: Map<Object,Object>
    
    オーバーライド:
    
    putAll、クラス: Hashtable<Object,Object>
    
    パラメータ:
    t - このマップに格納されるマッピング
    導入されたバージョン:
    
    1.2
  - entrySet
```
public Set<Map.Entry<Object,Object>> entrySet()
```
    このプロバイダに含まれるプロパティーエントリの変更不可能な Set のビューを返します。
    
    定義:
    
    entrySet、インタフェース: Map<Object,Object>
    
    オーバーライド:
    
    entrySet、クラス: Hashtable<Object,Object>
    
    戻り値:
    マップ内に保持されているマッピングのセットビュー
    導入されたバージョン:
    
    1.2
    
    関連項目:
    Map.Entry
  - keySet
```
public Set<Object> keySet()
```
    このプロバイダに含まれるプロパティーキーの変更不可能な Set のビューを返します。
    
    定義:
    
    keySet、インタフェース: Map<Object,Object>
    
    オーバーライド:
    
    keySet、クラス: Hashtable<Object,Object>
    
    戻り値:
    マップに含まれているキーのセットビュー
    導入されたバージョン:
    
    1.2
  - values
```
public Collection<Object> values()
```
    このプロバイダに含まれるプロパティー値の変更不可能な Collection のビューを返します。
    
    定義:
    
    values、インタフェース: Map<Object,Object>
    
    オーバーライド:
    
    values、クラス: Hashtable<Object,Object>
    
    戻り値:
    マップ内に含まれている値のコレクションビュー
    導入されたバージョン:
    
    1.2
  - put
```
public Object put(Object key,
         Object value)
```
    key プロパティーが、指定された value を持つように設定します。
    セキュリティーマネージャーが存在する場合、最初にセキュリティーマネージャーの checkSecurityAccess メソッドが引数として "putProviderProperty."+name (name はプロバイダの名前) という文字列を指定して呼び出され、このプロバイダのプロパティー値を設定してもよいかどうかを確認します。checkSecurityAccess のデフォルトの実装が使用される (つまり、そのメソッドがオーバーライドされない) 場合は、これにより、セキュリティーマネージャーの checkPermission メソッドが SecurityPermission("putProviderProperty."+name) アクセス権で呼び出されます。
    
    定義:
    
    put、インタフェース: Map<Object,Object>
    
    オーバーライド:
    
    put、クラス: Hashtable<Object,Object>
    
    パラメータ:
    key - プロパティーキー。
    value - プロパティー値。
    
    戻り値:
    指定されたプロパティー (key) にそれまで設定されていた値。値が設定されていなかった場合は null。
    
    例外:
    
    SecurityException - セキュリティーマネージャーが存在し、その SecurityManager.checkSecurityAccess(java.lang.String) メソッドがプロパティー値を設定するアクセスを許可しない場合。
    導入されたバージョン:
    
    1.2
    
    関連項目:
    Object.equals(Object), Hashtable.get(Object)
  - remove
```
public Object remove(Object key)
```
    key プロパティーとそれに対応する value を削除します。
    セキュリティーマネージャーが存在する場合、まずセキュリティーマネージャーの checkSecurityAccess メソッドが文字列 "removeProviderProperty."+name (name はプロバイダの名前) を指定して呼び出され、このプロバイダのプロパティーを削除してもよいかどうかが確認されます。checkSecurityAccess のデフォルトの実装が使用される (つまり、そのメソッドがオーバーライドされない) 場合は、これにより、セキュリティーマネージャーの checkPermission メソッドが SecurityPermission("removeProviderProperty."+name) アクセス権で呼び出されます。
    
    定義:
    
    remove、インタフェース: Map<Object,Object>
    
    オーバーライド:
    
    remove、クラス: Hashtable<Object,Object>
    
    パラメータ:
    key - 削除するプロパティーのキー。
    
    戻り値:
    キーに割り当てられていた値。割り当てられていなかった場合は null。
    
    例外:
    
    SecurityException - セキュリティーマネージャーが存在し、その SecurityManager.checkSecurityAccess(java.lang.String) メソッドがこのプロバイダのプロパティーを削除するアクセスを許可しない場合。
    導入されたバージョン:
    
    1.2
  - get
```
public Object get(Object key)
```
    クラスからコピーされた説明: Hashtable
    
    指定されたキーがマップされている値を返します。そのキーのマッピングがこのマップに含まれていない場合は null を返します。
    つまり、このメソッドは、(key.equals(k)) となるキー k から値 v へのマッピングがこのマップに含まれている場合は v を返し、それ以外の場合は null を返します。このようなマッピングが 1 つだけあります。
    
    定義:
    
    get、インタフェース: Map<Object,Object>
    
    オーバーライド:
    
    get、クラス: Hashtable<Object,Object>
    
    パラメータ:
    key - 関連付けられた値が返されるキー
    
    戻り値:
    指定されたキーがマップされている値。そのキーのマッピングがこのマップに含まれていない場合は null
    関連項目:
    Hashtable.put(Object, Object)
  - keys
```
public Enumeration<Object> keys()
```
    クラスからコピーされた説明: Hashtable
    
    ハッシュテーブルにあるキーのリストを返します。
    
    オーバーライド:
    
    keys、クラス: Hashtable<Object,Object>
    
    戻り値:
    ハッシュテーブルにあるキーのリスト。
    関連項目:
    Enumeration, Hashtable.elements(), Hashtable.keySet(), Map
  - elements
```
public Enumeration<Object> elements()
```
    クラスからコピーされた説明: Hashtable
    
    ハッシュテーブルにある値のリストを返します。これらの要素を順次に取り出すには、Enumeration のメソッドを使用します。
    
    オーバーライド:
    
    elements、クラス: Hashtable<Object,Object>
    
    戻り値:
    ハッシュテーブルにある値のリスト。
    関連項目:
    Enumeration, Hashtable.keys(), Hashtable.values(), Map
  - getProperty
```
public String getProperty(String key)
```
    クラスからコピーされた説明: Properties
    
    指定されたキーを持つプロパティーを、プロパティーリストから探します。そのキーがプロパティーリストにないと、デフォルトのプロパティーリスト、さらにそのデフォルト値が繰り返し調べられます。そのプロパティーが見つからない場合は、null が返されます。
    
    オーバーライド:
    
    getProperty、クラス: Properties
    
    パラメータ:
    key - プロパティーキー。
    
    戻り値:
    指定されたキー値を持つこのプロパティリストの値。
    関連項目:
    Properties.setProperty(java.lang.String, java.lang.String), Properties.defaults
  - getService
```
public Provider.Service getService(String type,
                          String algorithm)
```
    指定されたタイプの指定されたアルゴリズムまたは別名に対するこの Provider の実装を記述したサービスを取得します。そのような実装が存在しない場合、このメソッドは null を返します。条件に一致するサービスとして、putService() を使用してこのプロバイダに追加されたものと、put() 経由で追加されたものの 2 つが見つかった場合、putService() 経由で追加されたサービスが返されます。
    
    パラメータ:
    type - 要求される service のタイプ (MessageDigest など)
    algorithm - 要求されるサービスのアルゴリズム名または別名 (SHA-1 など)。大文字と小文字は区別される
    
    戻り値:
    この Provider の条件に一致するサービスを記述したサービス。そのようなサービスが存在しない場合は null
    
    例外:
    
    NullPointerException - type、algorithm のいずれかが null である場合
    導入されたバージョン:
    
    1.5
  - getServices
```
public Set<Provider.Service> getServices()
```
    この Provider がサポートするすべてのサービスの変更不可能な Set を取得します。
    
    戻り値:
    この Provider がサポートするすべてのサービスの変更不可能な Set
    導入されたバージョン:
    
    1.5
  - putService
```
protected void putService(Provider.Service s)
```
    サービスを追加します。同じタイプとアルゴリズム名を持つサービスがすでに存在しており、それが putService() を使用して追加されていた場合、そのサービスは新しいサービスで置換されます。また、このメソッドは、プロバイダの Hashtable 値へのこのサービスに関する情報の設定も行います。その際の形式については、「Java 暗号化アーキテクチャー API 仕様リファレンス」を参照してください。
    また、セキュリティーマネージャーが存在する場合、セキュリティーマネージャーの checkSecurityAccess メソッドが引数として "putProviderProperty."+name (name はプロバイダの名前) という文字列を指定して呼び出され、このプロバイダのプロパティー値を設定してもよいかどうかを確認します。checkSecurityAccess のデフォルトの実装が使用される (つまり、そのメソッドがオーバーライドされない) 場合は、これにより、セキュリティーマネージャーの checkPermission メソッドが SecurityPermission("putProviderProperty."+name) アクセス権で呼び出されます。
    
    パラメータ:
    s - 追加するサービス
    
    例外:
    
    SecurityException - セキュリティーマネージャーが存在し、その SecurityManager.checkSecurityAccess(java.lang.String) メソッドがプロパティー値を設定するアクセスを許可しない場合。
    
    NullPointerException - s が null の場合
    導入されたバージョン:
    
    1.5
  - removeService
```
protected void removeService(Provider.Service s)
```
    以前に putService() を使用して追加されたサービスを削除します。指定されたサービスは、このプロバイダから削除されます。これは getService() を呼び出しても返されなくなり、このプロバイダの Hashtable からその情報が削除されます。
    また、セキュリティーマネージャーが存在する場合、セキュリティーマネージャーの checkSecurityAccess メソッドが文字列 "removeProviderProperty."+name (name はプロバイダの名前) を指定して呼び出され、このプロバイダのプロパティー値を削除してもよいかどうかが確認されます。checkSecurityAccess のデフォルトの実装が使用される (つまり、そのメソッドがオーバーライドされない) 場合は、これにより、セキュリティーマネージャーの checkPermission メソッドが SecurityPermission("removeProviderProperty."+name) アクセス権で呼び出されます。
    
    パラメータ:
    s - 削除されるサービス
    
    例外:
    
    SecurityException - セキュリティーマネージャーが存在し、その SecurityManager.checkSecurityAccess(java.lang.String) メソッドがこのプロバイダのプロパティーを削除するアクセスを許可しない場合。
    
    NullPointerException - s が null の場合
    導入されたバージョン:
    
    1.5

バグまたは機能を送信
詳細な API リファレンスおよび開発者ドキュメントについては、Java SE のドキュメントを参照してください。そのドキュメントには、概念的な概要、用語の定義、回避方法、有効なコード例などの、開発者を対象にしたより詳細な説明が含まれています。
Copyright © 1993, 2013, Oracle and/or its affiliates. All rights reserved.

クラス Provider

ネストされたクラスのサマリー

フィールドのサマリー

クラス java.util.Properties から継承されたフィールド

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

メソッドのサマリー

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

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

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

コンストラクタの詳細

Provider

メソッドの詳細

getName

getVersion

getInfo

toString

clear

ロード

putAll

entrySet

keySet

values

put

remove

get

keys

elements

getProperty

getService

getServices

putService

removeService