sun.security.x509

Class CertificateExtensions

java.lang.Object

sun.security.x509.CertificateExtensions

All Implemented Interfaces:

CertAttrSet<Extension>

public class CertificateExtensions
extends java.lang.Object
implements CertAttrSet<Extension>

This class defines the Extensions attribute for the Certificate.

Author:

Amit Kapoor, Hemma Prafullchandra

See Also:

CertAttrSet

Field Summary

Fields

Modifier and Type	Field and Description
static java.lang.String	IDENT Identifier for this attribute, to be used with the get, set, delete methods of Certificate, x509 type.
static java.lang.String	NAME name

Constructor Summary

Constructors

Constructor and Description
CertificateExtensions() Default constructor.
CertificateExtensions(DerInputStream in) Create the object, decoding the values from the passed DER stream.

Method Summary

Methods

Modifier and Type	Method and Description
void	delete(java.lang.String name) Delete the attribute value.
void	encode(java.io.OutputStream out) Encode the extensions in DER form to the stream, setting the context specific tag as needed in the X.509 v3 certificate.
void	encode(java.io.OutputStream out, boolean isCertReq) Encode the extensions in DER form to the stream.
boolean	equals(java.lang.Object other) Compares this CertificateExtensions for equality with the specified object.
java.lang.Object	get(java.lang.String name) Get the attribute value.
java.util.Collection<Extension>	getAllExtensions() Return a collection view of the extensions.
java.util.Enumeration<Extension>	getElements() Return an enumeration of names of attributes existing within this attribute.
java.lang.String	getName() Return the name of this attribute.
java.util.Map<java.lang.String,Extension>	getUnparseableExtensions()
int	hashCode() Returns a hashcode value for this CertificateExtensions.
boolean	hasUnsupportedCriticalExtension() Return true if a critical extension is found that is not supported, otherwise return false.
void	set(java.lang.String name, java.lang.Object obj) Set the attribute value.
java.lang.String	toString() Returns a string representation of this CertificateExtensions object in the form of a set of entries, enclosed in braces and separated by the ASCII characters ", " (comma and space).

Methods inherited from class java.lang.Object

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

Field Detail

IDENT

public static final java.lang.String IDENT

Identifier for this attribute, to be used with the get, set, delete methods of Certificate, x509 type.

See Also:

Constant Field Values

NAME

public static final java.lang.String NAME

name

See Also:

Constant Field Values

Constructor Detail

CertificateExtensions

public CertificateExtensions()

Default constructor.

CertificateExtensions

public CertificateExtensions(DerInputStream in)
                      throws java.io.IOException

Create the object, decoding the values from the passed DER stream.

Parameters:

in - the DerInputStream to read the Extension from.

Throws:

java.io.IOException - on decoding errors.

Method Detail

encode

public void encode(java.io.OutputStream out)
            throws java.security.cert.CertificateException,
                   java.io.IOException

Encode the extensions in DER form to the stream, setting the context specific tag as needed in the X.509 v3 certificate.

Specified by:

encode in interface CertAttrSet<Extension>

Parameters:

out - the DerOutputStream to marshal the contents to.

Throws:

java.security.cert.CertificateException - on encoding errors.

java.io.IOException - on errors.

encode

public void encode(java.io.OutputStream out,
          boolean isCertReq)
            throws java.security.cert.CertificateException,
                   java.io.IOException

Encode the extensions in DER form to the stream.

Parameters:

out - the DerOutputStream to marshal the contents to.

isCertReq - if true then no context specific tag is added.

Throws:

java.security.cert.CertificateException - on encoding errors.

java.io.IOException - on errors.

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<Extension>

Parameters:

name - the extension name used in the cache.

obj - the object to set.

Throws:

java.io.IOException - if the object could not be cached.

get

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

Get the attribute value.

Specified by:

get in interface CertAttrSet<Extension>

Parameters:

name - the extension name used in the lookup.

Throws:

java.io.IOException - if named extension is not found.

delete

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

Delete the attribute value.

Specified by:

delete in interface CertAttrSet<Extension>

Parameters:

name - the extension name used in the lookup.

Throws:

java.io.IOException - if named extension is not found.

getElements

public java.util.Enumeration<Extension> getElements()

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

Specified by:

getElements in interface CertAttrSet<Extension>

Returns:

an enumeration of the attribute names.

getAllExtensions

public java.util.Collection<Extension> getAllExtensions()

Return a collection view of the extensions.

Returns:

a collection view of the extensions in this Certificate.

getUnparseableExtensions

public java.util.Map<java.lang.String,Extension> getUnparseableExtensions()

getName

public java.lang.String getName()

Return the name of this attribute.

Specified by:

getName in interface CertAttrSet<Extension>

Returns:

the name of this CertAttrSet.

hasUnsupportedCriticalExtension

public boolean hasUnsupportedCriticalExtension()

Return true if a critical extension is found that is not supported, otherwise return false.

equals

public boolean equals(java.lang.Object other)

Compares this CertificateExtensions for equality with the specified object. If the other object is an instanceof CertificateExtensions, then all the entries are compared with the entries from this.

Overrides:

equals in class java.lang.Object

Parameters:

other - the object to test for equality with this CertificateExtensions.

Returns:

true iff all the entries match that of the Other, false otherwise.

hashCode

public int hashCode()

Returns a hashcode value for this CertificateExtensions.

Overrides:

hashCode in class java.lang.Object

Returns:

the hashcode value.

toString

public java.lang.String toString()

Returns a string representation of this CertificateExtensions object in the form of a set of entries, enclosed in braces and separated by the ASCII characters ", " (comma and space).

Overrides to toString method of Object.

Specified by:

toString in interface CertAttrSet<Extension>

Overrides:

toString in class java.lang.Object

Returns:

a string representation of this CertificateExtensions.