/* |
|
* Copyright (c) 1997, 2020, 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 OIDName as required by the GeneralNames |
|
* ASN.1 object. |
|
* |
|
* @author Amit Kapoor |
|
* @author Hemma Prafullchandra |
|
* @see GeneralName |
|
* @see GeneralNames |
|
* @see GeneralNameInterface |
|
*/ |
|
public class OIDName implements GeneralNameInterface { |
|
private ObjectIdentifier oid; |
|
/** |
|
* Create the OIDName object from the passed encoded Der value. |
|
* |
|
* @param derValue the encoded DER OIDName. |
|
* @exception IOException on error. |
|
*/ |
|
public OIDName(DerValue derValue) throws IOException { |
|
oid = derValue.getOID(); |
|
} |
|
/** |
|
* Create the OIDName object with the specified name. |
|
* |
|
* @param oid the OIDName. |
|
*/ |
|
public OIDName(ObjectIdentifier oid) { |
|
this.oid = oid; |
|
} |
|
/** |
|
* Create the OIDName from the String form of the OID |
|
* |
|
* @param name the OIDName in form "x.y.z..." |
|
* @throws IOException on error |
|
*/ |
|
public OIDName(String name) throws IOException { |
|
try { |
|
oid = ObjectIdentifier.of(name); |
|
} catch (Exception e) { |
|
throw new IOException("Unable to create OIDName: " + e); |
|
} |
|
} |
|
/** |
|
* Return the type of the GeneralName. |
|
*/ |
|
public int getType() { |
|
return (GeneralNameInterface.NAME_OID); |
|
} |
|
/** |
|
* Encode the OID name into the DerOutputStream. |
|
* |
|
* @param out the DER stream to encode the OIDName to. |
|
* @exception IOException on encoding errors. |
|
*/ |
|
public void encode(DerOutputStream out) throws IOException { |
|
out.putOID(oid); |
|
} |
|
/** |
|
* Convert the name into user readable string. |
|
*/ |
|
public String toString() { |
|
return ("OIDName: " + oid.toString()); |
|
} |
|
/** |
|
* Returns this OID name. |
|
*/ |
|
public ObjectIdentifier getOID() { |
|
return oid; |
|
} |
|
/** |
|
* Compares this name with another, for equality. |
|
* |
|
* @return true iff the names are identical |
|
*/ |
|
public boolean equals(Object obj) { |
|
if (this == obj) |
|
return true; |
|
if (!(obj instanceof OIDName)) |
|
return false; |
|
OIDName other = (OIDName)obj; |
|
return oid.equals(other.oid); |
|
} |
|
/** |
|
* Returns the hash code value for this object. |
|
* |
|
* @return a hash code value for this object. |
|
*/ |
|
public int hashCode() { |
|
return oid.hashCode(); |
|
} |
|
/** |
|
* Return type of constraint inputName places on this name:<ul> |
|
* <li>NAME_DIFF_TYPE = -1: input name is different type from name (i.e. does not constrain). |
|
* <li>NAME_MATCH = 0: input name matches name. |
|
* <li>NAME_NARROWS = 1: input name narrows name (is lower in the naming subtree) |
|
* <li>NAME_WIDENS = 2: input name widens name (is higher in the naming subtree) |
|
* <li>NAME_SAME_TYPE = 3: input name does not match or narrow name, but is same type. |
|
* </ul>. These results are used in checking NameConstraints during |
|
* certification path verification. |
|
* |
|
* @param inputName to be checked for being constrained |
|
* @return constraint type above |
|
* @throws UnsupportedOperationException if name is not exact match, but narrowing and widening are |
|
* not supported for this name type. |
|
*/ |
|
public int constrains(GeneralNameInterface inputName) throws UnsupportedOperationException { |
|
int constraintType; |
|
if (inputName == null) |
|
constraintType = NAME_DIFF_TYPE; |
|
else if (inputName.getType() != NAME_OID) |
|
constraintType = NAME_DIFF_TYPE; |
|
else if (this.equals((OIDName)inputName)) |
|
constraintType = NAME_MATCH; |
|
else |
|
//widens and narrows not defined in RFC 5280 for OIDName (aka registeredID) |
|
throw new UnsupportedOperationException("Narrowing and widening are not supported for OIDNames"); |
|
return constraintType; |
|
} |
|
/** |
|
* Return subtree depth of this name for purposes of determining |
|
* NameConstraints minimum and maximum bounds and for calculating |
|
* path lengths in name subtrees. |
|
* |
|
* @return distance of name from root |
|
* @throws UnsupportedOperationException if not supported for this name type |
|
*/ |
|
public int subtreeDepth() throws UnsupportedOperationException { |
|
throw new UnsupportedOperationException("subtreeDepth() not supported for OIDName."); |
|
} |
|
} |