QCStatement ("Entrust Authority Security Toolkit for the Java Platform")

java.lang.Object
- iaik.x509.extensions.qualified.structures.QCStatement

All Implemented Interfaces:

ASN1Type
```
public class QCStatement
extends java.lang.Object
implements ASN1Type
```
This class implements the QCStatement type.
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 identifer (statement ID):
```
 QCStatement ::= SEQUENCE {
   statementId OBJECT IDENTIFIER,
   statementInfo ANY DEFINED BY statementId OPTIONAL }
 
```
This class includes a static part to be used for registering implementations for particular (private) statement infos. A statement info may be implemented by extending the abstract QCStatementInfo class and registering it by calling the static register method, e.g.:
```
 public class MyQCStatementInfo extends QCStatementInfo {
 ...
 // the statement id:
   public static final ObjectID statementID = ...;
 ...
 }
 ...
 // register the implementation:
 QCStatement.register(MyQCStatementInfo.statementID, MyQCStatementInfo.class);
 
```
The Qualified Certificate Profile currently defines one statement info which already is implemented and registered:
- SemanticsInformation
For any desired QCStatementInfo to be included into a qualified certificate create a QCStatement object and subsequently add the QCStatement objects to a QCStatements certificate extension. The following example creates a QCStatement for a SemanticsInformation statement info and adds it to a QCStatements extension:
```
 ObjectID semanticsIdentifier = ...;
 GeneralName[] nameRegistrationAuthorities = ...;
 // create the SemanticsInformation:
 SemanticsInformation semanticsInformation =
   new SemanticsInformation(semanticsIdentifier, nameRegistrationAuthorities);
 // create a QCStatement for the SemanticsInformation:
 QCStatement[] qcStatements = ...;
 qcStatements[0] = new QCStatement(semanticsInformation);
 // add any further QCStatements
 ...
 // Create a QCStatements extension from the QCStatements:
 QCStatements qcStatementsExt = new QCStatements(qcStatements);
 
```
For adding a QCStatements extension object to a QualifiedCertificate, use the addExtension or setQCStatements method of the QualifiedCertificate class:
```
 QualifiedCertificate cert = new QualifiedCertificate();
   ...
 cert.setQCStatements(qcStatementsExt);
 
```
See Also:

QCStatementInfo, QCStatements

Constructor Summary

Constructors
Constructor and Description
`QCStatement()` Default Constructor.
`QCStatement(ObjectID statementID)` Creates an QCStatement for the supplied statement ID.
`QCStatement(QCStatementInfo statementInfo)` Creates an QCStatement from the supplied statementInfo.

Method Summary

All Methods Static Methods Instance Methods Concrete Methods
Modifier and Type	Method and Description
`static QCStatementInfo`	`create(ObjectID statementID)` Returns the implementation of the specified statement info defined through an ASN.1 ObjectID.
`void`	`decode(ASN1Object obj)` Decodes an QCStatement from its ASN.1 representation.
`ObjectID`	`getStatementID()` Gets the statementID of this QCStatement.
`QCStatementInfo`	`getStatementInfo()` Gets the statementInfo of this QCStatement.
`static void`	`register(ObjectID statementID, java.lang.Class cl)` Registers a class for implementing a particular statement info.
`ASN1Object`	`toASN1Object()` Returns this QCStatement as ASN1Object.
`java.lang.String`	`toString()` Returns a String representation of the QCStatement.

Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait

- Constructor Detail
  - QCStatement
```
public QCStatement()
```
    Default Constructor. Creates an empty QCStatement object. This constructor only is used for dynamic object creation and shall not be used by an application.
  - QCStatement
```
public QCStatement(ObjectID statementID)
```
    Creates an QCStatement for the supplied statement ID. This constructor may be used for creating a QCStatement having no statement info.
    
    Parameters:
    
    statementID - the statementID of this QCStatement
  - QCStatement
```
public QCStatement(QCStatementInfo statementInfo)
```
    Creates an QCStatement from the supplied statementInfo. The statement id is obtained from the supplied statement info.
    
    Parameters:
    
    statementInfo - the statementInfo of this QCStatement
- Method Detail
  - create
```
public static QCStatementInfo create(ObjectID statementID)
                              throws java.lang.InstantiationException
```
    Returns the implementation of the specified statement info defined through an ASN.1 ObjectID.
    This method belongs to the static part of this class.
    
    Parameters:
    
    statementID - the ObjectID of the statement info.
    
    Returns:
    
    the implementation of the statement info with this statementID
    
    Throws:
    
    java.lang.InstantiationException - if the internal factory couldn't create an instance of requested type
  - register
```
public static void register(ObjectID statementID,
                            java.lang.Class cl)
```
    Registers a class for implementing a particular statement info.
    This method belongs to the static part of this class.
    
    Parameters:
    
    statementID - the statementID of the statement info to be registered
    
    cl - the class which implements this statement info
  - getStatementInfo
```
public QCStatementInfo getStatementInfo()
```
    Gets the statementInfo of this QCStatement.
    
    Returns:
    
    the statementInfo of this QCStatement
  - getStatementID
```
public ObjectID getStatementID()
```
    Gets the statementID of this QCStatement.
    
    Returns:
    
    the statementID of this QCStatement
  - decode
```
public void decode(ASN1Object obj)
            throws CodingException
```
    Decodes an QCStatement from its ASN.1 representation. This method parses the statement id from the supplied ASN.1 representation and tries -- if a statement info is included -- to find an registered statement info implementation for the parsed statement ID. If no statement info implementation can be found, a UnknownQCStatementInfo object is created for the unknown statement info allowing to query for information about the statement info.
    
    Specified by:
    
    decode in interface ASN1Type
    
    Parameters:
    
    obj - the QCStatement as ASN1Object
    
    Throws:
    
    CodingException - if the ASN1Object cannot be parsed
  - toASN1Object
```
public ASN1Object toASN1Object()
                        throws CodingException
```
    Returns this QCStatement as ASN1Object.
    
    Specified by:
    
    toASN1Object in interface ASN1Type
    
    Returns:
    
    this QCStatement as ASN1Object.
    
    Throws:
    
    CodingException - if the QCStatement cannot be represented as ASN1Object
  - toString
```
public java.lang.String toString()
```
    Returns a String representation of the QCStatement.
    
    Overrides:
    
    toString in class java.lang.Object
    
    Returns:
    
    a String representation of the QCStatement.

Class QCStatement

Constructor Summary

Method Summary

Methods inherited from class java.lang.Object

Constructor Detail

QCStatement

QCStatement

QCStatement

Method Detail

create

register

getStatementInfo

getStatementID

decode

toASN1Object

toString