Stay organized with collections
Save and categorize content based on your preferences.
CertStoreParameters
interface CertStoreParameters : Cloneable
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 java.security.cert.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.
Summary
| Public methods |
| abstract Any |
Makes a copy of this CertStoreParameters.
|
Public methods
clone
abstract fun clone(): Any
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.
| Return |
Any |
a copy of this CertStoreParameters |
| Exceptions |
java.lang.CloneNotSupportedException |
if the object's class does not support the Cloneable interface. Subclasses that override the clone method can also throw this exception to indicate that an instance cannot be cloned. |
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.
[[["Easy to understand","easyToUnderstand","thumb-up"],["Solved my problem","solvedMyProblem","thumb-up"],["Other","otherUp","thumb-up"]],[["Missing the information I need","missingTheInformationINeed","thumb-down"],["Too complicated / too many steps","tooComplicatedTooManySteps","thumb-down"],["Out of date","outOfDate","thumb-down"],["Samples / code issue","samplesCodeIssue","thumb-down"],["Other","otherDown","thumb-down"]],["Last updated 2025-02-10 UTC."],[],[],null,["# CertStoreParameters\n\nAdded in [API level 1](https://developer.android.com/guide/topics/manifest/uses-sdk-element.html#ApiLevels)\n\nCertStoreParameters\n===================\n\n```\ninterface CertStoreParameters : Cloneable\n```\n\n|---------------------------------------------|\n| [java.security.cert.CertStoreParameters](#) |\n\n|-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| Known Direct Subclasses [CollectionCertStoreParameters](/reference/kotlin/java/security/cert/CollectionCertStoreParameters), [LDAPCertStoreParameters](/reference/kotlin/java/security/cert/LDAPCertStoreParameters), [URICertStoreParameters](/reference/kotlin/java/security/cert/URICertStoreParameters) |-----------------------------------------------------------------------------------------------------|---------------------------------------------------------------------------------------------------------------------------------| | [CollectionCertStoreParameters](/reference/kotlin/java/security/cert/CollectionCertStoreParameters) | Parameters used as input for the Collection `CertStore` algorithm. | | [LDAPCertStoreParameters](/reference/kotlin/java/security/cert/LDAPCertStoreParameters) | Parameters used as input for the LDAP `CertStore` algorithm. | | [URICertStoreParameters](/reference/kotlin/java/security/cert/URICertStoreParameters) | Parameters used as input for `CertStore` algorithms which use information contained in a URI to retrieve certificates and CRLs. | |\n\nA specification of `CertStore` parameters.\n\nThe purpose of this interface is to group (and provide type safety for) all `CertStore` parameter specifications. All `CertStore` parameter specifications must implement this interface.\n\nTypically, a `CertStoreParameters` object is passed as a parameter to one of the java.security.cert.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.\n\nSummary\n-------\n\n| Public methods ||\n|-------------------------------------------------------------------------------------|-------------------------------------------------------------------|\n| abstract [Any](https://kotlinlang.org/api/latest/jvm/stdlib/kotlin/-any/index.html) | [clone](#clone())`()` Makes a copy of this `CertStoreParameters`. |\n\nPublic methods\n--------------\n\n### clone\n\nAdded in [API level 1](https://developer.android.com/guide/topics/manifest/uses-sdk-element.html#ApiLevels) \n\n```\nabstract fun clone(): Any\n```\n\nMakes a copy of this `CertStoreParameters`.\n\nThe 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.\n\nNote 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.\n\nEach subclass should state the precise behavior of this method so that users and developers know what to expect.\n\n| Return ||\n|----------------------------------------------------------------------------|--------------------------------------|\n| [Any](https://kotlinlang.org/api/latest/jvm/stdlib/kotlin/-any/index.html) | a copy of this `CertStoreParameters` |\n\n| Exceptions ||\n|----------------------------------------|--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `java.lang.CloneNotSupportedException` | if the object's class does not support the `Cloneable` interface. Subclasses that override the `clone` method can also throw this exception to indicate that an instance cannot be cloned. |"]]
