0N/A/*
2362N/A * Copyright (c) 2000, 2006, Oracle and/or its affiliates. All rights reserved.
0N/A * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
0N/A *
0N/A * This code is free software; you can redistribute it and/or modify it
0N/A * under the terms of the GNU General Public License version 2 only, as
2362N/A * published by the Free Software Foundation. Oracle designates this
0N/A * particular file as subject to the "Classpath" exception as provided
2362N/A * by Oracle in the LICENSE file that accompanied this code.
0N/A *
0N/A * This code is distributed in the hope that it will be useful, but WITHOUT
0N/A * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
0N/A * FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License
0N/A * version 2 for more details (a copy is included in the LICENSE file that
0N/A * accompanied this code).
0N/A *
0N/A * You should have received a copy of the GNU General Public License version
0N/A * 2 along with this work; if not, write to the Free Software Foundation,
0N/A * Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA.
0N/A *
2362N/A * Please contact Oracle, 500 Oracle Parkway, Redwood Shores, CA 94065 USA
2362N/A * or visit www.oracle.com if you need additional information or have any
2362N/A * questions.
0N/A */
0N/A
0N/Apackage java.security.cert;
0N/A
0N/Aimport java.io.Serializable;
0N/Aimport java.util.Collection;
0N/Aimport java.util.Collections;
0N/A
0N/A/**
0N/A * Parameters used as input for the Collection <code>CertStore</code>
0N/A * algorithm.
0N/A * <p>
0N/A * This class is used to provide necessary configuration parameters
0N/A * to implementations of the Collection <code>CertStore</code>
0N/A * algorithm. The only parameter included in this class is the
0N/A * <code>Collection</code> from which the <code>CertStore</code> will
0N/A * retrieve certificates and CRLs.
0N/A * <p>
0N/A * <b>Concurrent Access</b>
0N/A * <p>
0N/A * Unless otherwise specified, the methods defined in this class are not
0N/A * thread-safe. Multiple threads that need to access a single
0N/A * object concurrently should synchronize amongst themselves and
0N/A * provide the necessary locking. Multiple threads each manipulating
0N/A * separate objects need not synchronize.
0N/A *
0N/A * @since 1.4
0N/A * @author Steve Hanna
0N/A * @see java.util.Collection
0N/A * @see CertStore
0N/A */
0N/Apublic class CollectionCertStoreParameters
0N/A implements CertStoreParameters {
0N/A
0N/A private Collection<?> coll;
0N/A
0N/A /**
0N/A * Creates an instance of <code>CollectionCertStoreParameters</code>
0N/A * which will allow certificates and CRLs to be retrieved from the
0N/A * specified <code>Collection</code>. If the specified
0N/A * <code>Collection</code> contains an object that is not a
0N/A * <code>Certificate</code> or <code>CRL</code>, that object will be
0N/A * ignored by the Collection <code>CertStore</code>.
0N/A * <p>
0N/A * The <code>Collection</code> is <b>not</b> copied. Instead, a
0N/A * reference is used. This allows the caller to subsequently add or
0N/A * remove <code>Certificates</code> or <code>CRL</code>s from the
0N/A * <code>Collection</code>, thus changing the set of
0N/A * <code>Certificates</code> or <code>CRL</code>s available to the
0N/A * Collection <code>CertStore</code>. The Collection <code>CertStore</code>
0N/A * will not modify the contents of the <code>Collection</code>.
0N/A * <p>
0N/A * If the <code>Collection</code> will be modified by one thread while
0N/A * another thread is calling a method of a Collection <code>CertStore</code>
0N/A * that has been initialized with this <code>Collection</code>, the
0N/A * <code>Collection</code> must have fail-fast iterators.
0N/A *
0N/A * @param collection a <code>Collection</code> of
0N/A * <code>Certificate</code>s and <code>CRL</code>s
0N/A * @exception NullPointerException if <code>collection</code> is
0N/A * <code>null</code>
0N/A */
0N/A public CollectionCertStoreParameters(Collection<?> collection) {
0N/A if (collection == null)
0N/A throw new NullPointerException();
0N/A coll = collection;
0N/A }
0N/A
0N/A /**
0N/A * Creates an instance of <code>CollectionCertStoreParameters</code> with
0N/A * the default parameter values (an empty and immutable
0N/A * <code>Collection</code>).
0N/A */
0N/A public CollectionCertStoreParameters() {
0N/A coll = Collections.EMPTY_SET;
0N/A }
0N/A
0N/A /**
0N/A * Returns the <code>Collection</code> from which <code>Certificate</code>s
0N/A * and <code>CRL</code>s are retrieved. This is <b>not</b> a copy of the
0N/A * <code>Collection</code>, it is a reference. This allows the caller to
0N/A * subsequently add or remove <code>Certificates</code> or
0N/A * <code>CRL</code>s from the <code>Collection</code>.
0N/A *
0N/A * @return the <code>Collection</code> (never null)
0N/A */
0N/A public Collection<?> getCollection() {
0N/A return coll;
0N/A }
0N/A
0N/A /**
0N/A * Returns a copy of this object. Note that only a reference to the
0N/A * <code>Collection</code> is copied, and not the contents.
0N/A *
0N/A * @return the copy
0N/A */
0N/A public Object clone() {
0N/A try {
0N/A return super.clone();
0N/A } catch (CloneNotSupportedException e) {
0N/A /* Cannot happen */
0N/A throw new InternalError(e.toString());
0N/A }
0N/A }
0N/A
0N/A /**
0N/A * Returns a formatted string describing the parameters.
0N/A *
0N/A * @return a formatted string describing the parameters
0N/A */
0N/A public String toString() {
0N/A StringBuffer sb = new StringBuffer();
0N/A sb.append("CollectionCertStoreParameters: [\n");
0N/A sb.append(" collection: " + coll + "\n");
0N/A sb.append("]");
0N/A return sb.toString();
0N/A }
0N/A}