java.security
クラス Provider

java.lang.Object
  |
  +--java.util.Dictionary
        |
        +--java.util.Hashtable
              |
              +--java.util.Properties
                    |
                    +--java.security.Provider

すべての実装インタフェース:

Cloneable, Map, Serializable

public abstract class Provider

extends Properties

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

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

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

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

関連項目:

直列化された形式

入れ子クラスの概要

クラス java.util.Map から継承した入れ子クラス

Map.Entry

フィールドの概要

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

defaults

コンストラクタの概要

protected

Provider(String name, double version, String info) 指定された名前、バージョン番号、および情報を使用してプロバイダを構築します。

メソッドの概要

void	clear() このプロバイダをクリアして、プロバイダが実装した機能を検索するときに使うプロパティを含まないようにします。
Set	entrySet() このプロバイダに含まれるプロパティエントリの変更不可能な Set のビューを返します。
String	getInfo() プロバイダとそのサービス内容を、人間が読める形式で返します。
String	getName() このプロバイダの名前を返します。
double	getVersion() このプロバイダのバージョン番号を返します。
Set	keySet() このプロバイダに含まれるプロパティキーの変更不可能な Set のビューを返します。
void	load(InputStream inStream) 入力ストリームからキーと要素が対になったプロパティリストを読み込みます。
Object	put(Object key, Object value) key というプロパティが、指定された value という値を持つように設定します。
void	putAll(Map t) 指定された Map からこのプロバイダへすべてのマッピングをコピーします。
Object	remove(Object key) key プロパティとそれに対応する value を削除します。
String	toString() このプロバイダの名前とバージョン番号を文字列で返します。
Collection	values() このプロバイダに含まれるプロパティ値の変更不可能な Collection のビューを返します。

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

getProperty, getProperty, list, list, propertyNames, save, setProperty, store

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

clone, contains, containsKey, containsValue, elements, equals, get, hashCode, isEmpty, keys, 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()

このプロバイダの名前とバージョン番号を文字列で返します。

オーバーライド:

クラス Hashtable 内の toString

戻り値:

このプロバイダの名前とバージョン番号の文字列

clear

public void clear()

このプロバイダをクリアして、プロバイダが実装した機能を検索するときに使うプロパティを含まないようにします。

セキュリティマネージャが存在する場合、最初にセキュリティマネージャの checkSecurityAccess メソッドが引数として "clearProviderProperties."+name (name はプロバイダの名前) という文字列を指定して呼び出され、このプロバイダをクリアしてもよいかどうかを確認します。デフォルトの checkSecurityAccess の実装が使用される場合 (つまり、checkSecurityAccess メソッドがオーバーライドされていない場合)、このメソッドの結果は、セキュリティマネージャの checkPermission メソッドが引数として SecurityPermission("clearProviderProperties."+name) アクセス権を指定して呼び出された場合と同じです。

定義:

インタフェース Map 内の clear

オーバーライド:

クラス Hashtable 内の clear

例外:

SecurityException - セキュリティマネージャが存在する場合に、セキュリティマネージャの SecurityManager.checkSecurityAccess(java.lang.String) メソッドがこのプロバイダをクリアするアクセスを許可しないとき

導入されたバージョン:

1.2

load

public void load(InputStream inStream)
          throws IOException

入力ストリームからキーと要素が対になったプロパティリストを読み込みます。

オーバーライド:

クラス Properties 内の load

パラメータ:

inStream - 入力ストリーム

例外:

IOException - 入力ストリームからの読み込み中にエラーが発生した場合

関連項目:

Properties.load(java.io.InputStream)

putAll

public void putAll(Map t)

指定された Map からこのプロバイダへすべてのマッピングをコピーします。これらのマッピングは、指定された Map 内に存在するすべてのキーに対応するプロパティを、このプロバイダが持っているプロパティと置き換えます。

定義:

インタフェース Map 内の putAll

オーバーライド:

クラス Hashtable 内の putAll

パラメータ:

t - マップに格納されるマッピング

導入されたバージョン:

1.2

entrySet

public Set entrySet()

このプロバイダに含まれるプロパティエントリの変更不可能な Set のビューを返します。

定義:

インタフェース Map 内の entrySet

オーバーライド:

クラス Hashtable 内の entrySet

戻り値:

マップ内に保持されているマッピングのセットビュー

導入されたバージョン:

1.2

関連項目:

Map.Entry

keySet

public Set keySet()

このプロバイダに含まれるプロパティキーの変更不可能な Set のビューを返します。

定義:

インタフェース Map 内の keySet

オーバーライド:

クラス Hashtable 内の keySet

戻り値:

マップに含まれているキーのセットビュー

導入されたバージョン:

1.2

values

public Collection values()

このプロバイダに含まれるプロパティ値の変更不可能な Collection のビューを返します。

定義:

インタフェース Map 内の values

オーバーライド:

クラス Hashtable 内の values

戻り値:

マップ内に保持されている値のコレクションビュー

導入されたバージョン:

1.2

put

public Object put(Object key,
                  Object value)

key というプロパティが、指定された value という値を持つように設定します。

セキュリティマネージャが存在する場合、最初にセキュリティマネージャの checkSecurityAccess メソッドが引数として "putProviderProperty."+name (name はプロバイダの名前) という文字列を指定して呼び出され、このプロバイダのプロパティ値を設定してもよいかどうかを確認します。デフォルトの checkSecurityAccess の実装が使用される場合 (つまり、checkSecurityAccess メソッドがオーバーライドされていない場合)、このメソッドの結果は、セキュリティマネージャの checkPermission メソッドが引数として SecurityPermission("putProviderProperty."+name) アクセス権を指定して呼び出された場合と同じです。

定義:

インタフェース Map 内の put

オーバーライド:

クラス Hashtable 内の put

パラメータ:

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 の実装が使用される場合 (つまり、checkSecurityAccess メソッドがオーバーライドされていない場合)、このメソッドの結果は、セキュリティマネージャの checkPermission メソッドが引数として SecurityPermission("removeProviderProperty."+name) アクセス権を指定して呼び出された場合と同じです。

定義:

インタフェース Map 内の remove

オーバーライド:

クラス Hashtable 内の remove

パラメータ:

key - 削除するプロパティのキー

戻り値:

キーに割り当てられていた値。割り当てられていなかった場合は null

例外:

SecurityException - セキュリティマネージャが存在する場合に、セキュリティマネージャの SecurityManager.checkSecurityAccess(java.lang.String) メソッドがこのプロバイダのプロパティ値を削除するアクセスを許可しないとき

導入されたバージョン:

1.2