Home | History | Annotate | Download | only in x509 
      1 /*
      2  *  Licensed to the Apache Software Foundation (ASF) under one or more
      3  *  contributor license agreements.  See the NOTICE file distributed with
      4  *  this work for additional information regarding copyright ownership.
      5  *  The ASF licenses this file to You under the Apache License, Version 2.0
      6  *  (the "License"); you may not use this file except in compliance with
      7  *  the License.  You may obtain a copy of the License at
      8  *
      9  *     http://www.apache.org/licenses/LICENSE-2.0
     10  *
     11  *  Unless required by applicable law or agreed to in writing, software
     12  *  distributed under the License is distributed on an "AS IS" BASIS,
     13  *  WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
     14  *  See the License for the specific language governing permissions and
     15  *  limitations under the License.
     16  */
     17 
     18 /**
     19 * @author Alexander Y. Kleymenov
     20 * @version $Revision$
     21 */
     22 
     23 package org.apache.harmony.security.x509;
     24 
     25 import java.io.IOException;
     26 import java.util.ArrayList;
     27 import java.util.Collection;
     28 import java.util.Iterator;
     29 import java.util.List;
     30 import org.apache.harmony.security.asn1.ASN1SequenceOf;
     31 import org.apache.harmony.security.asn1.ASN1Type;
     32 import org.apache.harmony.security.asn1.BerInputStream;
     33 
     34 /**
     35  * The class encapsulates the ASN.1 DER encoding/decoding work
     36  * with Certificate Policies structure which is a part of X.509 certificate
     37  * (as specified in RFC 3280 -
     38  *  Internet X.509 Public Key Infrastructure.
     39  *  Certificate and Certificate Revocation List (CRL) Profile.
     40  *  http://www.ietf.org/rfc/rfc3280.txt):
     41  *
     42  * <pre>
     43  *   certificatePolicies ::= SEQUENCE SIZE (1..MAX) OF PolicyInformation
     44  * </pre>
     45  *
     46  */
     47 
     48 public class CertificatePolicies extends ExtensionValue {
     49 
     50     // the values of policyInformation field of the structure
     51     private List policyInformations;
     52     // the ASN.1 encoded form of CertificatePolicies
     53     private byte[] encoding;
     54 
     55     /**
     56      * Constructs an object representing the value of CertificatePolicies.
     57      */
     58     public CertificatePolicies() {}
     59 
     60     /**
     61      * TODO
     62      * @param   policyInformations: List
     63      */
     64     public CertificatePolicies(List policyInformations) {
     65         this.policyInformations = policyInformations;
     66     }
     67 
     68     public static CertificatePolicies decode(byte[] encoding)
     69             throws IOException {
     70         CertificatePolicies cps = ((CertificatePolicies) ASN1.decode(encoding));
     71         cps.encoding = encoding;
     72         return cps;
     73     }
     74 
     75     //
     76     // TODO
     77     // @param   policyInformations: List
     78     // @param   encoding:   byte[]
     79     //
     80     private CertificatePolicies(List policyInformations, byte[] encoding) {
     81         this.policyInformations = policyInformations;
     82         this.encoding = encoding;
     83     }
     84 
     85     /**
     86      * Returns the values of policyInformation field of the structure.
     87      * @return  policyInformations
     88      */
     89     public List getPolicyInformations() {
     90         return new ArrayList(policyInformations);
     91     }
     92 
     93     /**
     94      * TODO
     95      * @param   policyInformation:  PolicyInformation
     96      * @return
     97      */
     98     public CertificatePolicies addPolicyInformation(
     99             PolicyInformation policyInformation) {
    100         encoding = null;
    101         if (policyInformations == null) {
    102             policyInformations = new ArrayList();
    103         }
    104         policyInformations.add(policyInformation);
    105         return this;
    106     }
    107 
    108     /**
    109      * Returns ASN.1 encoded form of this X.509 CertificatePolicies value.
    110      * @return a byte array containing ASN.1 encode form.
    111      */
    112     public byte[] getEncoded() {
    113         if (encoding == null) {
    114             encoding = ASN1.encode(this);
    115         }
    116         return encoding;
    117     }
    118 
    119     /**
    120      * Places the string representation of extension value
    121      * into the StringBuffer object.
    122      */
    123     public void dumpValue(StringBuffer buffer, String prefix) {
    124         buffer.append(prefix).append("CertificatePolicies [\n");
    125         for (Iterator it=policyInformations.iterator(); it.hasNext();) {
    126             buffer.append(prefix);
    127             buffer.append("  ");
    128             ((PolicyInformation) it.next()).dumpValue(buffer);
    129             buffer.append('\n');
    130         }
    131         buffer.append(prefix).append("]\n");
    132     }
    133 
    134     /**
    135      * ASN.1 DER X.509 CertificatePolicies encoder/decoder class.
    136      */
    137     public static final ASN1Type ASN1 =
    138         new ASN1SequenceOf(PolicyInformation.ASN1) {
    139 
    140         public Object getDecodedObject(BerInputStream in) {
    141             return new CertificatePolicies((List) in.content, in.getEncoded());
    142         }
    143 
    144         public Collection getValues(Object object) {
    145             CertificatePolicies cps = (CertificatePolicies) object;
    146             return cps.policyInformations;
    147         }
    148     };
    149 }
    150 
    151