- 含まれているクラス:
KeyStore
KeyStore
オブジェクトの説明。
このクラスのインスタンスは、KeyStore
オブジェクトのインスタンス化と初期化に必要な情報をカプセル化します。 getKeyStore()メソッドを呼び出すと、この処理が起動されます。
これにより、KeyStore
オブジェクトの作成から構成を分離でき、パスワード・プロンプトが必要になるまで遅延します。
- 導入されたバージョン:
- 1.5
- 関連項目:
-
コンストラクタのサマリー
-
メソッドのサマリー
修飾子と型メソッド説明abstract KeyStore
このオブジェクトによって記述されたKeyStore
を返します。abstract KeyStore.ProtectionParameter
getProtectionParameter
(String alias) 指定された別名でEntry
を取得するために使用する必要があるProtectionParameter
を返します。static KeyStore.Builder
newInstance
(File file, KeyStore.ProtectionParameter protection) 新しいBuilder
オブジェクトを返します。static KeyStore.Builder
newInstance
(String type, Provider provider, File file, KeyStore.ProtectionParameter protection) 新しいBuilder
オブジェクトを返します。static KeyStore.Builder
newInstance
(String type, Provider provider, KeyStore.ProtectionParameter protection) 新しいBuilder
オブジェクトを返します。static KeyStore.Builder
newInstance
(KeyStore keyStore, KeyStore.ProtectionParameter protectionParameter) 指定されたKeyStore
をカプセル化する新しいBuilder
を返します。
-
コンストラクタの詳細
-
Builder
protected Builder()新しいBuilder
を作成します。
-
-
メソッドの詳細
-
getKeyStore
public abstract KeyStore getKeyStore() throws KeyStoreExceptionこのオブジェクトによって記述されたKeyStore
を返します。- 戻り値:
- このオブジェクトが記述する
KeyStore
- 例外:
KeyStoreException
- 操作中にエラーが発生した場合(たとえば、KeyStore
をインスタンス化またはロードできなかった場合)
-
getProtectionParameter
public abstract KeyStore.ProtectionParameter getProtectionParameter(String alias) throws KeyStoreException 指定された別名でEntry
を取得するために使用する必要があるProtectionParameter
を返します。getKeyStore
メソッドを呼び出したあとでないと、このメソッドを呼び出せません。- パラメータ:
alias
-KeyStore
エントリの別名- 戻り値:
- 指定された別名で
Entry
を取得するために使用するProtectionParameter
。 - 例外:
NullPointerException
- 別名がnull
の場合KeyStoreException
- 処理中にエラーが発生した場合IllegalStateException
- このメソッドをコールする前にgetKeyStore
メソッドが呼び出されていない場合
-
newInstance
public static KeyStore.Builder newInstance(KeyStore keyStore, KeyStore.ProtectionParameter protectionParameter) 指定されたKeyStore
をカプセル化する新しいBuilder
を返します。 返されたオブジェクトのgetKeyStore()メソッドはkeyStore
を返し、getProtectionParameter()メソッドはprotectionParameters
を戻します。これは、既存の
KeyStore
オブジェクトをビルダー・ベースのAPIとともに使用する必要がある場合に便利です。- パラメータ:
keyStore
- カプセル化するKeyStore
protectionParameter
-KeyStore
エントリを保護するために使用されるProtectionParameter
- 戻り値:
- 新しい
Builder
オブジェクト - 例外:
NullPointerException
-keyStore
またはprotectionParameter
がnull
の場合IllegalArgumentException
-keyStore
が初期化されていない場合
-
newInstance
public static KeyStore.Builder newInstance(String type, Provider provider, File file, KeyStore.ProtectionParameter protection) 新しいBuilder
オブジェクトを返します。戻されたビルダーで
getKeyStore()
メソッドの最初のコールでは、type
型のKeyStore
が作成され、そのload()
メソッドがコールされます。inputStream
引数はfile
に基づいて構築されます。protection
がPasswordProtection
である場合、パスワードを取得するにはgetPassword
メソッドを呼び出します。protection
がCallbackHandlerProtection
である場合、パスワードを取得するにはCallbackHandlerを呼び出します。後続の
getKeyStore()
呼出しでは、初回の呼出し時と同じオブジェクトが返されます。 最初の呼び出しがKeyStoreException
で失敗した場合、後続の呼び出しもKeyStoreException
をスローします。null以外の場合、
KeyStore
はprovider
からインスタンス化されます。 そうでない場合は、インストールされたすべてのプロバイダが検索されます。getProtectionParameter()
を呼び出すと、load
メソッドの呼出し時に使用されたパスワードをカプセル化したPasswordProtection
オブジェクトが返されます。getKeyStore()
メソッドは、このメソッドを呼び出しているコードのAccessControlContext
内で実行されることに注意してください。- パラメータ:
type
- 構築されるKeyStore
のタイプprovider
-KeyStore
をインスタンス化するプロバイダ(またはnull
)file
-KeyStore
データを含むファイルprotection
-KeyStore
データを保護するProtectionParameter
- 戻り値:
- 新しい
Builder
オブジェクト - 例外:
NullPointerException
- タイプ、ファイルまたは保護がnull
の場合IllegalArgumentException
- protectionがPasswordProtection、CallbackHandlerProtectionのどちらのインスタンスでもない場合、またはfileが存在しないか、通常のファイルを参照していない場合
-
newInstance
public static KeyStore.Builder newInstance(File file, KeyStore.ProtectionParameter protection) 新しいBuilder
オブジェクトを返します。戻されたビルダーで
getKeyStore()
メソッドの最初のコールでは、file
を使用してKeyStore
を作成し、キーストア・タイプを検出してから、そのload()
メソッドをコールします。KeyStore.getInstance(File, LoadStoreParameter)
で説明されているように、同じアルゴリズムを使用してキーストアの型を判別します。inputStream
引数はfile
に基づいて構築されます。protection
がPasswordProtection
である場合、パスワードを取得するにはgetPassword
メソッドを呼び出します。protection
がCallbackHandlerProtection
である場合、パスワードを取得するにはCallbackHandlerを呼び出します。後続の
getKeyStore()
呼出しでは、初回の呼出し時と同じオブジェクトが返されます。 最初の呼び出しがKeyStoreException
で失敗した場合、後続の呼び出しもKeyStoreException
をスローします。getProtectionParameter()
を呼び出すと、load
メソッドの呼出し時に使用されたパスワードをカプセル化したPasswordProtection
オブジェクトが返されます。getKeyStore()
メソッドは、このメソッドを呼び出しているコードのAccessControlContext
内で実行されることに注意してください。- パラメータ:
file
-KeyStore
データを含むファイルprotection
-KeyStore
データを保護するProtectionParameter
- 戻り値:
- 新しい
Builder
オブジェクト - 例外:
NullPointerException
- ファイルまたは保護がnull
の場合IllegalArgumentException
- protectionがPasswordProtection、CallbackHandlerProtectionのどちらのインスタンスでもない場合、またはfileが存在しないか、通常のファイルを参照していない場合- 導入されたバージョン:
- 9
-
newInstance
public static KeyStore.Builder newInstance(String type, Provider provider, KeyStore.ProtectionParameter protection) 新しいBuilder
オブジェクトを返します。戻されたビルダーで
getKeyStore()
メソッドを呼び出すたびに、タイプtype
の新しいKeyStore
オブジェクトが返されます。 そのload()
メソッドは、protection
をカプセル化したLoadStoreParameter
を使用して呼び出されます。null以外の場合、
KeyStore
はprovider
からインスタンス化されます。 そうでない場合は、インストールされたすべてのプロバイダが検索されます。getProtectionParameter()
を呼び出すと、protection
を返します。getKeyStore()
メソッドは、このメソッドを呼び出しているコードのAccessControlContext
内で実行されることに注意してください。- パラメータ:
type
- 構築されるKeyStore
のタイプprovider
-KeyStore
をインスタンス化するプロバイダ(またはnull
)protection
-Keystore
を保護するProtectionParameter
- 戻り値:
- 新しい
Builder
オブジェクト - 例外:
NullPointerException
- タイプまたは保護がnull
の場合
-