Back to index...

	/*
	* 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();
	}
	}

Back to index...