--- /dev/null Thu Jan 01 00:00:00 1970 +0000
+++ b/src/java.base/share/classes/sun/security/x509/DistributionPointName.java Tue Sep 12 19:03:39 2017 +0200
@@ -0,0 +1,242 @@
+/*
+ * 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();
+ sb.append("DistributionPointName:\n ");
+ if (fullName != null) {
+ sb.append(fullName);
+ } else {
+ sb.append(relativeName);
+ }
+ sb.append('\n');
+ return sb.toString();
+ }
+}