public interface CertStoreParameters extends Cloneable
The purpose of this interface is to group (and provide type safety for)
CertStore parameter specifications. All
CertStore parameter specifications must implement this
CertStoreParameters object is passed as a parameter
to one of the
getInstance method returns a
is used for retrieving
CertStore that is returned is initialized with the specified
parameters. The type of parameters needed may vary between different types
The precise meaning of "copy" may depend on the class of
CertStoreParameters object. 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.getInstance methods make a copy
of the specified
CertStoreParameters. A deep copy
clone is safer and more robust, as it
prevents the caller from corrupting a shared
subsequently modifying the contents of its initialization parameters.
However, a shallow copy implementation of
clone is more
appropriate for applications that need to hold a reference to a
parameter contained in the
CertStoreParameters. For example,
a shallow copy clone allows an application to release the resources of
CertStore initialization parameter immediately,
rather than waiting for the garbage collection mechanism. This should
be done with the utmost care, since the
CertStore may 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.
For further API reference and developer documentation, see Java SE Documentation. That documentation contains more detailed, developer-targeted descriptions, with conceptual overviews, definitions of terms, workarounds, and working code examples.
Copyright © 1993, 2013, Oracle and/or its affiliates. All rights reserved.