java.security
クラス Provider

java.lang.Object
  java.util.Dictionary
      java.util.Hashtable
          java.util.Properties
              java.security.Provider

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

Serializable, Cloneable, Map

public abstract class Provider
extends Properties

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

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

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

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

関連項目:

直列化された形式

フィールドの概要

クラス 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 のデフォルト実装が使用される場合 (つまり、このメソッドがオーバーライドされていない場合)、このメソッドの呼び出しによって、セキュリティーマネージャーの 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 のデフォルト実装が使用される場合 (つまり、このメソッドがオーバーライドされていない場合)、このメソッドの呼び出しによって、セキュリティーマネージャーの 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 のデフォルト実装が使用される場合 (つまり、このメソッドがオーバーライドされていない場合)、このメソッドの呼び出しによって、セキュリティーマネージャーの checkPermission メソッドが SecurityPermission("removeProviderProperty."+name) アクセス権を指定して呼び出されます。

定義:

インタフェース Map 内の remove

オーバーライド:

クラス Hashtable 内の remove

パラメータ:

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

戻り値:

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

例外:

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

導入されたバージョン:

1.2