sun.security.x509

Class DistributionPointName

java.lang.Object

sun.security.x509.DistributionPointName

public class DistributionPointName
extends java.lang.Object

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).

Its ASN.1 definition is:

     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

 

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.

Since:

1.6

See Also:

CRLDistributionPointsExtension, IssuingDistributionPointExtension

Constructor Summary

Constructors

Constructor and Description
DistributionPointName(DerValue encoding) Creates a distribution point name from its DER-encoded form.
DistributionPointName(GeneralNames fullName) Creates a distribution point name using a full name.
DistributionPointName(RDN relativeName) Creates a distribution point name using a relative name.

Method Summary

Methods

Modifier and Type	Method and Description
void	encode(DerOutputStream out) Encodes the distribution point name and writes it to the DerOutputStream.
boolean	equals(java.lang.Object obj) Compare an object to this distribution point name for equality.
GeneralNames	getFullName() Returns the full name for the distribution point or null if not set.
RDN	getRelativeName() Returns the relative name for the distribution point or null if not set.
int	hashCode() Returns the hash code for this distribution point name.
java.lang.String	toString() Returns a printable string of the distribution point name.

Methods inherited from class java.lang.Object

clone, finalize, getClass, notify, notifyAll, wait, wait, wait

Constructor Detail

DistributionPointName

public DistributionPointName(GeneralNames fullName)

Creates a distribution point name using a full name.

Parameters:

fullName - the name for the distribution point.

Throws:

java.lang.IllegalArgumentException - if fullName is null.

DistributionPointName

public DistributionPointName(RDN relativeName)

Creates a distribution point name using a relative name.

Parameters:

relativeName - the name of the distribution point relative to the name of the issuer of the CRL.

Throws:

java.lang.IllegalArgumentException - if relativeName is null.

DistributionPointName

public DistributionPointName(DerValue encoding)
                      throws java.io.IOException

Creates a distribution point name from its DER-encoded form.

Parameters:

encoding - the DER-encoded value.

Throws:

java.io.IOException - on decoding error.

Method Detail

getFullName

public GeneralNames getFullName()

Returns the full name for the distribution point or null if not set.

getRelativeName

public RDN getRelativeName()

Returns the relative name for the distribution point or null if not set.

encode

public void encode(DerOutputStream out)
            throws java.io.IOException

Encodes the distribution point name and writes it to the DerOutputStream.

Parameters:

out - the output stream.

Throws:

java.io.IOException - on encoding error.

equals

public boolean equals(java.lang.Object obj)

Compare an object to this distribution point name for equality.

Overrides:

equals in class java.lang.Object

Parameters:

obj - Object to be compared to this

Returns:

true if objects match; false otherwise

hashCode

public int hashCode()

Returns the hash code for this distribution point name.

Overrides:

hashCode in class java.lang.Object

Returns:

the hash code.

toString

public java.lang.String toString()

Returns a printable string of the distribution point name.

Overrides:

toString in class java.lang.Object