1f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project/* 2f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project * Licensed to the Apache Software Foundation (ASF) under one or more 3f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project * contributor license agreements. See the NOTICE file distributed with 4f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project * this work for additional information regarding copyright ownership. 5f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project * The ASF licenses this file to You under the Apache License, Version 2.0 6f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project * (the "License"); you may not use this file except in compliance with 7f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project * the License. You may obtain a copy of the License at 8f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project * 9f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project * http://www.apache.org/licenses/LICENSE-2.0 10f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project * 11f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project * Unless required by applicable law or agreed to in writing, software 12f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project * distributed under the License is distributed on an "AS IS" BASIS, 13f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. 14f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project * See the License for the specific language governing permissions and 15f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project * limitations under the License. 16f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project */ 17f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project 18f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Projectpackage java.security.cert; 19f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project 20f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Projectimport java.util.Collection; 21f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Projectimport java.util.Collections; 22f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project 23f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project/** 24f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project * The parameters to initialize a <i>Collection</i> type {@code CertStore} instance. 25f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project * <p> 26f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project * It is used to specify the {@code Collection} where the {@code CertStore} will 27e7637fe9734c4e3bece51db6773505c04e49fabaElliott Hughes * retrieve the certificates and CRLs from. 28f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project */ 29f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Projectpublic class CollectionCertStoreParameters implements CertStoreParameters { 30f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project // Default empty and immutable collection. 31f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project // Used if <code>CollectionCertStoreParameters</code>instance 32f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project // created by the no arg constructor 33f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project private static final Collection<?> defaultCollection = Collections.EMPTY_SET; 34f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project // A <code>Collection</code> of <code>Certificate</code>s 35f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project // and <code>CRL</code>s 36f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project private final Collection<?> collection; 37f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project 38f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project /** 39f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project * Creates a new {@code CollectionCertStoreParameters} without a collection. 40f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project * <p> 41f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project * The default collection is an empty and unmodifiable {@code Collection}. 42f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project */ 43f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project public CollectionCertStoreParameters() { 44f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project this.collection = defaultCollection; 45f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project } 46f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project 47f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project /** 48f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project * Creates a new {@code CollectionCertStoreParameters} with the specified 49f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project * collection. 50f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project * <p> 51f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project * The specified collection is not copied and therefore may be modified at 52f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project * any time. 53e7637fe9734c4e3bece51db6773505c04e49fabaElliott Hughes * 54f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project * @param collection 55f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project * the collection where the {@code Certificate}s and {@code CRL}s 56f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project * will be retrieved from. 57f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project * @throws NullPointerException 58f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project * if {@code collection is null}. 59f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project */ 60f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project public CollectionCertStoreParameters(Collection<?> collection) { 61f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project this.collection = collection; 62f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project if (this.collection == null) { 63f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project throw new NullPointerException(); 64f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project } 65f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project } 66f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project 67f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project /** 68f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project * Clones this {@code CollectionCertStoreParameters} instance, but not the 69f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project * underlying collection. 70e7637fe9734c4e3bece51db6773505c04e49fabaElliott Hughes * 71f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project * @return the cloned instance. 72f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project */ 73f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project public Object clone() { 74e7637fe9734c4e3bece51db6773505c04e49fabaElliott Hughes try { 75e7637fe9734c4e3bece51db6773505c04e49fabaElliott Hughes return super.clone(); 76e7637fe9734c4e3bece51db6773505c04e49fabaElliott Hughes } catch (CloneNotSupportedException e) { 77e7637fe9734c4e3bece51db6773505c04e49fabaElliott Hughes return null; 78e7637fe9734c4e3bece51db6773505c04e49fabaElliott Hughes } 79f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project } 80f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project 81f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project /** 82f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project * Returns the collection where the {@code Certificate}s and {@code CRL}s 83f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project * are retrieved from. 84e7637fe9734c4e3bece51db6773505c04e49fabaElliott Hughes * 85f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project * @return the collection where the {@code Certificate}s and {@code CRL}s 86f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project * will be retrieved from. 87f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project */ 88f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project public Collection<?> getCollection() { 89f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project return collection; 90f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project } 91f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project 92f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project /** 93f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project * Returns the string representation of this instance. 94e7637fe9734c4e3bece51db6773505c04e49fabaElliott Hughes * 95f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project * @return the string representation of this instance. 96f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project */ 97f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project public String toString() { 98e7637fe9734c4e3bece51db6773505c04e49fabaElliott Hughes StringBuilder sb = 99e7637fe9734c4e3bece51db6773505c04e49fabaElliott Hughes new StringBuilder("CollectionCertStoreParameters: [\ncollection: "); //$NON-NLS-1$ 100f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project sb.append(getCollection().toString()); 101f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project sb.append("\n]"); //$NON-NLS-1$ 102f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project return sb.toString(); 103f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project } 104f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project} 105