001: /*
002: * @(#)OIDName.java 1.16 06/10/10
003: *
004: * Copyright 1990-2006 Sun Microsystems, Inc. All Rights Reserved.
005: * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER
006: *
007: * This program is free software; you can redistribute it and/or
008: * modify it under the terms of the GNU General Public License version
009: * 2 only, as published by the Free Software Foundation.
010: *
011: * This program is distributed in the hope that it will be useful, but
012: * WITHOUT ANY WARRANTY; without even the implied warranty of
013: * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
014: * General Public License version 2 for more details (a copy is
015: * included at /legal/license.txt).
016: *
017: * You should have received a copy of the GNU General Public License
018: * version 2 along with this work; if not, write to the Free Software
019: * Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA
020: * 02110-1301 USA
021: *
022: * Please contact Sun Microsystems, Inc., 4150 Network Circle, Santa
023: * Clara, CA 95054 or visit www.sun.com if you need additional
024: * information or have any questions.
025: *
026: */
027:
028: package sun.security.x509;
029:
030: import java.io.IOException;
031:
032: import sun.security.util.*;
033:
034: /**
035: * This class implements the OIDName as required by the GeneralNames
036: * ASN.1 object.
037: *
038: * @author Amit Kapoor
039: * @author Hemma Prafullchandra
040: * @version 1.9
041: * @see GeneralName
042: * @see GeneralNames
043: * @see GeneralNameInterface
044: */
045: public class OIDName implements GeneralNameInterface {
046: private ObjectIdentifier oid;
047:
048: /**
049: * Create the OIDName object from the passed encoded Der value.
050: *
051: * @param derValue the encoded DER OIDName.
052: * @exception IOException on error.
053: */
054: public OIDName(DerValue derValue) throws IOException {
055: oid = derValue.getOID();
056: }
057:
058: /**
059: * Create the OIDName object with the specified name.
060: *
061: * @param name the OIDName.
062: */
063: public OIDName(ObjectIdentifier oid) {
064: this .oid = oid;
065: }
066:
067: /**
068: * Create the OIDName from the String form of the OID
069: *
070: * @param name the OIDName in form "x.y.z..."
071: * @throws IOException on error
072: */
073: public OIDName(String name) throws IOException {
074: try {
075: oid = new ObjectIdentifier(name);
076: } catch (Exception e) {
077: throw new IOException("Unable to create OIDName: " + e);
078: }
079: }
080:
081: /**
082: * Return the type of the GeneralName.
083: */
084: public int getType() {
085: return (GeneralNameInterface.NAME_OID);
086: }
087:
088: /**
089: * Encode the OID name into the DerOutputStream.
090: *
091: * @param out the DER stream to encode the OIDName to.
092: * @exception IOException on encoding errors.
093: */
094: public void encode(DerOutputStream out) throws IOException {
095: out.putOID(oid);
096: }
097:
098: /**
099: * Convert the name into user readable string.
100: */
101: public String toString() {
102: return ("OIDName: " + oid.toString());
103: }
104:
105: /**
106: * Returns this OID name.
107: */
108: public ObjectIdentifier getOID() {
109: return oid;
110: }
111:
112: /**
113: * Compares this name with another, for equality.
114: *
115: * @return true iff the names are identical
116: */
117: public boolean equals(Object obj) {
118: if (this == obj)
119: return true;
120:
121: if (!(obj instanceof OIDName))
122: return false;
123:
124: OIDName other = (OIDName) obj;
125:
126: return oid.equals(other.oid);
127: }
128:
129: /**
130: * Returns the hash code value for this object.
131: *
132: * @return a hash code value for this object.
133: */
134: public int hashCode() {
135: return oid.hashCode();
136: }
137:
138: /**
139: * Return type of constraint inputName places on this name:<ul>
140: * <li>NAME_DIFF_TYPE = -1: input name is different type from name (i.e. does not constrain).
141: * <li>NAME_MATCH = 0: input name matches name.
142: * <li>NAME_NARROWS = 1: input name narrows name (is lower in the naming subtree)
143: * <li>NAME_WIDENS = 2: input name widens name (is higher in the naming subtree)
144: * <li>NAME_SAME_TYPE = 3: input name does not match or narrow name, but is same type.
145: * </ul>. These results are used in checking NameConstraints during
146: * certification path verification.
147: *
148: * @param inputName to be checked for being constrained
149: * @returns constraint type above
150: * @throws UnsupportedOperationException if name is not exact match, but narrowing and widening are
151: * not supported for this name type.
152: */
153: public int constrains(GeneralNameInterface inputName)
154: throws UnsupportedOperationException {
155: int constraintType;
156: if (inputName == null)
157: constraintType = NAME_DIFF_TYPE;
158: else if (inputName.getType() != NAME_OID)
159: constraintType = NAME_DIFF_TYPE;
160: else if (this .equals((OIDName) inputName))
161: constraintType = NAME_MATCH;
162: else
163: //widens and narrows not defined in RFC2459 for OIDName (aka registeredID)
164: throw new UnsupportedOperationException(
165: "Narrowing and widening are not supported for OIDNames");
166: return constraintType;
167: }
168:
169: /**
170: * Return subtree depth of this name for purposes of determining
171: * NameConstraints minimum and maximum bounds and for calculating
172: * path lengths in name subtrees.
173: *
174: * @returns distance of name from root
175: * @throws UnsupportedOperationException if not supported for this name type
176: */
177: public int subtreeDepth() throws UnsupportedOperationException {
178: throw new UnsupportedOperationException(
179: "subtreeDepth() not supported for OIDName.");
180: }
181: }
|