243 lines
7.6 KiB
Java
243 lines
7.6 KiB
Java
/*
|
|
* Copyright (c) 2005, 2011, 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 java.util.*;
|
|
|
|
import sun.security.util.BitArray;
|
|
import sun.security.util.DerOutputStream;
|
|
import sun.security.util.DerValue;
|
|
|
|
/**
|
|
* Represents the DistributionPointName ASN.1 type.
|
|
*
|
|
* It is used in the CRL Distribution Points Extension (OID = 2.5.29.31)
|
|
* and the Issuing Distribution Point Extension (OID = 2.5.29.28).
|
|
* <p>
|
|
* Its ASN.1 definition is:
|
|
* <pre>
|
|
*
|
|
* DistributionPointName ::= CHOICE {
|
|
* fullName [0] GeneralNames,
|
|
* nameRelativeToCRLIssuer [1] RelativeDistinguishedName }
|
|
*
|
|
* GeneralNames ::= SEQUENCE SIZE (1..MAX) OF GeneralName
|
|
*
|
|
* GeneralName ::= CHOICE {
|
|
* otherName [0] INSTANCE OF OTHER-NAME,
|
|
* 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 }
|
|
*
|
|
* RelativeDistinguishedName ::= SET OF AttributeTypeAndValue
|
|
*
|
|
* AttributeTypeAndValue ::= SEQUENCE {
|
|
* type AttributeType,
|
|
* value AttributeValue }
|
|
*
|
|
* AttributeType ::= OBJECT IDENTIFIER
|
|
*
|
|
* AttributeValue ::= ANY DEFINED BY AttributeType
|
|
*
|
|
* </pre>
|
|
* <p>
|
|
* Instances of this class are designed to be immutable. However, since this
|
|
* is an internal API we do not use defensive cloning for values for
|
|
* performance reasons. It is the responsibility of the consumer to ensure
|
|
* that no mutable elements are modified.
|
|
*
|
|
* @see CRLDistributionPointsExtension
|
|
* @see IssuingDistributionPointExtension
|
|
* @since 1.6
|
|
*/
|
|
public class DistributionPointName {
|
|
|
|
// ASN.1 context specific tag values
|
|
private static final byte TAG_FULL_NAME = 0;
|
|
private static final byte TAG_RELATIVE_NAME = 1;
|
|
|
|
// Only one of fullName and relativeName can be set
|
|
private GeneralNames fullName = null;
|
|
private RDN relativeName = null;
|
|
|
|
// Cached hashCode value
|
|
private volatile int hashCode;
|
|
|
|
/**
|
|
* Creates a distribution point name using a full name.
|
|
*
|
|
* @param fullName the name for the distribution point.
|
|
* @exception IllegalArgumentException if <code>fullName</code> is null.
|
|
*/
|
|
public DistributionPointName(GeneralNames fullName) {
|
|
|
|
if (fullName == null) {
|
|
throw new IllegalArgumentException("fullName must not be null");
|
|
}
|
|
this.fullName = fullName;
|
|
}
|
|
|
|
/**
|
|
* Creates a distribution point name using a relative name.
|
|
*
|
|
* @param relativeName the name of the distribution point relative to
|
|
* the name of the issuer of the CRL.
|
|
* @exception IllegalArgumentException if <code>relativeName</code> is null.
|
|
*/
|
|
public DistributionPointName(RDN relativeName) {
|
|
|
|
if (relativeName == null) {
|
|
throw new IllegalArgumentException("relativeName must not be null");
|
|
}
|
|
this.relativeName = relativeName;
|
|
}
|
|
|
|
/**
|
|
* Creates a distribution point name from its DER-encoded form.
|
|
*
|
|
* @param encoding the DER-encoded value.
|
|
* @throws IOException on decoding error.
|
|
*/
|
|
public DistributionPointName(DerValue encoding) throws IOException {
|
|
|
|
if (encoding.isContextSpecific(TAG_FULL_NAME) &&
|
|
encoding.isConstructed()) {
|
|
|
|
encoding.resetTag(DerValue.tag_Sequence);
|
|
fullName = new GeneralNames(encoding);
|
|
|
|
} else if (encoding.isContextSpecific(TAG_RELATIVE_NAME) &&
|
|
encoding.isConstructed()) {
|
|
|
|
encoding.resetTag(DerValue.tag_Set);
|
|
relativeName = new RDN(encoding);
|
|
|
|
} else {
|
|
throw new IOException("Invalid encoding for DistributionPointName");
|
|
}
|
|
|
|
}
|
|
|
|
/**
|
|
* Returns the full name for the distribution point or null if not set.
|
|
*/
|
|
public GeneralNames getFullName() {
|
|
return fullName;
|
|
}
|
|
|
|
/**
|
|
* Returns the relative name for the distribution point or null if not set.
|
|
*/
|
|
public RDN getRelativeName() {
|
|
return relativeName;
|
|
}
|
|
|
|
/**
|
|
* Encodes the distribution point name and writes it to the DerOutputStream.
|
|
*
|
|
* @param out the output stream.
|
|
* @exception IOException on encoding error.
|
|
*/
|
|
public void encode(DerOutputStream out) throws IOException {
|
|
|
|
DerOutputStream theChoice = new DerOutputStream();
|
|
|
|
if (fullName != null) {
|
|
fullName.encode(theChoice);
|
|
out.writeImplicit(
|
|
DerValue.createTag(DerValue.TAG_CONTEXT, true, TAG_FULL_NAME),
|
|
theChoice);
|
|
|
|
} else {
|
|
relativeName.encode(theChoice);
|
|
out.writeImplicit(
|
|
DerValue.createTag(DerValue.TAG_CONTEXT, true,
|
|
TAG_RELATIVE_NAME),
|
|
theChoice);
|
|
}
|
|
}
|
|
|
|
/**
|
|
* Compare an object to this distribution point name for equality.
|
|
*
|
|
* @param obj Object to be compared to this
|
|
* @return true if objects match; false otherwise
|
|
*/
|
|
public boolean equals(Object obj) {
|
|
if (this == obj) {
|
|
return true;
|
|
}
|
|
if (obj instanceof DistributionPointName == false) {
|
|
return false;
|
|
}
|
|
DistributionPointName other = (DistributionPointName)obj;
|
|
|
|
return Objects.equals(this.fullName, other.fullName) &&
|
|
Objects.equals(this.relativeName, other.relativeName);
|
|
}
|
|
|
|
/**
|
|
* Returns the hash code for this distribution point name.
|
|
*
|
|
* @return the hash code.
|
|
*/
|
|
public int hashCode() {
|
|
int hash = hashCode;
|
|
if (hash == 0) {
|
|
hash = 1;
|
|
if (fullName != null) {
|
|
hash += fullName.hashCode();
|
|
|
|
} else {
|
|
hash += relativeName.hashCode();
|
|
}
|
|
hashCode = hash;
|
|
}
|
|
return hash;
|
|
}
|
|
|
|
/**
|
|
* Returns a printable string of the distribution point name.
|
|
*/
|
|
public String toString() {
|
|
StringBuilder sb = new StringBuilder();
|
|
if (fullName != null) {
|
|
sb.append("DistributionPointName:\n " + fullName + "\n");
|
|
|
|
} else {
|
|
sb.append("DistributionPointName:\n " + relativeName + "\n");
|
|
}
|
|
|
|
return sb.toString();
|
|
}
|
|
}
|