java.security.cert
Class CollectionCertStoreParameters

java.lang.Object
  |
  +--java.security.cert.CollectionCertStoreParameters

All Implemented Interfaces:

CertStoreParameters, Cloneable

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.

Since:

1.4

See Also:

Collection, CertStore

Constructor Summary

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

CollectionCertStoreParameters(Collection collection)
Creates an instance of CollectionCertStoreParameters which will allow certificates and CRLs to be retrieved from the specified Collection.

Method Summary

Object	clone() Returns a copy of this object.
boolean	equals(Object other) Compares this object for equality with the specified object.
Collection	getCollection() Returns the Collection from which Certificates and CRLs are retrieved.
int	hashCode() Returns a hash code value for this object.
void	setCollection(Collection collection) Sets the Collection from which Certificates and CRLs will be retrieved.
String	toString() Returns a formatted string describing the parameters.

Methods inherited from class java.lang.Object

finalize, getClass, notify, notifyAll, wait, wait, wait

Constructor Detail

CollectionCertStoreParameters

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

CollectionCertStoreParameters

public CollectionCertStoreParameters()

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

Method Detail

setCollection

public void setCollection(Collection collection)

Sets the Collection from which Certificates and CRLs will be retrieved. This Collection replaces any Collection previously supplied to this object. 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.

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 - the specified Collection

Throws:

NullPointerException - if collection is null

getCollection

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)

clone

public Object clone()

Returns a copy of this object.

Specified by:

clone in interface CertStoreParameters

Overrides:

clone in class Object

Returns:

the copy

equals

public boolean equals(Object other)

Compares this object for equality with the specified object. If the other object is not a CollectionCertStoreParameters object, we return false. Otherwise, we return true if the parameters are equal.

Overrides:

equals in class Object

Parameters:

other - the object to test for equality

Returns:

true if the objects are equal, false otherwise

hashCode

public int hashCode()

Returns a hash code value for this object.

Overrides:

hashCode in class Object

Returns:

a hash code value

toString

public String toString()

Returns a formatted string describing the parameters.

Overrides:

toString in class Object

Returns:

a formatted string describing the parameters