org.bouncycastle.jce
Class MultiCertStoreParameters

java.lang.Object
  |
  +--org.bouncycastle.jce.MultiCertStoreParameters

All Implemented Interfaces:

CertStoreParameters, java.lang.Cloneable

public class MultiCertStoreParameters

extends java.lang.Object

implements CertStoreParameters

Constructor Summary

MultiCertStoreParameters(java.util.Collection certStores)
Create a parameters object which specifies searching of all the passed in stores.

MultiCertStoreParameters(java.util.Collection certStores, boolean searchAllStores)
Create a parameters object which can be to used to make a multi store made up of the passed in CertStores.

Method Summary

java.lang.Object	clone() Makes a copy of this CertStoreParameters. The precise meaning of "copy" may depend on the class of the CertStoreParameters object.
java.util.Collection	getCertStores()
boolean	getSearchAllStores()

Methods inherited from class java.lang.Object

equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Detail

MultiCertStoreParameters

public MultiCertStoreParameters(java.util.Collection certStores)

Create a parameters object which specifies searching of all the passed in stores.

Parameters:

certStores - CertStores making up the multi CertStore

MultiCertStoreParameters

public MultiCertStoreParameters(java.util.Collection certStores,
                                boolean searchAllStores)

Create a parameters object which can be to used to make a multi store made up of the passed in CertStores. If the searchAllStores parameter is false, any search on the multi-store will terminate as soon as a search query produces a result.

Parameters:

certStores - CertStores making up the multi CertStore

searchAllStores - true if all CertStores should be searched on request, false if a result should be returned on the first successful CertStore query.

Method Detail

getCertStores

public java.util.Collection getCertStores()

getSearchAllStores

public boolean getSearchAllStores()

clone

public java.lang.Object clone()

Description copied from interface: CertStoreParameters

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.

Specified by:

clone in interface CertStoreParameters

Overrides:

clone in class java.lang.Object

Following copied from interface: org.bouncycastle.jce.cert.CertStoreParameters

Returns:

a copy of this CertStoreParameters