APIdia Launch Partner
Top Description Fields Constructors Methods
sun.security.x509

public Class CertificateIssuerExtension

extends Extension
Class Inheritance
Imports
java.io.IOException, sun.security.util.DerValue, .DerOutputStream

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 5280) RECOMMENDS that implementations recognize this extension.

The ASN.1 definition for this is:

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

certificateIssuer ::=     GeneralNames
Authors
Anne Anderson, Sean Mullan
Since
1.5
See Also
Extension

Field Summary

Modifier and TypeField and Description
public static final String
private GeneralNames
Inherited from sun.security.x509.Extension:
criticalextensionIdextensionValue

Constructor Summary

AccessConstructor and Description
public
CertificateIssuerExtension(GeneralNames
the certificate issuer, cannot be null or empty.
issuer
)

Create a CertificateIssuerExtension containing the specified issuer name.

public
CertificateIssuerExtension(Boolean
true if the extension is to be treated as critical.
critical
,
Object
an array of DER encoded bytes of the actual value
value
)

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

Method Summary

Modifier and TypeMethod and Description
public void
encode(DerOutputStream
the DerOutputStream to write the extension to
out
)

Overrides sun.security.x509.Extension.encode.

Implements sun.security.util.DerEncoder.encode.

Write the extension to the OutputStream.

private void
encodeThis()

Encode this extension

public String
getName()

Overrides sun.security.x509.Extension.getName.

Return the name of this extension.

public GeneralNames
public String
toString()

Overrides sun.security.x509.Extension.toString.

Returns a printable representation of the certificate issuer.

Inherited from sun.security.x509.Extension:
encodeequalsgetExtensionIdgetExtensionValuegetIdgetValuehashCodeisCriticalnewExtension

Field Detail

NAMEback to summary
public static final String NAME
namesback to summary
private GeneralNames names

Constructor Detail

CertificateIssuerExtensionback to summary
public CertificateIssuerExtension(GeneralNames issuer)

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

Parameters
issuer:GeneralNames

the certificate issuer, cannot be null or empty.

CertificateIssuerExtensionback to summary
public CertificateIssuerExtension(Boolean critical, Object value) throws IOException

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

Parameters
critical:Boolean

true if the extension is to be treated as critical.

value:Object

an array of DER encoded bytes of the actual value

Exceptions
IOException:
on error
ClassCastException:
if value is not an array of bytes

Method Detail

encodeback to summary
public void encode(DerOutputStream out)

Overrides sun.security.x509.Extension.encode.

Implements sun.security.util.DerEncoder.encode.

Write the extension to the OutputStream.

Parameters
out:DerOutputStream

the DerOutputStream to write the extension to

Annotations
@Override
encodeThisback to summary
private void encodeThis()

Encode this extension

getNameback to summary
public String getName()

Overrides sun.security.x509.Extension.getName.

Return the name of this extension.

Annotations
@Override
getNamesback to summary
public GeneralNames getNames()
toStringback to summary
public String toString()

Overrides sun.security.x509.Extension.toString.

Returns a printable representation of the certificate issuer.