/* * Copyright (c) 1997, 2004, Oracle and/or its affiliates. All rights reserved. * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER. * * This code is free software; you can redistribute it and/or modify it * under the terms of the GNU General Public License version 2 only, as * published by the Free Software Foundation. Oracle designates this * particular file as subject to the "Classpath" exception as provided * by Oracle in the LICENSE file that accompanied this code. * * This code is distributed in the hope that it will be useful, but WITHOUT * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or * FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License * version 2 for more details (a copy is included in the LICENSE file that * accompanied this code). * * You should have received a copy of the GNU General Public License version * 2 along with this work; if not, write to the Free Software Foundation, * Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA. * * Please contact Oracle, 500 Oracle Parkway, Redwood Shores, CA 94065 USA * or visit www.oracle.com if you need additional information or have any * questions. */ package sun.security.x509; import java.io.IOException; import sun.security.util.*; /** * This class implements the ASN.1 GeneralName object class. *

* The ASN.1 syntax for this is: *

 * GeneralName ::= CHOICE {
 *    otherName                       [0]     OtherName,
 *    rfc822Name                      [1]     IA5String,
 *    dNSName                         [2]     IA5String,
 *    x400Address                     [3]     ORAddress,
 *    directoryName                   [4]     Name,
 *    ediPartyName                    [5]     EDIPartyName,
 *    uniformResourceIdentifier       [6]     IA5String,
 *    iPAddress                       [7]     OCTET STRING,
 *    registeredID                    [8]     OBJECT IDENTIFIER
 * }
 * 
* @author Amit Kapoor * @author Hemma Prafullchandra */ public class GeneralName { // Private data members private GeneralNameInterface name = null; /** * Default constructor for the class. * * @param name the selected CHOICE from the list. * @throws NullPointerException if name is null */ public GeneralName(GeneralNameInterface name) { if (name == null) { throw new NullPointerException("GeneralName must not be null"); } this.name = name; } /** * Create the object from its DER encoded value. * * @param encName the DER encoded GeneralName. */ public GeneralName(DerValue encName) throws IOException { this(encName, false); } /** * Create the object from its DER encoded value. * * @param encName the DER encoded GeneralName. * @param nameConstraint true if general name is a name constraint */ public GeneralName(DerValue encName, boolean nameConstraint) throws IOException { short tag = (byte)(encName.tag & 0x1f); // All names except for NAME_DIRECTORY should be encoded with the // IMPLICIT tag. switch (tag) { case GeneralNameInterface.NAME_ANY: if (encName.isContextSpecific() && encName.isConstructed()) { encName.resetTag(DerValue.tag_Sequence); name = new OtherName(encName); } else { throw new IOException("Invalid encoding of Other-Name"); } break; case GeneralNameInterface.NAME_RFC822: if (encName.isContextSpecific() && !encName.isConstructed()) { encName.resetTag(DerValue.tag_IA5String); name = new RFC822Name(encName); } else { throw new IOException("Invalid encoding of RFC822 name"); } break; case GeneralNameInterface.NAME_DNS: if (encName.isContextSpecific() && !encName.isConstructed()) { encName.resetTag(DerValue.tag_IA5String); name = new DNSName(encName); } else { throw new IOException("Invalid encoding of DNS name"); } break; case GeneralNameInterface.NAME_URI: if (encName.isContextSpecific() && !encName.isConstructed()) { encName.resetTag(DerValue.tag_IA5String); name = (nameConstraint ? URIName.nameConstraint(encName) : new URIName(encName)); } else { throw new IOException("Invalid encoding of URI"); } break; case GeneralNameInterface.NAME_IP: if (encName.isContextSpecific() && !encName.isConstructed()) { encName.resetTag(DerValue.tag_OctetString); name = new IPAddressName(encName); } else { throw new IOException("Invalid encoding of IP address"); } break; case GeneralNameInterface.NAME_OID: if (encName.isContextSpecific() && !encName.isConstructed()) { encName.resetTag(DerValue.tag_ObjectId); name = new OIDName(encName); } else { throw new IOException("Invalid encoding of OID name"); } break; case GeneralNameInterface.NAME_DIRECTORY: if (encName.isContextSpecific() && encName.isConstructed()) { name = new X500Name(encName.getData()); } else { throw new IOException("Invalid encoding of Directory name"); } break; case GeneralNameInterface.NAME_EDI: if (encName.isContextSpecific() && encName.isConstructed()) { encName.resetTag(DerValue.tag_Sequence); name = new EDIPartyName(encName); } else { throw new IOException("Invalid encoding of EDI name"); } break; default: throw new IOException("Unrecognized GeneralName tag, (" + tag +")"); } } /** * Return the type of the general name. */ public int getType() { return name.getType(); } /** * Return the GeneralNameInterface name. */ public GeneralNameInterface getName() { //XXXX May want to consider cloning this return name; } /** * Return the name as user readable string */ public String toString() { return name.toString(); } /** * Compare this GeneralName with another * * @param other GeneralName to compare to this * @returns true if match */ public boolean equals(Object other) { if (this == other) { return true; } if (!(other instanceof GeneralName)) return false; GeneralNameInterface otherGNI = ((GeneralName)other).name; try { return name.constrains(otherGNI) == GeneralNameInterface.NAME_MATCH; } catch (UnsupportedOperationException ioe) { return false; } } /** * Returns the hash code for this GeneralName. * * @return a hash code value. */ public int hashCode() { return name.hashCode(); } /** * Encode the name to the specified DerOutputStream. * * @param out the DerOutputStream to encode the the GeneralName to. * @exception IOException on encoding errors. */ public void encode(DerOutputStream out) throws IOException { DerOutputStream tmp = new DerOutputStream(); name.encode(tmp); int nameType = name.getType(); if (nameType == GeneralNameInterface.NAME_ANY || nameType == GeneralNameInterface.NAME_X400 || nameType == GeneralNameInterface.NAME_EDI) { // implicit, constructed form out.writeImplicit(DerValue.createTag(DerValue.TAG_CONTEXT, true, (byte)nameType), tmp); } else if (nameType == GeneralNameInterface.NAME_DIRECTORY) { // explicit, constructed form since underlying tag is CHOICE // (see X.680 section 30.6, part c) out.write(DerValue.createTag(DerValue.TAG_CONTEXT, true, (byte)nameType), tmp); } else { // implicit, primitive form out.writeImplicit(DerValue.createTag(DerValue.TAG_CONTEXT, false, (byte)nameType), tmp); } } }