sun.security.x509
Class SubjectKeyIdentifierExtension

java.lang.Object
  sun.security.x509.Extension
      sun.security.x509.SubjectKeyIdentifierExtension

All Implemented Interfaces:

CertAttrSet

public class SubjectKeyIdentifierExtension
extends Extension
implements CertAttrSet

Represent the Subject Key Identifier Extension. This extension, if present, provides a means of identifying the particular public key used in an application. This extension by default is marked non-critical.

Extensions are addiitonal attributes which can be inserted in a X509 v3 certificate. For example a "Driving License Certificate" could have the driving license number as a extension.

Extensions are represented as a sequence of the extension identifier (Object Identifier), a boolean flag stating whether the extension is to be treated as being critical and the extension value itself (this is again a DER encoding of the extension value).

See Also:

Extension, CertAttrSet

Field Summary

static String	IDENT Identifier for this attribute, to be used with the get, set, delete methods of Certificate, x509 type.
static String	KEY_ID
static String	NAME Attribute names.

Fields inherited from class sun.security.x509.Extension

critical, extensionId, extensionValue

Constructor Summary

SubjectKeyIdentifierExtension(Boolean critical, Object value)
Create the extension from the passed DER encoded value.

SubjectKeyIdentifierExtension(byte[] octetString)
Create a SubjectKeyIdentifierExtension with the passed octet string.

Method Summary

void	decode(InputStream in) Decode the extension from the InputStream.
void	delete(String name) Delete the attribute value.
void	encode(OutputStream out) Write the extension to the OutputStream.
Object	get(String name) Get the attribute value.
Enumeration	getElements() Return an enumeration of names of attributes existing within this attribute.
String	getName() Return the name of this attribute.
void	set(String name, Object obj) Set the attribute value.
String	toString() Returns a printable representation.

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

IDENT

public static final 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 String NAME

Attribute names.

See Also:

Constant Field Values

KEY_ID

public static final String KEY_ID

See Also:

Constant Field Values

Constructor Detail

SubjectKeyIdentifierExtension

public SubjectKeyIdentifierExtension(byte[] octetString)
                              throws IOException

Create a SubjectKeyIdentifierExtension with the passed octet string. The criticality is set to False.

Parameters:

octetString - the octet string identifying the key identifier.

Throws:

IOException

SubjectKeyIdentifierExtension

public SubjectKeyIdentifierExtension(Boolean critical,
                                     Object value)
                              throws IOException

Create the extension from the passed DER encoded value.

Parameters:

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

value - Array of DER encoded bytes of the actual value.

Throws:

IOException - on error.

Method Detail

toString

public String toString()

Returns a printable representation.

Specified by:

toString in interface CertAttrSet

Overrides:

toString in class Extension

Returns:

a string representation of the object.

encode

public void encode(OutputStream out)
            throws IOException

Write the extension to the OutputStream.

Specified by:

encode in interface CertAttrSet

Parameters:

out - the OutputStream to write the extension to.

Throws:

IOException - on encoding errors.

decode

public void decode(InputStream in)
            throws IOException

Decode the extension from the InputStream.

Specified by:

decode in interface CertAttrSet

Parameters:

in - the InputStream to unmarshal the contents from.

Throws:

IOException - on decoding or validity errors.

set

public void set(String name,
                Object obj)
         throws IOException

Set the attribute value.

Specified by:

set in interface CertAttrSet

Parameters:

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

obj - the attribute object.

Throws:

IOException - on other errors.

get

public Object get(String name)
           throws IOException

Get the attribute value.

Specified by:

get in interface CertAttrSet

Parameters:

name - the name of the attribute to return.

Throws:

IOException - on other errors.

delete

public void delete(String name)
            throws IOException

Delete the attribute value.

Specified by:

delete in interface CertAttrSet

Parameters:

name - the name of the attribute to delete.

Throws:

IOException - on other errors.

getElements

public Enumeration getElements()

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

Specified by:

getElements in interface CertAttrSet

Returns:

an enumeration of the attribute names.

getName

public String getName()

Return the name of this attribute.

Specified by:

getName in interface CertAttrSet

Returns:

the name of this CertAttrSet.