Returns the KeyStore described by this object.

  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.

  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.
Returns: the ProtectionParameters that should be used to obtain the {@link KeyStore.Entry Entry} with the given alias.
Parameters:
- alias - the alias of the KeyStore entry
Throws:
- 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.

  Returns a new Builder that encapsulates the given KeyStore. The KeyStore.Builder.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.
Returns: a new Builder object
Parameters:
- keyStore - the KeyStore to be encapsulated
- protectionParameter - the ProtectionParameter used to protect the KeyStore entries
Throws:
- NullPointerException - if keyStore or protectionParameters is null
- IllegalArgumentException - if the keyStore has not been initialized

  Returns a new Builder object.

  Returns a new Builder object.

The first call to the KeyStore.Builder.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 KeyStore.Builder.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 KeyStore.Builder.getKeyStore() method is executed within the AccessControlContext of the code invoking this method.
Returns: a new Builder object
Parameters:
- 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
- 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.

  Returns a new Builder object.

Each call to the KeyStore.Builder.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 KeyStore.Builder.getKeyStore() method is executed within the AccessControlContext of the code invoking this method.
Returns: a new Builder object
Parameters:
- 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