1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 91 92 93 94 95 96 97 98 99 100 101 102 103 104 105 106 107 108 109 110 111 112 113 114 115 116 117 118 119 120 121 122 123
/* * @(#)CollectionCertStoreParameters.java 1.9 05/11/17 * * Copyright 2006 Sun Microsystems, Inc. All rights reserved. * SUN PROPRIETARY/CONFIDENTIAL. Use is subject to license terms. */ package java.security.cert; import java.io.Serializable; import java.util.Collection; import java.util.Collections; /** * Parameters used as input for the Collection <code>CertStore</code> * algorithm. * <p> * This class is used to provide necessary configuration parameters * to implementations of the Collection <code>CertStore</code> * algorithm. The only parameter included in this class is the * <code>Collection</code> from which the <code>CertStore</code> will * retrieve certificates and CRLs. * <p> * <b>Concurrent Access</b> * <p> * 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.9 11/17/05 * @since 1.4 * @author Steve Hanna * @see java.util.Collection * @see CertStore */ public class CollectionCertStoreParameters implements CertStoreParameters { private Collection coll; /** * Creates an instance of <code>CollectionCertStoreParameters</code> * which will allow certificates and CRLs to be retrieved from the * specified <code>Collection</code>. If the specified * <code>Collection</code> contains an object that is not a * <code>Certificate</code> or <code>CRL</code>, that object will be * ignored by the Collection <code>CertStore</code>. * <p> * The <code>Collection</code> is <b>not</b> copied. Instead, a * reference is used. This allows the caller to subsequently add or * remove <code>Certificates</code> or <code>CRL</code>s from the * <code>Collection</code>, thus changing the set of * <code>Certificates</code> or <code>CRL</code>s available to the * Collection <code>CertStore</code>. The Collection <code>CertStore</code> * will not modify the contents of the <code>Collection</code>. * <p> * If the <code>Collection</code> will be modified by one thread while * another thread is calling a method of a Collection <code>CertStore</code> * that has been initialized with this <code>Collection</code>, the * <code>Collection</code> must have fail-fast iterators. * * @param collection a <code>Collection</code> of * <code>Certificate</code>s and <code>CRL</code>s * @exception NullPointerException if <code>collection</code> is * <code>null</code> */ public CollectionCertStoreParameters(Collection<?> collection) { if (collection == null) throw new NullPointerException(); coll = collection; } /** * Creates an instance of <code>CollectionCertStoreParameters</code> with * the default parameter values (an empty and immutable * <code>Collection</code>). */ public CollectionCertStoreParameters() { coll = Collections.EMPTY_SET; } /** * Returns the <code>Collection</code> from which <code>Certificate</code>s * and <code>CRL</code>s are retrieved. This is <b>not</b> a copy of the * <code>Collection</code>, it is a reference. This allows the caller to * subsequently add or remove <code>Certificates</code> or * <code>CRL</code>s from the <code>Collection</code>. * * @return the <code>Collection</code> (never null) */ public Collection<?> getCollection() { return coll; } /** * Returns a copy of this object. Note that only a reference to the * <code>Collection</code> is copied, and not the contents. * * @return the copy */ public Object clone() { try { return super.clone(); } catch (CloneNotSupportedException e) { /* Cannot happen */ throw new InternalError(e.toString()); } } /** * Returns a formatted string describing the parameters. * * @return a formatted string describing the parameters */ public String toString() { StringBuffer sb = new StringBuffer(); sb.append("CollectionCertStoreParameters: [\n"); sb.append(" collection: " + coll + "\n"); sb.append("]"); return sb.toString(); } }