All Packages  Class Hierarchy  This Package  Previous  Next  Index

Class netscape.security.x509.Extension

netscape.security.x509.Extension

public class Extension
Represent a X509 Extension Attribute.

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

 ASN.1 definition of Extension:
 Extension ::= SEQUENCE {
	ExtensionId	OBJECT IDENTIFIER,
	critical	BOOLEAN DEFAULT FALSE,
	extensionValue	OCTET STRING
 }
 


Variable Index

 o critical
 o extensionId
 o extensionValue

Constructor Index

 o Extension()
Default constructor.
 o Extension(DerValue)
Constructs an extension from a DER encoded array of bytes.
 o Extension(Extension)
Constructs an Extension from another extension.
 o Extension(ObjectIdentifier, boolean, byte[])
Constructs an Extension from individual components of ObjectIdentifier, criticality and the DER encoded OctetString.

Method Index

 o encode(DerOutputStream)
Write the extension to the DerOutputStream.
 o getExtensionId()
Returns the ObjectIdentifier of the extension.
 o getExtensionValue()
Returns the extension value as an byte array for further processing.
 o isCritical()
Returns true if extension is critical.
 o toString()
Returns the Extension in user readable form.

Variables

 o extensionId
 protected ObjectIdentifier extensionId
 o critical
 protected boolean critical
 o extensionValue
 protected byte extensionValue[]

Constructors

 o Extension
 public Extension()
Default constructor. Used only by sub-classes.

 o Extension
 public Extension(DerValue derVal) throws IOException
Constructs an extension from a DER encoded array of bytes.

 o Extension
 public Extension(ObjectIdentifier extensionId,
                  boolean critical,
                  byte extensionValue[]) throws IOException
Constructs an Extension from individual components of ObjectIdentifier, criticality and the DER encoded OctetString.

Parameters:
extensionId - the ObjectIdentifier of the extension
critical - the boolean indicating if the extension is critical
extensionValue - the DER encoded octet string of the value.
 o Extension
 public Extension(Extension ext)
Constructs an Extension from another extension. To be used for creating decoded subclasses.

Parameters:
ext - the extension to create from.

Methods

 o encode
 public void encode(DerOutputStream out) throws IOException
Write the extension to the DerOutputStream.

Parameters:
out - the DerOutputStream to write the extension to.
Throws: IOException
on encoding errors
 o isCritical
 public boolean isCritical()
Returns true if extension is critical.

 o getExtensionId
 public ObjectIdentifier getExtensionId()
Returns the ObjectIdentifier of the extension.

 o getExtensionValue
 public byte[] getExtensionValue()
Returns the extension value as an byte array for further processing. Note, this is the raw DER value of the extension, not the DER encoded octet string which is in the certificate.

 o toString
 public String toString()
Returns the Extension in user readable form.


All Packages  Class Hierarchy  This Package  Previous  Next  Index