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.

return	a new Builder object
keyStore	the KeyStore to be encapsulated
protectionParameter	the ProtectionParameter used to protect the KeyStore entries
Throws	NullPointerException: if keyStore or protectionParameters is null
Throws	IllegalArgumentException: if the keyStore has not been initialized

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.

return	a new Builder object
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
Throws	NullPointerException: if type, file or protection is null
Throws	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

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.

return	a new Builder object
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
Throws	NullPointerException: if type or protection is null

Returns the KeyStore described by this object.

Throws

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.

return	the ProtectionParameters that should be used to obtain the Entry with the given alias.
alias	the alias of the KeyStore entry
Throws	NullPointerException: if alias is null
Throws	KeyStoreException: if an error occured during the operation
Throws	IllegalStateException: if the getKeyStore method has not been invoked prior to calling this method