org.apache.harmony.security.x509

Class Extension

java.lang.Object

org.apache.harmony.security.x509.Extension

All Implemented Interfaces:

Extension

public final class Extension
extends Object
implements Extension

The class encapsulates the ASN.1 DER encoding/decoding work with the Extension part of X.509 certificate (as specified in RFC 3280 - Internet X.509 Public Key Infrastructure. Certificate and Certificate Revocation List (CRL) Profile. http://www.ietf.org/rfc/rfc3280.txt):

  Extension  ::=  SEQUENCE  {
       extnID      OBJECT IDENTIFIER,
       critical    BOOLEAN DEFAULT FALSE,
       extnValue   OCTET STRING
  }
 

Field Summary

Fields

Modifier and Type	Field and Description
static ASN1Sequence	ASN1 X.509 Extension encoder/decoder.
static boolean	CRITICAL
protected ExtensionValue	extnValueObject
static boolean	NON_CRITICAL

Constructor Summary

Constructors

Constructor and Description
Extension(int[] extnID, boolean critical, byte[] extnValue)
Extension(int[] extnID, byte[] extnValue)
Extension(String extnID, boolean critical, byte[] extnValue)
Extension(String extnID, boolean critical, ExtensionValue extnValueObject)
Extension(String extnID, byte[] extnValue)

Method Summary

Modifier and Type	Method and Description
void	dumpValue(StringBuilder sb, String prefix)
void	encode(OutputStream out) Writes the DER-encoded extension to out.
boolean	equals(Object ext) Compares this instance with the specified object and indicates if they are equal.
BasicConstraints	getBasicConstraintsValue()
ExtensionValue	getDecodedExtensionValue()
byte[]	getEncoded() Returns ASN.1 encoded form of this X.509 Extension value.
String	getId() Returns the value of extnID field of the structure.
KeyUsage	getKeyUsageValue()
byte[]	getRawExtnValue() Returns the raw (undecoded octet string) value of extnValue field of the structure.
byte[]	getValue() Returns the value of extnValue field of the structure.
int	hashCode() Returns an integer hash code for this object.
boolean	isCritical() Returns the value of critical field of the structure.

Methods inherited from class java.lang.Object

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

Field Detail

CRITICAL

public static final boolean CRITICAL

See Also:

Constant Field Values

NON_CRITICAL

public static final boolean NON_CRITICAL

See Also:

Constant Field Values

extnValueObject

protected ExtensionValue extnValueObject

ASN1

public static final ASN1Sequence ASN1

X.509 Extension encoder/decoder.

Constructor Detail

Extension

public Extension(String extnID,
                 boolean critical,
                 ExtensionValue extnValueObject)

Extension

public Extension(String extnID,
                 boolean critical,
                 byte[] extnValue)

Extension

public Extension(int[] extnID,
                 boolean critical,
                 byte[] extnValue)

Extension

public Extension(String extnID,
                 byte[] extnValue)

Extension

public Extension(int[] extnID,
                 byte[] extnValue)

Method Detail

getId

public String getId()

Returns the value of extnID field of the structure.

Specified by:

getId in interface Extension

isCritical

public boolean isCritical()

Returns the value of critical field of the structure.

Specified by:

isCritical in interface Extension

getValue

public byte[] getValue()

Returns the value of extnValue field of the structure.

Specified by:

getValue in interface Extension

getRawExtnValue

public byte[] getRawExtnValue()

Returns the raw (undecoded octet string) value of extnValue field of the structure.

getEncoded

public byte[] getEncoded()

Returns ASN.1 encoded form of this X.509 Extension value.

encode

public void encode(OutputStream out)
            throws IOException

Description copied from interface: Extension

Writes the DER-encoded extension to out.

Specified by:

encode in interface Extension

Throws:

IOException - when there is an encoding error or error writing to out

equals

public boolean equals(Object ext)

Description copied from class: Object

Compares this instance with the specified object and indicates if they are equal. In order to be equal, o must represent the same object as this instance using a class-specific comparison. The general contract is that this comparison should be reflexive, symmetric, and transitive. Also, no object reference other than null is equal to null.

The default implementation returns true only if this == o. See Writing a correct equals method if you intend implementing your own equals method.

The general contract for the equals and Object.hashCode() methods is that if equals returns true for any two objects, then hashCode() must return the same value for these objects. This means that subclasses of Object usually override either both methods or neither of them.

Overrides:

equals in class Object

Parameters:

ext - the object to compare this instance with.

Returns:

true if the specified object is equal to this Object; false otherwise.

See Also:

Object.hashCode()

hashCode

public int hashCode()

Description copied from class: Object

Returns an integer hash code for this object. By contract, any two objects for which Object.equals(java.lang.Object) returns true must return the same hash code value. This means that subclasses of Object usually override both methods or neither method.

Note that hash values must not change over time unless information used in equals comparisons also changes.

See Writing a correct hashCode method if you intend implementing your own hashCode method.

Overrides:

hashCode in class Object

Returns:

this object's hash code.

See Also:

Object.equals(java.lang.Object)

getDecodedExtensionValue

public ExtensionValue getDecodedExtensionValue()
                                        throws IOException

Throws:

IOException

getKeyUsageValue

public KeyUsage getKeyUsageValue()

getBasicConstraintsValue

public BasicConstraints getBasicConstraintsValue()

dumpValue

public void dumpValue(StringBuilder sb,
                      String prefix)