mirror of
https://github.com/openjdk/jdk.git
synced 2025-08-27 06:45:07 +02:00
8284851: Update javax.crypto files to use proper javadoc for mentioned classes
Reviewed-by: weijun, valeriep
This commit is contained in:
parent
8cdead0c94
commit
f804f2ce8e
92 changed files with 2142 additions and 2010 deletions
|
@ -90,7 +90,7 @@ import sun.security.util.Debug;
|
|||
* (SafeKeyper) are one option, and simpler mechanisms such as files may also
|
||||
* be used (in a variety of formats).
|
||||
*
|
||||
* <p> Typical ways to request a KeyStore object include
|
||||
* <p> Typical ways to request a {@code KeyStore} object include
|
||||
* specifying an existing keystore file,
|
||||
* relying on the default type and providing a specific keystore type.
|
||||
*
|
||||
|
@ -235,7 +235,7 @@ public class KeyStore {
|
|||
/**
|
||||
* Gets the parameter used to protect keystore data.
|
||||
*
|
||||
* @return the parameter used to protect keystore data, or null
|
||||
* @return the parameter used to protect keystore data, or {@code null}
|
||||
*/
|
||||
ProtectionParameter getProtectionParameter();
|
||||
}
|
||||
|
@ -373,7 +373,8 @@ public class KeyStore {
|
|||
/**
|
||||
* Determines if password has been cleared.
|
||||
*
|
||||
* @return true if the password has been cleared, false otherwise
|
||||
* @return {@code true} if the password has been cleared,
|
||||
* {@code false} otherwise
|
||||
*/
|
||||
public synchronized boolean isDestroyed() {
|
||||
return destroyed;
|
||||
|
@ -381,7 +382,7 @@ public class KeyStore {
|
|||
}
|
||||
|
||||
/**
|
||||
* A ProtectionParameter encapsulating a CallbackHandler.
|
||||
* A {@code ProtectionParameter} encapsulating a CallbackHandler.
|
||||
*
|
||||
* @since 1.5
|
||||
*/
|
||||
|
@ -395,7 +396,7 @@ public class KeyStore {
|
|||
* CallbackHandler.
|
||||
*
|
||||
* @param handler the CallbackHandler
|
||||
* @throws NullPointerException if handler is null
|
||||
* @throws NullPointerException if handler is {@code null}
|
||||
*/
|
||||
public CallbackHandlerProtection(CallbackHandler handler) {
|
||||
if (handler == null) {
|
||||
|
@ -802,8 +803,8 @@ public class KeyStore {
|
|||
}
|
||||
|
||||
/**
|
||||
* Creates a KeyStore object of the given type, and encapsulates the given
|
||||
* provider implementation (SPI object) in it.
|
||||
* Creates a {@code KeyStore} object of the given type, and encapsulates
|
||||
* the given provider implementation (SPI object) in it.
|
||||
*
|
||||
* @param keyStoreSpi the provider implementation.
|
||||
* @param provider the provider.
|
||||
|
@ -826,13 +827,13 @@ public class KeyStore {
|
|||
}
|
||||
|
||||
/**
|
||||
* Returns a keystore object of the specified type.
|
||||
* Returns a {@code KeyStore} object of the specified type.
|
||||
*
|
||||
* <p> This method traverses the list of registered security Providers,
|
||||
* starting with the most preferred Provider.
|
||||
* A new KeyStore object encapsulating the
|
||||
* KeyStoreSpi implementation from the first
|
||||
* Provider that supports the specified type is returned.
|
||||
* <p> This method traverses the list of registered security providers,
|
||||
* starting with the most preferred provider.
|
||||
* A new {@code KeyStore} object encapsulating the
|
||||
* {@code KeyStoreSpi} implementation from the first
|
||||
* provider that supports the specified type is returned.
|
||||
*
|
||||
* <p> Note that the list of registered providers may be retrieved via
|
||||
* the {@link Security#getProviders() Security.getProviders()} method.
|
||||
|
@ -853,7 +854,7 @@ public class KeyStore {
|
|||
*
|
||||
* @return a keystore object of the specified type
|
||||
*
|
||||
* @throws KeyStoreException if no {@code Provider} supports a
|
||||
* @throws KeyStoreException if no provider supports a
|
||||
* {@code KeyStoreSpi} implementation for the
|
||||
* specified type
|
||||
*
|
||||
|
@ -874,10 +875,10 @@ public class KeyStore {
|
|||
}
|
||||
|
||||
/**
|
||||
* Returns a keystore object of the specified type.
|
||||
* Returns a {@code KeyStore} object of the specified type.
|
||||
*
|
||||
* <p> A new KeyStore object encapsulating the
|
||||
* KeyStoreSpi implementation from the specified provider
|
||||
* <p> A new {@code KeyStore} object encapsulating the
|
||||
* {@code KeyStoreSpi} implementation from the specified provider
|
||||
* is returned. The specified provider must be registered
|
||||
* in the security provider list.
|
||||
*
|
||||
|
@ -923,11 +924,11 @@ public class KeyStore {
|
|||
}
|
||||
|
||||
/**
|
||||
* Returns a keystore object of the specified type.
|
||||
* Returns a {@code KeyStore} object of the specified type.
|
||||
*
|
||||
* <p> A new KeyStore object encapsulating the
|
||||
* KeyStoreSpi implementation from the specified Provider
|
||||
* object is returned. Note that the specified Provider object
|
||||
* <p> A new {@code KeyStore} object encapsulating the
|
||||
* {@code KeyStoreSpi} implementation from the specified provider
|
||||
* object is returned. Note that the specified provider object
|
||||
* does not have to be registered in the provider list.
|
||||
*
|
||||
* @param type the type of keystore.
|
||||
|
@ -1054,8 +1055,8 @@ public class KeyStore {
|
|||
* @param alias the alias name
|
||||
* @param password the password for recovering the key
|
||||
*
|
||||
* @return the requested key, or null if the given alias does not exist
|
||||
* or does not identify a key-related entry.
|
||||
* @return the requested key, or {@code null} if the given alias does
|
||||
* not exist or does not identify a key-related entry.
|
||||
*
|
||||
* @throws KeyStoreException if the keystore has not been initialized
|
||||
* (loaded).
|
||||
|
@ -1084,8 +1085,8 @@ public class KeyStore {
|
|||
* @param alias the alias name
|
||||
*
|
||||
* @return the certificate chain (ordered with the user's certificate first
|
||||
* followed by zero or more certificate authorities), or null if the given alias
|
||||
* does not exist or does not contain a certificate chain
|
||||
* followed by zero or more certificate authorities), or {@code null}
|
||||
* if the given alias does not exist or does not contain a certificate chain
|
||||
*
|
||||
* @throws KeyStoreException if the keystore has not been initialized
|
||||
* (loaded).
|
||||
|
@ -1117,8 +1118,8 @@ public class KeyStore {
|
|||
*
|
||||
* @param alias the alias name
|
||||
*
|
||||
* @return the certificate, or null if the given alias does not exist or
|
||||
* does not contain a certificate.
|
||||
* @return the certificate, or {@code null} if the given alias does not
|
||||
* exist or does not contain a certificate.
|
||||
*
|
||||
* @throws KeyStoreException if the keystore has not been initialized
|
||||
* (loaded).
|
||||
|
@ -1137,8 +1138,8 @@ public class KeyStore {
|
|||
*
|
||||
* @param alias the alias name
|
||||
*
|
||||
* @return the creation date of this entry, or null if the given alias does
|
||||
* not exist
|
||||
* @return the creation date of this entry, or {@code null} if the given
|
||||
* alias does not exist
|
||||
*
|
||||
* @throws KeyStoreException if the keystore has not been initialized
|
||||
* (loaded).
|
||||
|
@ -1291,7 +1292,7 @@ public class KeyStore {
|
|||
*
|
||||
* @param alias the alias name
|
||||
*
|
||||
* @return true if the alias exists, false otherwise
|
||||
* @return {@code true} if the alias exists, {@code false} otherwise
|
||||
*
|
||||
* @throws KeyStoreException if the keystore has not been initialized
|
||||
* (loaded).
|
||||
|
@ -1323,15 +1324,15 @@ public class KeyStore {
|
|||
}
|
||||
|
||||
/**
|
||||
* Returns true if the entry identified by the given alias
|
||||
* Returns {@code true} if the entry identified by the given alias
|
||||
* was created by a call to {@code setKeyEntry},
|
||||
* or created by a call to {@code setEntry} with a
|
||||
* {@code PrivateKeyEntry} or a {@code SecretKeyEntry}.
|
||||
*
|
||||
* @param alias the alias for the keystore entry to be checked
|
||||
*
|
||||
* @return true if the entry identified by the given alias is a
|
||||
* key-related entry, false otherwise.
|
||||
* @return {@code true} if the entry identified by the given alias is a
|
||||
* key-related entry, {@code false} otherwise.
|
||||
*
|
||||
* @throws KeyStoreException if the keystore has not been initialized
|
||||
* (loaded).
|
||||
|
@ -1346,15 +1347,15 @@ public class KeyStore {
|
|||
}
|
||||
|
||||
/**
|
||||
* Returns true if the entry identified by the given alias
|
||||
* Returns {@code true} if the entry identified by the given alias
|
||||
* was created by a call to {@code setCertificateEntry},
|
||||
* or created by a call to {@code setEntry} with a
|
||||
* {@code TrustedCertificateEntry}.
|
||||
*
|
||||
* @param alias the alias for the keystore entry to be checked
|
||||
*
|
||||
* @return true if the entry identified by the given alias contains a
|
||||
* trusted certificate, false otherwise.
|
||||
* @return {@code true} if the entry identified by the given alias
|
||||
* contains a trusted certificate, {@code false} otherwise.
|
||||
*
|
||||
* @throws KeyStoreException if the keystore has not been initialized
|
||||
* (loaded).
|
||||
|
@ -1389,7 +1390,7 @@ public class KeyStore {
|
|||
* @param cert the certificate to match with.
|
||||
*
|
||||
* @return the alias name of the first entry with a matching certificate,
|
||||
* or null if no such entry exists in this keystore.
|
||||
* or {@code null} if no such entry exists in this keystore.
|
||||
*
|
||||
* @throws KeyStoreException if the keystore has not been initialized
|
||||
* (loaded).
|
||||
|
@ -1461,7 +1462,7 @@ public class KeyStore {
|
|||
}
|
||||
|
||||
/**
|
||||
* Loads this KeyStore from the given input stream.
|
||||
* Loads this keystore from the given input stream.
|
||||
*
|
||||
* <p>A password may be given to unlock the keystore
|
||||
* (e.g. the keystore resides on a hardware token device),
|
||||
|
@ -1503,7 +1504,7 @@ public class KeyStore {
|
|||
/**
|
||||
* Loads this keystore using the given {@code LoadStoreParameter}.
|
||||
*
|
||||
* <p> Note that if this KeyStore has already been loaded, it is
|
||||
* <p> Note that if this {@code KeyStore} has already been loaded, it is
|
||||
* reinitialized and loaded again from the given parameter.
|
||||
*
|
||||
* @param param the {@code LoadStoreParameter}
|
||||
|
@ -1619,9 +1620,9 @@ public class KeyStore {
|
|||
* @param alias the alias name
|
||||
* @param entryClass the entry class
|
||||
*
|
||||
* @return true if the keystore {@code Entry} for the specified
|
||||
* @return {@code true} if the keystore {@code Entry} for the specified
|
||||
* {@code alias} is an instance or subclass of the
|
||||
* specified {@code entryClass}, false otherwise
|
||||
* specified {@code entryClass}, {@code false} otherwise
|
||||
*
|
||||
* @throws NullPointerException if
|
||||
* {@code alias} or {@code entryClass}
|
||||
|
@ -1662,13 +1663,14 @@ public class KeyStore {
|
|||
* <p>
|
||||
* This method traverses the list of registered security
|
||||
* {@linkplain Provider providers}, starting with the most
|
||||
* preferred Provider.
|
||||
* preferred provider.
|
||||
* For each {@link KeyStoreSpi} implementation supported by a
|
||||
* Provider, it invokes the {@link
|
||||
* provider, it invokes the {@link
|
||||
* KeyStoreSpi#engineProbe(InputStream) engineProbe} method to
|
||||
* determine if it supports the specified keystore.
|
||||
* A new KeyStore object is returned that encapsulates the KeyStoreSpi
|
||||
* implementation from the first Provider that supports the specified file.
|
||||
* A new {@code KeyStore} object is returned that encapsulates the
|
||||
* {@code KeyStoreSpi}
|
||||
* implementation from the first provider that supports the specified file.
|
||||
*
|
||||
* <p> Note that the list of registered providers may be retrieved via
|
||||
* the {@link Security#getProviders() Security.getProviders()} method.
|
||||
|
@ -1678,7 +1680,7 @@ public class KeyStore {
|
|||
*
|
||||
* @return a keystore object loaded with keystore data
|
||||
*
|
||||
* @throws KeyStoreException if no Provider supports a KeyStoreSpi
|
||||
* @throws KeyStoreException if no provider supports a {@code KeyStoreSpi}
|
||||
* implementation for the specified keystore file.
|
||||
* @throws IOException if there is an I/O or format problem with the
|
||||
* keystore data, if a password is required but not given,
|
||||
|
@ -1717,13 +1719,14 @@ public class KeyStore {
|
|||
*
|
||||
* <p>
|
||||
* This method traverses the list of registered security {@linkplain
|
||||
* Provider providers}, starting with the most preferred Provider.
|
||||
* Provider providers}, starting with the most preferred provider.
|
||||
* For each {@link KeyStoreSpi} implementation supported by a
|
||||
* Provider, it invokes the {@link
|
||||
* provider, it invokes the {@link
|
||||
* KeyStoreSpi#engineProbe(InputStream) engineProbe} method to
|
||||
* determine if it supports the specified keystore.
|
||||
* A new KeyStore object is returned that encapsulates the KeyStoreSpi
|
||||
* implementation from the first Provider that supports the specified file.
|
||||
* A new {@code KeyStore} object is returned that encapsulates the
|
||||
* {@code KeyStoreSpi}
|
||||
* implementation from the first provider that supports the specified file.
|
||||
*
|
||||
* <p> Note that the list of registered providers may be retrieved via
|
||||
* the {@link Security#getProviders() Security.getProviders()} method.
|
||||
|
@ -1734,7 +1737,7 @@ public class KeyStore {
|
|||
*
|
||||
* @return a keystore object loaded with keystore data
|
||||
*
|
||||
* @throws KeyStoreException if no Provider supports a KeyStoreSpi
|
||||
* @throws KeyStoreException if no provider supports a {@code KeyStoreSpi}
|
||||
* implementation for the specified keystore file.
|
||||
* @throws IOException if there is an I/O or format problem with the
|
||||
* keystore data. If the error is due to an incorrect
|
||||
|
@ -1836,13 +1839,13 @@ public class KeyStore {
|
|||
}
|
||||
|
||||
/**
|
||||
* A description of a to-be-instantiated KeyStore object.
|
||||
* A description of a to-be-instantiated {@code KeyStore} object.
|
||||
*
|
||||
* <p>An instance of this class encapsulates the information needed to
|
||||
* instantiate and initialize a KeyStore object. That process is
|
||||
* instantiate and initialize a {@code KeyStore} object. That process is
|
||||
* triggered when the {@linkplain #getKeyStore} method is called.
|
||||
*
|
||||
* <p>This makes it possible to decouple configuration from KeyStore
|
||||
* <p>This makes it possible to decouple configuration from {@code KeyStore}
|
||||
* object creation and e.g. delay a password prompt until it is
|
||||
* needed.
|
||||
*
|
||||
|
@ -1856,57 +1859,58 @@ public class KeyStore {
|
|||
static final int MAX_CALLBACK_TRIES = 3;
|
||||
|
||||
/**
|
||||
* Construct a new Builder.
|
||||
* Construct a new {@code Builder}.
|
||||
*/
|
||||
protected Builder() {
|
||||
// empty
|
||||
}
|
||||
|
||||
/**
|
||||
* Returns the KeyStore described by this object.
|
||||
* Returns the {@code KeyStore} described by this object.
|
||||
*
|
||||
* @return the {@code KeyStore} described by this object
|
||||
* @throws KeyStoreException if an error occurred during the
|
||||
* operation, for example if the KeyStore could not be
|
||||
* operation, for example if the {@code KeyStore} could not be
|
||||
* instantiated or loaded
|
||||
*/
|
||||
public abstract KeyStore getKeyStore() throws KeyStoreException;
|
||||
|
||||
/**
|
||||
* Returns the ProtectionParameters that should be used to obtain
|
||||
* Returns the {@code ProtectionParameter} that should be used to obtain
|
||||
* the {@link KeyStore.Entry Entry} with the given alias.
|
||||
* The {@code getKeyStore} method must be invoked before this
|
||||
* method may be called.
|
||||
*
|
||||
* @return the ProtectionParameters that should be used to obtain
|
||||
* @return the {@code ProtectionParameter} that should be used to obtain
|
||||
* the {@link KeyStore.Entry Entry} with the given alias.
|
||||
* @param alias the alias of the KeyStore entry
|
||||
* @throws NullPointerException if alias is null
|
||||
* @param alias the alias of the {@code KeyStore} entry
|
||||
* @throws NullPointerException if alias is {@code null}
|
||||
* @throws KeyStoreException if an error occurred during the
|
||||
* operation
|
||||
* @throws IllegalStateException if the getKeyStore method has
|
||||
* @throws IllegalStateException if the {@code getKeyStore} method has
|
||||
* not been invoked prior to calling this method
|
||||
*/
|
||||
public abstract ProtectionParameter getProtectionParameter(String alias)
|
||||
throws KeyStoreException;
|
||||
|
||||
/**
|
||||
* Returns a new Builder that encapsulates the given KeyStore.
|
||||
* Returns a new {@code Builder} that encapsulates the given
|
||||
* {@code KeyStore}.
|
||||
* The {@linkplain #getKeyStore} method of the returned object
|
||||
* will return {@code keyStore}, the {@linkplain
|
||||
* #getProtectionParameter getProtectionParameter()} method will
|
||||
* return {@code protectionParameters}.
|
||||
*
|
||||
* <p> This is useful if an existing KeyStore object needs to be
|
||||
* used with Builder-based APIs.
|
||||
* <p> This is useful if an existing {@code KeyStore} object needs to be
|
||||
* used with builder-based APIs.
|
||||
*
|
||||
* @return a new Builder object
|
||||
* @param keyStore the KeyStore to be encapsulated
|
||||
* @param 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
|
||||
* @return a new {@code Builder} object
|
||||
* @param keyStore the {@code KeyStore} to be encapsulated
|
||||
* @param protectionParameter the {@code ProtectionParameter} used to
|
||||
* protect the {@code KeyStore} entries
|
||||
* @throws NullPointerException if {@code keyStore} or
|
||||
* {@code protectionParameter} is {@code null}
|
||||
* @throws IllegalArgumentException if the {@code keyStore} has not been
|
||||
* initialized
|
||||
*/
|
||||
public static Builder newInstance(final KeyStore keyStore,
|
||||
|
@ -1940,10 +1944,10 @@ public class KeyStore {
|
|||
}
|
||||
|
||||
/**
|
||||
* Returns a new Builder object.
|
||||
* Returns a new {@code Builder} object.
|
||||
*
|
||||
* <p>The first call to the {@link #getKeyStore} method on the returned
|
||||
* builder will create a KeyStore of type {@code type} and call
|
||||
* builder will create a {@code KeyStore} of type {@code type} and call
|
||||
* its {@link KeyStore#load load()} method.
|
||||
* The {@code inputStream} argument is constructed from
|
||||
* {@code file}.
|
||||
|
@ -1956,10 +1960,10 @@ public class KeyStore {
|
|||
*
|
||||
* <p>Subsequent calls to {@link #getKeyStore} return the same object
|
||||
* as the initial call. If the initial call failed with a
|
||||
* KeyStoreException, subsequent calls also throw a
|
||||
* KeyStoreException.
|
||||
* {@code KeyStoreException}, subsequent calls also throw a
|
||||
* {@code KeyStoreException}.
|
||||
*
|
||||
* <p>The KeyStore is instantiated from {@code provider} if
|
||||
* <p>The {@code KeyStore} is instantiated from {@code provider} if
|
||||
* non-null. Otherwise, all installed providers are searched.
|
||||
*
|
||||
* <p>Calls to {@link #getProtectionParameter getProtectionParameter()}
|
||||
|
@ -1971,13 +1975,15 @@ public class KeyStore {
|
|||
* within the {@link AccessControlContext} of the code invoking this
|
||||
* method.
|
||||
*
|
||||
* @return a new Builder object
|
||||
* @param type the type of KeyStore to be constructed
|
||||
* @param provider the provider from which the KeyStore is to
|
||||
* be instantiated (or null)
|
||||
* @param file the File that contains the KeyStore data
|
||||
* @param protection the ProtectionParameter securing the KeyStore data
|
||||
* @throws NullPointerException if type, file or protection is null
|
||||
* @return a new {@code Builder} object
|
||||
* @param type the type of {@code KeyStore} to be constructed
|
||||
* @param provider the provider from which the {@code KeyStore} is to
|
||||
* be instantiated (or {@code null})
|
||||
* @param file the File that contains the {@code KeyStore} data
|
||||
* @param protection the {@code ProtectionParameter} securing the
|
||||
* {@code KeyStore} data
|
||||
* @throws NullPointerException if type, file or protection is
|
||||
* {@code 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
|
||||
|
@ -2004,11 +2010,12 @@ public class KeyStore {
|
|||
}
|
||||
|
||||
/**
|
||||
* Returns a new Builder object.
|
||||
* Returns a new {@code Builder} object.
|
||||
*
|
||||
* <p>The first call to the {@link #getKeyStore} method on the returned
|
||||
* builder will create a KeyStore using {@code file} to detect the
|
||||
* keystore type and then call its {@link KeyStore#load load()} method.
|
||||
* builder will create a {@code KeyStore} using {@code file} to detect
|
||||
* the keystore type and then call its {@link KeyStore#load load()}
|
||||
* method.
|
||||
* It uses the same algorithm to determine the keystore type as
|
||||
* described in {@link KeyStore#getInstance(File, LoadStoreParameter)}.
|
||||
* The {@code inputStream} argument is constructed from {@code file}.
|
||||
|
@ -2020,7 +2027,8 @@ public class KeyStore {
|
|||
*
|
||||
* <p>Subsequent calls to {@link #getKeyStore} return the same object
|
||||
* as the initial call. If the initial call failed with a
|
||||
* KeyStoreException, subsequent calls also throw a KeyStoreException.
|
||||
* {@code KeyStoreException}, subsequent calls also throw a
|
||||
* {@code KeyStoreException}.
|
||||
*
|
||||
* <p>Calls to {@link #getProtectionParameter getProtectionParameter()}
|
||||
* will return a {@link KeyStore.PasswordProtection PasswordProtection}
|
||||
|
@ -2031,10 +2039,11 @@ public class KeyStore {
|
|||
* within the {@link AccessControlContext} of the code invoking this
|
||||
* method.
|
||||
*
|
||||
* @return a new Builder object
|
||||
* @param file the File that contains the KeyStore data
|
||||
* @param protection the ProtectionParameter securing the KeyStore data
|
||||
* @throws NullPointerException if file or protection is null
|
||||
* @return a new {@code Builder} object
|
||||
* @param file the File that contains the {@code KeyStore} data
|
||||
* @param protection the {@code ProtectionParameter} securing the
|
||||
* {@code KeyStore} data
|
||||
* @throws NullPointerException if file or protection is {@code 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
|
||||
|
@ -2172,16 +2181,17 @@ public class KeyStore {
|
|||
}
|
||||
|
||||
/**
|
||||
* Returns a new Builder object.
|
||||
* Returns a new {@code Builder} object.
|
||||
*
|
||||
* <p>Each call to the {@link #getKeyStore} method on the returned
|
||||
* builder will return a new KeyStore object of type {@code type}.
|
||||
* builder will return a new {@code KeyStore} object of type
|
||||
* {@code type}.
|
||||
* Its {@link KeyStore#load(KeyStore.LoadStoreParameter) load()}
|
||||
* method is invoked using a
|
||||
* {@code LoadStoreParameter} that encapsulates
|
||||
* {@code protection}.
|
||||
*
|
||||
* <p>The KeyStore is instantiated from {@code provider} if
|
||||
* <p>The {@code KeyStore} is instantiated from {@code provider} if
|
||||
* non-null. Otherwise, all installed providers are searched.
|
||||
*
|
||||
* <p>Calls to {@link #getProtectionParameter getProtectionParameter()}
|
||||
|
@ -2191,12 +2201,13 @@ public class KeyStore {
|
|||
* within the {@link AccessControlContext} of the code invoking this
|
||||
* method.
|
||||
*
|
||||
* @return a new Builder object
|
||||
* @param type the type of KeyStore to be constructed
|
||||
* @param provider the provider from which the KeyStore is to
|
||||
* be instantiated (or null)
|
||||
* @param protection the ProtectionParameter securing the Keystore
|
||||
* @throws NullPointerException if type or protection is null
|
||||
* @return a new {@code Builder} object
|
||||
* @param type the type of {@code KeyStore} to be constructed
|
||||
* @param provider the provider from which the {@code KeyStore} is to
|
||||
* be instantiated (or {@code null})
|
||||
* @param protection the {@code ProtectionParameter} securing the
|
||||
* {@code Keystore}
|
||||
* @throws NullPointerException if type or protection is {@code null}
|
||||
*/
|
||||
public static Builder newInstance(final String type,
|
||||
final Provider provider, final ProtectionParameter protection) {
|
||||
|
|
Loading…
Add table
Add a link
Reference in a new issue