Stay organized with collections
Save and categorize content based on your preferences.
CertStoreParameters
public
interface
CertStoreParameters
implements
Cloneable
java.security.cert.CertStoreParameters
|
Known indirect subclasses
|
A specification of 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 Certificate
s and CRL
s. The
CertStore
that is returned is initialized with the specified
parameters. The type of parameters needed may vary between different types
of CertStore
s.
Summary
Public methods |
abstract
Object
|
clone()
Makes a copy of this CertStoreParameters .
|
Public methods
clone
public abstract Object clone ()
Makes a copy of this CertStoreParameters
.
The precise meaning of "copy" may depend on the class of
the 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
implementation of clone
is safer and more robust, as it
prevents the caller from corrupting a shared CertStore
by
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
a particular 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.
Returns |
Object |
a copy of this CertStoreParameters |
Content and code samples on this page are subject to the licenses described in the Content License. Java and OpenJDK are trademarks or registered trademarks of Oracle and/or its affiliates.
Last updated 2025-02-10 UTC.
[null,null,["Last updated 2025-02-10 UTC."],[],[],null,["# CertStoreParameters\n\nAdded in [API level 1](/guide/topics/manifest/uses-sdk-element#ApiLevels) \nSummary: [Methods](#pubmethods) \n\nCertStoreParameters\n===================\n\n\n`\npublic\n\n\ninterface\nCertStoreParameters\n`\n\n\n`\n\n\nimplements\n\n`[Cloneable](/reference/java/lang/Cloneable)`\n\n\n`\n\n|----------------------------------------|\n| java.security.cert.CertStoreParameters |\n\n|--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| Known indirect subclasses [CollectionCertStoreParameters](/reference/java/security/cert/CollectionCertStoreParameters), [LDAPCertStoreParameters](/reference/java/security/cert/LDAPCertStoreParameters), [URICertStoreParameters](/reference/java/security/cert/URICertStoreParameters) |----------------------------------------------------------------------------------------------|---------------------------------------------------------------------------------------------------------------------------------| | [CollectionCertStoreParameters](/reference/java/security/cert/CollectionCertStoreParameters) | Parameters used as input for the Collection `CertStore` algorithm. | | [LDAPCertStoreParameters](/reference/java/security/cert/LDAPCertStoreParameters) | Parameters used as input for the LDAP `CertStore` algorithm. | | [URICertStoreParameters](/reference/java/security/cert/URICertStoreParameters) | Parameters used as input for `CertStore` algorithms which use information contained in a URI to retrieve certificates and CRLs. | |\n\n\u003cbr /\u003e\n\n*** ** * ** ***\n\nA specification of `CertStore` parameters.\n\n\nThe purpose of this interface is to group (and provide type safety for)\nall `CertStore` parameter specifications. All\n`CertStore` parameter specifications must implement this\ninterface.\n\n\nTypically, a `CertStoreParameters` object is passed as a parameter\nto one of the [CertStore.getInstance](/reference/java/security/cert/CertStore#getInstance(java.lang.String,%20java.security.cert.CertStoreParameters)) methods.\nThe `getInstance` method returns a `CertStore` that\nis used for retrieving `Certificate`s and `CRL`s. The\n`CertStore` that is returned is initialized with the specified\nparameters. The type of parameters needed may vary between different types\nof `CertStore`s. \n**See also:**\n\n- [CertStore.getInstance(String, CertStoreParameters)](/reference/java/security/cert/CertStore#getInstance(java.lang.String,%20java.security.cert.CertStoreParameters))\n\nSummary\n-------\n\n| ### Public methods ||\n|---------------------------------------------------|------------------------------------------------------------------------------------------------------------------------|\n| ` abstract `[Object](/reference/java/lang/Object) | ` `[clone](/reference/java/security/cert/CertStoreParameters#clone())`() ` Makes a copy of this `CertStoreParameters`. |\n\nPublic methods\n--------------\n\n### clone\n\nAdded in [API level 1](/guide/topics/manifest/uses-sdk-element#ApiLevels) \n\n```\npublic abstract Object clone ()\n```\n\nMakes a copy of this `CertStoreParameters`.\n\n\nThe precise meaning of \"copy\" may depend on the class of\nthe `CertStoreParameters` object. A typical implementation\nperforms a \"deep copy\" of this object, but this is not an absolute\nrequirement. Some implementations may perform a \"shallow copy\" of some\nor all of the fields of this object.\n\n\nNote that the `CertStore.getInstance` methods make a copy\nof the specified `CertStoreParameters`. A deep copy\nimplementation of `clone` is safer and more robust, as it\nprevents the caller from corrupting a shared `CertStore` by\nsubsequently modifying the contents of its initialization parameters.\nHowever, a shallow copy implementation of `clone` is more\nappropriate for applications that need to hold a reference to a\nparameter contained in the `CertStoreParameters`. For example,\na shallow copy clone allows an application to release the resources of\na particular `CertStore` initialization parameter immediately,\nrather than waiting for the garbage collection mechanism. This should\nbe done with the utmost care, since the `CertStore` may still\nbe in use by other threads.\n\n\nEach subclass should state the precise behavior of this method so\nthat users and developers know what to expect.\n\n\u003cbr /\u003e\n\n| Returns ||\n|---------------------------------------|---------------------------------------------|\n| [Object](/reference/java/lang/Object) | a copy of this `CertStoreParameters` \u003cbr /\u003e |"]]