iaik.x509.extensions

Class ErrorExtension

java.lang.Object

iaik.x509.V3Extension

iaik.x509.extensions.ErrorExtension

public class ErrorExtension
extends V3Extension

This class can be used to show extensions which can not be initialized because of an error.

An ErrorExtension only may be created when calling a listExtensions method that is based on the listExtensions() method of the X509Extensions class for obtaining an enumeration listing all the extensions included in, for instance, some particular certificate. The returned enumeration will contain an ErrorExtension for any extension which cannot be initialized because of some error (the DER encoding of the extension value is wrong, or the implementation is unable to parse the extension value).

An ErrorExtension always will be marked as being critical. It will contain the OID of the appertaining extension and can be queried for a message trying to explain the reason for the error.

Version:

File Revision 14

See Also:

X509Extensions

Field Summary

Fields inherited from class iaik.x509.V3Extension

critical

Constructor Summary

Constructors

Constructor and Description
ErrorExtension(ObjectID objectID, boolean critical, java.lang.String errorMessage) Creates a new broken extension.

Method Summary

Methods

Modifier and Type	Method and Description
ObjectID	getObjectID() Returns the ObjectID of the broken extension.
int	hashCode() Returns a hashcode for this identity.
void	init(ASN1Object obj) Implements the V3Extension Interface.
ASN1Object	toASN1Object() Only throws a X509ExtensionException, since an ErrorExtension only may be used for displaying information about some broken extension.
java.lang.String	toString() Returns a string that represents the contents of this ErrorExtension.

Methods inherited from class iaik.x509.V3Extension

getName, isCritical, setCritical

Methods inherited from class java.lang.Object

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

Constructor Detail

ErrorExtension

public ErrorExtension(ObjectID objectID,
              boolean critical,
              java.lang.String errorMessage)

Creates a new broken extension.

Parameters:

objectID - the ObjectID of the broken extension

critical - whether the broken extension is critical or not

errorMessage - a message describing the reason of the error

Method Detail

toASN1Object

public ASN1Object toASN1Object()
                        throws X509ExtensionException

Only throws a X509ExtensionException, since an ErrorExtension only may be used for displaying information about some broken extension.

Specified by:

toASN1Object in class V3Extension

Returns:

the value of the extension as ASN1Object

Throws:

X509ExtensionException - since an ErrorExtension only may be used for displaying information about some broken extension

init

public void init(ASN1Object obj)

Implements the V3Extension Interface. This method does nothing.

Specified by:

init in class V3Extension

Parameters:

obj - the extension value as ASN1Object

hashCode

public int hashCode()

Returns a hashcode for this identity.

Specified by:

hashCode in class V3Extension

Returns:

a hash code for this identity

getObjectID

public ObjectID getObjectID()

Returns the ObjectID of the broken extension.

Specified by:

getObjectID in class V3Extension

Returns:

the ObjectID of the broken extension

toString

public java.lang.String toString()

Returns a string that represents the contents of this ErrorExtension.

Overrides:

toString in class java.lang.Object

Returns:

the string representation