Interface CertStoreParameters
- All Superinterfaces:
Cloneable
- All Known Implementing Classes:
CollectionCertStoreParameters,LDAPCertStoreParameters,URICertStoreParameters
CertStore parameters.
The purpose of this interface is to group (and provide type safety for)
all CertStore parameter specifications. All
CertStore parameter specifications must implement this
interface.
Typically, a CertStoreParameters object is passed as a parameter
to one of the CertStore.getInstance methods.
The getInstance method returns a CertStore that
is used for retrieving Certificates and CRLs. The
CertStore that is returned is initialized with the specified
parameters. The type of parameters needed may vary between different types
of CertStores.
- Since:
- 1.4
- See Also:
-
Method Summary
-
Method Details
-
clone
Object clone()Makes a copy of thisCertStoreParameters.The precise meaning of "copy" may depend on the class of the
CertStoreParametersobject. A typical implementation performs a "deep copy" of this object, but this is not an absolute requirement. Some implementations may perform a "shallow copy" of some or all of the fields of this object.Note that the
CertStore.getInstancemethods make a copy of the specifiedCertStoreParameters. A deep copy implementation ofcloneis safer and more robust, as it prevents the caller from corrupting a sharedCertStoreby subsequently modifying the contents of its initialization parameters. However, a shallow copy implementation ofcloneis more appropriate for applications that need to hold a reference to a parameter contained in theCertStoreParameters. For example, a shallow copy clone allows an application to release the resources of a particularCertStoreinitialization parameter immediately, rather than waiting for the garbage collection mechanism. This should be done with the utmost care, since theCertStoremay still be in use by other threads.Each subclass should state the precise behavior of this method so that users and developers know what to expect.
- Returns:
- a copy of this
CertStoreParameters
-