iaik.x509.extensions.qualified.structures

Class QCStatementInfo

java.lang.Object

iaik.x509.extensions.qualified.structures.QCStatementInfo

Direct Known Subclasses:

QcEuCompliance, QcEuLimitValue, QcEuPDS, QcEuRetentionPeriod, QcEuSSCD, QcType, SemanticsInformation, UnknownQCStatementInfo

public abstract class QCStatementInfo
extends java.lang.Object

This class is the basic implementation for QC statement infos. Any class which implements a QC statement info must be derived from this class.

The PKIX Qualified Certificate Profile specifies the Qualified Certificate Statements (QCStatements) extension for including defined statements related to Qualified Certificates. The QCStatements extension simply consists of a ASN.1 SEQUENCE of QC statements:

 QCStatements ::= SEQUENCE OF QCStatement
 

Each QC statement itself consists of an object identifier and an optional statement info identified by the object identifier (statement ID):

 QCStatement ::= SEQUENCE {
   statementId OBJECT IDENTIFIER,
   statementInfo ANY DEFINED BY statementId OPTIONAL }
 

Any class implementing a particular statement info has to extend this class and therefore has to implement the abstract methods decode, toASN1Object and getStatementID. The statement ID to be returned by method getStatementID is the one identifying the particular statement info and shall be used for registering the corresponding class as implementation for this statement info, e.g.:

 public class MyQCStatementInfo extends QCStatementInfo {
 ...
 // the statement id:
   public static final ObjectID statementID = ...;
 ...
 }
 ...
 // register the implementation:
 QCStatement.register(MyQCStatementInfo.statementID, MyQCStatementInfo.class);
 

Note that the statementID used for registering a statementInfo implementing class belongs to the QCStatement for which the statementInfo is used. For instance, the Qualified Certificate Profile currently defines one statement info, SemanticsInformation, to may be used for the QCSyntaxV1 and QCSyntaxV2 QC statements.

When implementing a statement info by extending this class please be aware that methods toASN1Object and decode only have to convert the statement info itself (and NOT the statementID) into respectively from an ASN1Object.

Version:

File Revision 15

See Also:

QCStatement, QCStatements

Constructor Summary

Constructors

Constructor and Description
QCStatementInfo()

Method Summary

Methods

Modifier and Type	Method and Description
abstract void	decode(ASN1Object obj) Decodes a statement info from its ASN.1 representation.
java.lang.String	getName() Returns the name of the statement info.
abstract ObjectID	getStatementID() Returns the statement ID identifying this statement info.
abstract ASN1Object	toASN1Object() Returns an ASN.1 representation of a particular statement info.
abstract java.lang.String	toString() Returns a String representation of the QCStatementInfo.

Methods inherited from class java.lang.Object

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

Constructor Detail

QCStatementInfo

public QCStatementInfo()

Method Detail

decode

public abstract void decode(ASN1Object obj)
                     throws CodingException

Decodes a statement info from its ASN.1 representation. This method is used by the QCStatement class when parsing the ASN.1 representation of a statement info. This method only expects the ASN.1 representation of the statement info, but not the corresponding statement ID. This method shall not be explicitly called by an application.

Parameters:

obj - the statement info as ASN1Object

Throws:

CodingException - if the ASN1Object cannot be parsed

toASN1Object

public abstract ASN1Object toASN1Object()
                                 throws CodingException

Returns an ASN.1 representation of a particular statement info.

The ASN1Object returned by this method only represents the statement info but does not include the corresponding statement id.

Returns:

the statement info as ASN1Object

Throws:

CodingException - if the statement info cannot be represented as ASN.1 object

getStatementID

public abstract ObjectID getStatementID()

Returns the statement ID identifying this statement info.

Returns:

the statement ID identifying the statement info this class implements

toString

public abstract java.lang.String toString()

Returns a String representation of the QCStatementInfo.

Overrides:

toString in class java.lang.Object

Returns:

a String representation of the QCStatementInfo.

getName

public java.lang.String getName()

Returns the name of the statement info.

Returns:

the name of the statement info