com.tencent.kona.sun.security.x509

Class DistributionPoint

java.lang.Object

com.tencent.kona.sun.security.x509.DistributionPoint

All Implemented Interfaces:

com.tencent.kona.sun.security.util.DerEncoder

public class DistributionPoint
extends java.lang.Object
implements com.tencent.kona.sun.security.util.DerEncoder

Represent the DistributionPoint sequence used in the CRL Distribution Points Extension (OID = 2.5.29.31).

The ASN.1 definition for this is:

 DistributionPoint ::= SEQUENCE {
      distributionPoint       [0]     DistributionPointName OPTIONAL,
      reasons                 [1]     ReasonFlags OPTIONAL,
      cRLIssuer               [2]     GeneralNames OPTIONAL }

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

 ReasonFlags ::= BIT STRING {
      unused                  (0),
      keyCompromise           (1),
      cACompromise            (2),
      affiliationChanged      (3),
      superseded              (4),
      cessationOfOperation    (5),
      certificateHold         (6),
      privilegeWithdrawn      (7),
      aACompromise            (8) }

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

See Also:

CRLDistributionPointsExtension

Field Summary

Fields

Modifier and Type	Field and Description
static int	AA_COMPROMISE
static int	AFFILIATION_CHANGED
static int	CA_COMPROMISE
static int	CERTIFICATE_HOLD
static int	CESSATION_OF_OPERATION
static int	KEY_COMPROMISE
static int	PRIVILEGE_WITHDRAWN
static int	SUPERSEDED

Constructor Summary

Constructors

Constructor and Description
DistributionPoint(com.tencent.kona.sun.security.util.DerValue val) Create the object from the passed DER encoded form.
DistributionPoint(GeneralNames fullName, boolean[] reasonFlags, GeneralNames crlIssuer) Constructor for the class using GeneralNames for DistributionPointName
DistributionPoint(RDN relativeName, boolean[] reasonFlags, GeneralNames crlIssuer) Constructor for the class using RelativeDistinguishedName for DistributionPointName

Method Summary

Modifier and Type	Method and Description
void	encode(com.tencent.kona.sun.security.util.DerOutputStream out) Write the DistributionPoint value to the DerOutputStream.
boolean	equals(java.lang.Object obj) Compare an object to this DistributionPoint for equality.
GeneralNames	getCRLIssuer() Return the CRL issuer name or null if not set.
GeneralNames	getFullName() Return the full distribution point name or null if not set.
boolean[]	getReasonFlags() Return the reason flags or null if not set.
RDN	getRelativeName() Return the relative distribution point name or null if not set.
int	hashCode()
java.lang.String	toString() Return a printable string of the Distribution Point.

Methods inherited from class java.lang.Object

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

Field Detail

KEY_COMPROMISE

public static final int KEY_COMPROMISE

See Also:

Constant Field Values

CA_COMPROMISE

public static final int CA_COMPROMISE

See Also:

Constant Field Values

AFFILIATION_CHANGED

public static final int AFFILIATION_CHANGED

See Also:

Constant Field Values

SUPERSEDED

public static final int SUPERSEDED

See Also:

Constant Field Values

CESSATION_OF_OPERATION

public static final int CESSATION_OF_OPERATION

See Also:

Constant Field Values

CERTIFICATE_HOLD

public static final int CERTIFICATE_HOLD

See Also:

Constant Field Values

PRIVILEGE_WITHDRAWN

public static final int PRIVILEGE_WITHDRAWN

See Also:

Constant Field Values

AA_COMPROMISE

public static final int AA_COMPROMISE

See Also:

Constant Field Values

Constructor Detail

DistributionPoint

public DistributionPoint(GeneralNames fullName,
                         boolean[] reasonFlags,
                         GeneralNames crlIssuer)

Constructor for the class using GeneralNames for DistributionPointName

Parameters:

fullName - the GeneralNames of the distribution point; may be null

reasonFlags - the CRL reasons included in the CRL at this distribution point; may be null

crlIssuer - the name(s) of the CRL issuer for the CRL at this distribution point; may be null

DistributionPoint

public DistributionPoint(RDN relativeName,
                         boolean[] reasonFlags,
                         GeneralNames crlIssuer)

Constructor for the class using RelativeDistinguishedName for DistributionPointName

Parameters:

relativeName - the RelativeDistinguishedName of the distribution point; may not be null

reasonFlags - the CRL reasons included in the CRL at this distribution point; may be null

crlIssuer - the name(s) of the CRL issuer for the CRL at this distribution point; may not be null or empty.

DistributionPoint

public DistributionPoint(com.tencent.kona.sun.security.util.DerValue val)
                  throws java.io.IOException

Create the object from the passed DER encoded form.

Parameters:

val - the DER encoded form of the DistributionPoint

Throws:

java.io.IOException - on error

Method Detail

getFullName

public GeneralNames getFullName()

Return the full distribution point name or null if not set.

getRelativeName

public RDN getRelativeName()

Return the relative distribution point name or null if not set.

getReasonFlags

public boolean[] getReasonFlags()

Return the reason flags or null if not set.

getCRLIssuer

public GeneralNames getCRLIssuer()

Return the CRL issuer name or null if not set.

encode

public void encode(com.tencent.kona.sun.security.util.DerOutputStream out)

Write the DistributionPoint value to the DerOutputStream.

Specified by:

encode in interface com.tencent.kona.sun.security.util.DerEncoder

Parameters:

out - the DerOutputStream to write the extension to.

equals

public boolean equals(java.lang.Object obj)

Compare an object to this DistributionPoint 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()

Overrides:

hashCode in class java.lang.Object

toString

public java.lang.String toString()

Return a printable string of the Distribution Point.

Overrides:

toString in class java.lang.Object