java.security.cert: public class: CollectionCertStoreParameters

java.security.cert
public class: CollectionCertStoreParameters [javadoc | source]

java.lang.Object
   java.security.cert.CollectionCertStoreParameters

All Implemented Interfaces:
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.

Also see:

java.util.Collection

CertStore

since: 1.4 -

author: Steve - Hanna

Constructor:

Constructor:
public CollectionCertStoreParameters() { coll = Collections.EMPTY_SET; } Creates an instance of `CollectionCertStoreParameters` with the default parameter values (an empty and immutable `Collection`).
public CollectionCertStoreParameters(Collection<?> collection) { if (collection == null) throw new NullPointerException(); coll = 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 `CRL`s from the `Collection`, thus changing the set of `Certificates` or `CRL`s 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 `Certificate`s and `CRL`s Throws: `NullPointerException` - if `collection` is `null` exception: `NullPointerException` - if `collection` is `null`

 public CollectionCertStoreParameters() {
        coll = Collections.EMPTY_SET;
}

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

 public CollectionCertStoreParameters(Collection<?> collection) {
        if (collection == null)
            throw new NullPointerException();
        coll = collection;
}

CollectionCertStoreParameters

Collection

Certificate

CRL

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

exception: NullPointerException - if collection is null

Method from java.security.cert.CollectionCertStoreParameters Summary:
clone, getCollection, toString

Methods from java.lang.Object:
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Method from java.security.cert.CollectionCertStoreParameters Detail:
public Object clone() { try { return super.clone(); } catch (CloneNotSupportedException e) { /* Cannot happen */ throw new InternalError(e.toString()); } } Returns a copy of this object. Note that only a reference to the `Collection` is copied, and not the contents.
public Collection<?> getCollection() { return coll; } Returns the `Collection` from which `Certificate`s and `CRL`s 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 `CRL`s from the `Collection`.
public String toString() { StringBuffer sb = new StringBuffer(); sb.append("CollectionCertStoreParameters: [\n"); sb.append(" collection: " + coll + "\n"); sb.append("]"); return sb.toString(); } Returns a formatted string describing the parameters.

Method from java.security.cert.CollectionCertStoreParameters Detail:

 public Object clone() {
        try {
            return super.clone();
        } catch (CloneNotSupportedException e) {
            /* Cannot happen */
            throw new InternalError(e.toString());
        }
}

Collection

 public Collection<?> getCollection() {
        return coll;
}

Collection

Certificate

CRL

not

Collection

Certificates

CRL

Collection

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

Returns a formatted string describing the parameters.