CollectionCertStoreParameters

AI-generated Key Takeaways

• CollectionCertStoreParameters configures the Collection CertStore algorithm, primarily using a Collection to store and retrieve certificates and CRLs.

• The provided Collection is directly referenced, not copied, allowing for dynamic updates to its certificate and CRL content.

• Methods in this class are generally not thread-safe and require external synchronization for concurrent access by multiple threads.

• Instances can be created with a specific Collection or using default values, resulting in an empty and immutable Collection.

• CollectionCertStoreParameters offers methods to clone the parameters (with a shared Collection reference), retrieve the Collection, and generate a descriptive string representation.

public class CollectionCertStoreParameters extends Object
implements CertStoreParameters

Parameters used as input for the Collection CertStore algorithm.

This class is used to provide necessary configuration parameters to implementations of the Collection CertStore algorithm. The only parameter included in this class is the Collection from which the CertStore will retrieve certificates and CRLs.

Concurrent Access

Unless otherwise specified, the methods defined in this class are not thread-safe. Multiple threads that need to access a single object concurrently should synchronize amongst themselves and provide the necessary locking. Multiple threads each manipulating separate objects need not synchronize.

See Also

• Collection
• CertStore

Public Constructor Summary

	CollectionCertStoreParameters(Collection<?> collection) Creates an instance of CollectionCertStoreParameters which will allow certificates and CRLs to be retrieved from the specified Collection.
	CollectionCertStoreParameters() Creates an instance of CollectionCertStoreParameters with the default parameter values (an empty and immutable Collection).

Public Method Summary

Object	clone() Returns a copy of this object.
Collection<?>	getCollection() Returns the Collection from which Certificates and CRLs are retrieved.
String	toString() Returns a formatted string describing the parameters.

Inherited Method Summary

From class java.lang.Object

Object	clone() Creates and returns a copy of this Object.
boolean	equals(Object obj) Compares this instance with the specified object and indicates if they are equal.
void	finalize() Invoked when the garbage collector has detected that this instance is no longer reachable.
final Class<?>	getClass() Returns the unique instance of Class that represents this object's class.
int	hashCode() Returns an integer hash code for this object.
final void	notify() Causes a thread which is waiting on this object's monitor (by means of calling one of the wait() methods) to be woken up.
final void	notifyAll() Causes all threads which are waiting on this object's monitor (by means of calling one of the wait() methods) to be woken up.
String	toString() Returns a string containing a concise, human-readable description of this object.
final void	wait(long timeout, int nanos) Causes the calling thread to wait until another thread calls the notify() or notifyAll() method of this object or until the specified timeout expires.
final void	wait(long timeout) Causes the calling thread to wait until another thread calls the notify() or notifyAll() method of this object or until the specified timeout expires.
final void	wait() Causes the calling thread to wait until another thread calls the notify() or notifyAll() method of this object.

From interface java.security.cert.CertStoreParameters

abstract Object

clone() Makes a copy of this CertStoreParameters.

Public Constructors

public CollectionCertStoreParameters (Collection<?> collection)

Creates an instance of CollectionCertStoreParameters which will allow certificates and CRLs to be retrieved from the specified Collection. If the specified Collection contains an object that is not a Certificate or CRL, that object will be ignored by the Collection CertStore.

The Collection is not copied. Instead, a reference is used. This allows the caller to subsequently add or remove Certificates or CRLs from the Collection, thus changing the set of Certificates or CRLs available to the Collection CertStore. The Collection CertStore will not modify the contents of the Collection.

If the Collection will be modified by one thread while another thread is calling a method of a Collection CertStore that has been initialized with this Collection, the Collection must have fail-fast iterators.

Parameters

collection	a Collection of Certificates and CRLs

Throws

NullPointerException	if collection is null

public CollectionCertStoreParameters ()

Creates an instance of CollectionCertStoreParameters with the default parameter values (an empty and immutable Collection).

Public Methods

public Object clone ()

Returns a copy of this object. Note that only a reference to the Collection is copied, and not the contents.

Returns

• the copy

public Collection<?> getCollection ()

Returns the Collection from which Certificates and CRLs are retrieved. This is not a copy of the Collection, it is a reference. This allows the caller to subsequently add or remove Certificates or CRLs from the Collection.

Returns

• the Collection (never null)

public String toString ()

Returns a formatted string describing the parameters.

Returns

• a formatted string describing the parameters