com.entrust.toolkit.asn1.structures

Class DistributionPointName

java.lang.Object

com.entrust.toolkit.asn1.structures.DistributionPointName

Deprecated.

As of version 7.0, there should be no need to use this class. Note that its behaviour is probably not what is expected when the choice of distribution point name is nameRelativeToCRLIssuer.

public class DistributionPointName
extends java.lang.Object

This class implements the DistributionPointName as used by the CRLDistributionPoints extension.

The DistributionPointName structure is defined as:

  DistributionPointName ::= CHOICE {
      fullName                [0] GeneralNames,
      nameRelativeToCRLIssuer [1] RelativeDistinguishedName }
  

The fullName field is a GeneralNames structure, and the nameRelativeToCRLIssuer field is a Name structure. Refer to the corresponding documentation for details on these structures.

Standard set and get methods are provided for each field.

Version:

1.0

See Also:

CRLDistributionPoints, Name, GeneralNames

Constructor Summary

Constructors

Constructor and Description
DistributionPointName() Deprecated. Creates a new (empty) DistributionPointName object.
DistributionPointName(ASN1Object obj) Deprecated. Constructs a DistributionPointName from an ASN1Object.
DistributionPointName(ASN1Type asn1Type) Deprecated. Creates a new DistributionPointName object from a distribution point name.

Method Summary

Methods

Modifier and Type	Method and Description
Name	getDirectoryName(Name parent) Deprecated. Returns the internal value of this DistributionPointName object as an absolute X.500 distinguished name.
ASN1Type	getDistributionPointName() Deprecated. Returns the distribution point name parameter.
void	setDistributionPointName(ASN1Type dpn) Deprecated. Sets the distribution point name parameter.
ASN1Object	toASN1Object() Deprecated. Returns this DistributionPointName as an ASN1Object.
java.lang.String	toString() Deprecated. Returns a string that represents the contents of this DistributionPointName structure.

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait

Constructor Detail

DistributionPointName

public DistributionPointName()

Deprecated.

Creates a new (empty) DistributionPointName object.

DistributionPointName

public DistributionPointName(ASN1Type asn1Type)

Deprecated.

Creates a new DistributionPointName object from a distribution point name.

Parameters:

asn1Type - the distribution point name

DistributionPointName

public DistributionPointName(ASN1Object obj)
                      throws CodingException

Deprecated.

Constructs a DistributionPointName from an ASN1Object.

The ASN1Object is expected to be a CONTEXT_SPECIFIC structure containing either a GeneralNames object (tagged zero) or a Name object (tagged one). An internal object is constructed as appropriate, based on the tag value. If the ASN1Object is not a CONTEXT_SPECIFIC structure, or the tag has an illegal value, an exception of type CodingException is thrown.

Parameters:

obj - the DistributionPointName as an ASN1Object

Throws:

CodingException - if the ASN1Object is not a DistributionPointName

Method Detail

toASN1Object

public ASN1Object toASN1Object()
                        throws CodingException

Deprecated.

Returns this DistributionPointName as an ASN1Object.

If the internal representation of this DistributionPointName is a GeneralNames object, the CONTEXT_SPECIFIC ASN1Object is tagged as choice zero. If the internal representation is an instance of a Name object, the ASN1Object is tagged as choice one. If neither of these conditions is true, an exception of type CodingException is thrown.

Returns:

this DistributionPointName as an ASN1Object

Throws:

CodingException - if an error occurred while constructing the ASN1Object

setDistributionPointName

public void setDistributionPointName(ASN1Type dpn)
                              throws java.lang.IllegalArgumentException

Deprecated.

Sets the distribution point name parameter.

The ASN1Type argument must be an instance of either a GeneralNames class or a Name class. The GeneralNames type is used to represent an absolute path name, while the Name type is used for relative path names.

Parameters:

dpn - the distribution point name

Throws:

java.lang.IllegalArgumentException - if dpn is neither a GeneralNames nor a Name

See Also:

GeneralNames, Name

getDistributionPointName

public ASN1Type getDistributionPointName()

Deprecated.

Returns the distribution point name parameter.

The internal representation of the distribution point name is returned as an ASN1Type object. The calling application is responsible for testing this value to determine if it is an instance of the GeneralNames class or of the Name class. The calling application should then act accordingly. For example:

  ASN1Type temp = name.getDistributionPointName();
  if (temp instanceof GeneralNames)
      GeneralNames general = (GeneralNames)temp;
  else
      Name name = (Name)temp;
  

Returns:

the name as GeneralNames or as Name

See Also:

GeneralNames, Name

toString

public java.lang.String toString()

Deprecated.

Returns a string that represents the contents of this DistributionPointName structure.

Overrides:

toString in class java.lang.Object

Returns:

the string representation

getDirectoryName

public Name getDirectoryName(Name parent)

Deprecated.

Returns the internal value of this DistributionPointName object as an absolute X.500 distinguished name.

The full DN is the name itself if it is not relative, or the concatenation of the full DN of the CRL issuer and the RDNs of this name. In either case, this method returns the full DN of the distribution point.

Parameters:

parent - the full DN of the CRL issuer; may be null if this distribution point name is not a relative DN

Returns:

the full DN of this distribution point or null if none is set