java.lang.Object | |
↳ | java.security.KeyStore.Builder |
A description of a to-be-instantiated KeyStore object.
An instance of this class encapsulates the information needed to
instantiate and initialize a KeyStore object. That process is
triggered when the getKeyStore()
method is called.
This makes it possible to decouple configuration from KeyStore object creation and e.g. delay a password prompt until it is needed.
Protected Constructors | |||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|
Construct a new Builder.
|
Public Methods | |||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|
Returns the KeyStore described by this object.
| |||||||||||
Returns the ProtectionParameters that should be used to obtain
the
Entry with the given alias. | |||||||||||
Returns a new Builder that encapsulates the given KeyStore.
| |||||||||||
Returns a new Builder object.
| |||||||||||
Returns a new Builder object.
|
[Expand]
Inherited Methods | |||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|
From class
java.lang.Object
|
Construct a new Builder.
Returns the KeyStore described by this object.
KeyStoreException | if an error occured during the operation, for example if the KeyStore could not be instantiated or loaded |
---|
Returns the ProtectionParameters that should be used to obtain
the Entry
with the given alias.
The getKeyStore
method must be invoked before this
method may be called.
alias | the alias of the KeyStore entry |
---|
Entry
with the given alias.NullPointerException | if alias is null |
---|---|
KeyStoreException | if an error occured during the operation |
IllegalStateException | if the getKeyStore method has not been invoked prior to calling this method |
Returns a new Builder that encapsulates the given KeyStore.
The getKeyStore()
method of the returned object
will return keyStore
, the getProtectionParameter()
method will
return protectionParameters
.
This is useful if an existing KeyStore object needs to be used with Builder-based APIs.
keyStore | the KeyStore to be encapsulated |
---|---|
protectionParameter | the ProtectionParameter used to protect the KeyStore entries |
NullPointerException | if keyStore or protectionParameters is null |
---|---|
IllegalArgumentException | if the keyStore has not been initialized |
Returns a new Builder object.
Each call to the getKeyStore()
method on the returned
builder will return a new KeyStore object of type type
.
Its load()
method is invoked using a
LoadStoreParameter
that encapsulates
protection
.
The KeyStore is instantiated from provider
if
non-null. Otherwise, all installed providers are searched.
Calls to getProtectionParameter()
will return protection
.
Note that the getKeyStore()
method is executed
within the AccessControlContext
of the code invoking this
method.
type | the type of KeyStore to be constructed |
---|---|
provider | the provider from which the KeyStore is to be instantiated (or null) |
protection | the ProtectionParameter securing the Keystore |
NullPointerException | if type or protection is null |
---|
Returns a new Builder object.
The first call to the getKeyStore()
method on the returned
builder will create a KeyStore of type type
and call
its load()
method.
The inputStream
argument is constructed from
file
.
If protection
is a
PasswordProtection
, the password is obtained by
calling the getPassword
method.
Otherwise, if protection
is a
CallbackHandlerProtection
, the password is obtained
by invoking the CallbackHandler.
Subsequent calls to getKeyStore()
return the same object
as the initial call. If the initial call to failed with a
KeyStoreException, subsequent calls also throw a
KeyStoreException.
The KeyStore is instantiated from provider
if
non-null. Otherwise, all installed providers are searched.
Calls to getProtectionParameter()
will return a PasswordProtection
object encapsulating the password that was used to invoke the
load
method.
Note that the getKeyStore()
method is executed
within the AccessControlContext
of the code invoking this
method.
type | the type of KeyStore to be constructed |
---|---|
provider | the provider from which the KeyStore is to be instantiated (or null) |
file | the File that contains the KeyStore data |
protection | the ProtectionParameter securing the KeyStore data |
NullPointerException | if type, file or protection is null |
---|---|
IllegalArgumentException | if protection is not an instance of either PasswordProtection or CallbackHandlerProtection; or if file does not exist or does not refer to a normal file |