FileDocCategorySizeDatePackage
CollectionCertStoreParameters.javaAPI DocJava SE 5 API4496Fri Aug 26 14:57:16 BST 2005java.security.cert

CollectionCertStoreParameters

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.

version
1.8 05/05/04
since
1.4
author
Steve Hanna
see
java.util.Collection
see
CertStore

Fields Summary
private Collection
coll
Constructors Summary
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.

param
collection a Collection of Certificates and CRLs
exception
NullPointerException if collection is null

        if (collection == null)
            throw new NullPointerException();
        coll = collection;
    
public CollectionCertStoreParameters()
Creates an instance of CollectionCertStoreParameters with the default parameter values (an empty and immutable Collection).

        coll = Collections.EMPTY_SET;
    
Methods Summary
public java.lang.Objectclone()
Returns a copy of this object. Note that only a reference to the Collection is copied, and not the contents.

return
the copy

        try {
            return super.clone();
        } catch (CloneNotSupportedException e) {
            /* Cannot happen */
            throw new InternalError(e.toString());
        }
    
public java.util.CollectiongetCollection()
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.

return
the Collection (never null)

        return coll;
    
public java.lang.StringtoString()
Returns a formatted string describing the parameters.

return
a formatted string describing the parameters

        StringBuffer sb = new StringBuffer();
        sb.append("CollectionCertStoreParameters: [\n");
        sb.append("  collection: " + coll + "\n");
        sb.append("]");
        return sb.toString();