sun.security.x509

Class CertificateIssuerExtension

java.lang.Object

sun.security.x509.Extension

sun.security.x509.CertificateIssuerExtension

All Implemented Interfaces:

CertAttrSet<java.lang.String>

public class CertificateIssuerExtension
extends Extension
implements CertAttrSet<java.lang.String>

Represents the CRL Certificate Issuer Extension (OID = 2.5.29.29).

The CRL certificate issuer extension identifies the certificate issuer associated with an entry in an indirect CRL, i.e. a CRL that has the indirectCRL indicator set in its issuing distribution point extension. If this extension is not present on the first entry in an indirect CRL, the certificate issuer defaults to the CRL issuer. On subsequent entries in an indirect CRL, if this extension is not present, the certificate issuer for the entry is the same as that for the preceding entry.

If used by conforming CRL issuers, this extension is always critical. If an implementation ignored this extension it could not correctly attribute CRL entries to certificates. PKIX (RFC 3280) RECOMMENDS that implementations recognize this extension.

The ASN.1 definition for this is:

 id-ce-certificateIssuer   OBJECT IDENTIFIER ::= { id-ce 29 }

 certificateIssuer ::=     GeneralNames
 

Since:

1.5

Author:

Anne Anderson, Sean Mullan

See Also:

Extension, CertAttrSet

Field Summary

Fields

Modifier and Type	Field and Description
static java.lang.String	ISSUER
static java.lang.String	NAME Attribute names.

Fields inherited from class sun.security.x509.Extension

critical, extensionId, extensionValue

Constructor Summary

Constructors

Constructor and Description
CertificateIssuerExtension(java.lang.Boolean critical, java.lang.Object value) Create a CertificateIssuerExtension from the specified DER encoded value of the same.
CertificateIssuerExtension(GeneralNames issuer) Create a CertificateIssuerExtension containing the specified issuer name.

Method Summary

Methods

Modifier and Type	Method and Description
void	delete(java.lang.String name) Deletes the attribute value.
void	encode(java.io.OutputStream out) Write the extension to the OutputStream.
java.lang.Object	get(java.lang.String name) Gets the attribute value.
java.util.Enumeration<java.lang.String>	getElements() Return an enumeration of names of attributes existing within this attribute.
java.lang.String	getName() Return the name of this attribute.
void	set(java.lang.String name, java.lang.Object obj) Set the attribute value.
java.lang.String	toString() Returns a printable representation of the certificate issuer.

Methods inherited from class sun.security.x509.Extension

encode, equals, getExtensionId, getExtensionValue, hashCode, isCritical

Methods inherited from class java.lang.Object

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

Field Detail

NAME

public static final java.lang.String NAME

Attribute names.

See Also:

Constant Field Values

ISSUER

public static final java.lang.String ISSUER

See Also:

Constant Field Values

Constructor Detail

CertificateIssuerExtension

public CertificateIssuerExtension(GeneralNames issuer)
                           throws java.io.IOException

Create a CertificateIssuerExtension containing the specified issuer name. Criticality is automatically set to true.

Parameters:

issuer - the certificate issuer

Throws:

java.io.IOException - on error

CertificateIssuerExtension

public CertificateIssuerExtension(java.lang.Boolean critical,
                          java.lang.Object value)
                           throws java.io.IOException

Create a CertificateIssuerExtension from the specified DER encoded value of the same.

Parameters:

critical - true if the extension is to be treated as critical.

value - an array of DER encoded bytes of the actual value

Throws:

java.lang.ClassCastException - if value is not an array of bytes

java.io.IOException - on error

Method Detail

set

public void set(java.lang.String name,
       java.lang.Object obj)
         throws java.io.IOException

Set the attribute value.

Specified by:

set in interface CertAttrSet<java.lang.String>

Parameters:

name - the name of the attribute (e.g. "x509.info.key")

obj - the attribute object.

Throws:

java.io.IOException - on error

get

public java.lang.Object get(java.lang.String name)
                     throws java.io.IOException

Gets the attribute value.

Specified by:

get in interface CertAttrSet<java.lang.String>

Parameters:

name - the name of the attribute to return.

Throws:

java.io.IOException - on error

delete

public void delete(java.lang.String name)
            throws java.io.IOException

Deletes the attribute value.

Specified by:

delete in interface CertAttrSet<java.lang.String>

Parameters:

name - the name of the attribute to delete.

Throws:

java.io.IOException - on error

toString

public java.lang.String toString()

Returns a printable representation of the certificate issuer.

Specified by:

toString in interface CertAttrSet<java.lang.String>

Overrides:

toString in class Extension

Returns:

value of this certificate attribute in printable form.

encode

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

Write the extension to the OutputStream.

Specified by:

encode in interface CertAttrSet<java.lang.String>

Parameters:

out - the OutputStream to write the extension to

Throws:

java.io.IOException - on encoding errors

getElements

public java.util.Enumeration<java.lang.String> getElements()

Return an enumeration of names of attributes existing within this attribute.

Specified by:

getElements in interface CertAttrSet<java.lang.String>

Returns:

an enumeration of the attribute names.

getName

public java.lang.String getName()

Return the name of this attribute.

Specified by:

getName in interface CertAttrSet<java.lang.String>

Returns:

the name of this CertAttrSet.