iaik.x509.extensions.qualified.structures

Class SemanticsInformation

java.lang.Object

iaik.x509.extensions.qualified.structures.QCStatementInfo

iaik.x509.extensions.qualified.structures.SemanticsInformation

Direct Known Subclasses:

QCSyntaxV1, QCSyntaxV2

public class SemanticsInformation
extends QCStatementInfo

This class implements the SemanticsInformation QCStatementInfo.

This statement info indicates conformance with syntax and semantics of a Qualified Certificate Profile. To show conformance to both profiles - RFC3039 and RFC3739 - the two subclasses of SemanticsInformation QCSyntaxV1 and QCSyntaxV2 are used. QCSyntaxV1 indicates implemenation according to RFC3039 and QCSyntaxV2 according to RFC3739. The differ in a specific statement identifier, derived from:

     id-pkix  OBJECT IDENTIFIER  ::=
             { iso(1) identified-organization(3) dod(6) internet(1)
                     security(5) mechanisms(5) pkix(7) }

     id-qcs OBJECT IDENTIFIER  ::=  { id-pkix 11 }

     id-qcs-pkixQCSyntax OBJECT IDENTIFIER ::= { id-qcs x }
 

which corresponds to the OID string "1.3.6.1.5.5.7.11.x", with x being either 1 for QCSyntaxV1 and 2 for QCSyntaxV2.

ASN.1 definition:

 SemanticsInformation ::= SEQUENCE {
   semanticsIdentifier  OBJECT IDENTIFIER   OPTIONAL,
   nameRegistrationAutorities NameRegistrationAutorities OPTIONAL }
 

 NameRegistrationAutorities ::= SEQUENCE SIZE (1..MAX) OF GeneralName
 

Please note that this class is only not abstract because of backwards compatibility. Depending on whether you have to add sematics information to a version 1 or version 2 qc statement, use class QCSyntaxV1 or QCSyntaxV2, respectively.

Version:

File Revision 12

See Also:

QCStatementInfo, QCStatement, QCStatements

Field Summary

Fields

Modifier and Type	Field and Description
static ObjectID	statementID The statement id of the SemanticsInformation statement info.

Constructor Summary

Constructors

Constructor and Description
SemanticsInformation() Default constructor.
SemanticsInformation(ObjectID semanticsIdentifier, GeneralName[] nameRegistrationAuthorities) Creates an SemanticsInformation object for the given sematics identifier and name registration authorities.

Method Summary

Modifier and Type	Method and Description
void	decode(ASN1Object obj) Decodes a SemanticsInformation from its ASN.1 representation.
GeneralName[]	getNameRegistrationAuthorities() Returns an array holding any name registration authorities included in this SemanticsInformation object.
ObjectID	getSemanticsIdentifier() Returns the semantics identifier of this SemanticsInformation.
ObjectID	getStatementID() Returns the statement ID identifying this SemanticsInformation statement info.
ASN1Object	toASN1Object() Returns an ASN1Object representing this SemanticsInformation object.
java.lang.String	toString() Returns a string that represents the contents of this SemanticsInformation statement info.

Methods inherited from class iaik.x509.extensions.qualified.structures.QCStatementInfo

getName

Methods inherited from class java.lang.Object

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

Field Detail

statementID

public static final ObjectID statementID

The statement id of the SemanticsInformation statement info. The corresponding OID string is "1.3.6.1.5.5.7.11.1".

Constructor Detail

SemanticsInformation

public SemanticsInformation()

Default constructor. Creates an empty SemanticsInformation object. This constructor only is used for dynamic object creation and shall not be used by an application.

SemanticsInformation

public SemanticsInformation(ObjectID semanticsIdentifier,
                            GeneralName[] nameRegistrationAuthorities)
                     throws java.lang.IllegalArgumentException

Creates an SemanticsInformation object for the given sematics identifier and name registration authorities.

Parameters:

semanticsIdentifier - the semantics identifier

nameRegistrationAuthorities - the name registration authorities to be included

Throws:

java.lang.IllegalArgumentException - if both semanticsIdentifier and nameRegistrationAuthorities are null which is not allowed

Method Detail

getStatementID

public ObjectID getStatementID()

Returns the statement ID identifying this SemanticsInformation statement info. The corresponding OID string is "1.3.6.1.5.5.7.1.11.1".

Specified by:

getStatementID in class QCStatementInfo

Returns:

the statementID identifying this SemanticsInformation statement info

getSemanticsIdentifier

public ObjectID getSemanticsIdentifier()

Returns the semantics identifier of this SemanticsInformation.

Returns:

the semantics identifier

getNameRegistrationAuthorities

public GeneralName[] getNameRegistrationAuthorities()

Returns an array holding any name registration authorities included in this SemanticsInformation object.

Returns:

the name registration authorities included in this SemanticsInformation

decode

public void decode(ASN1Object obj)
            throws CodingException

Decodes a SemanticsInformation from its ASN.1 representation.

The given ASN1Object represents a SemanticsInformation statement info not including the statementID.

Specified by:

decode in class QCStatementInfo

Parameters:

obj - the SemanticsInformation as ASN1Object

Throws:

CodingException - if the object cannot be parsed

toASN1Object

public ASN1Object toASN1Object()
                        throws CodingException

Returns an ASN1Object representing this SemanticsInformation object.

The ASN1Object returned by this method represents a SemanticsInformation statement info not including the statementID.

Specified by:

toASN1Object in class QCStatementInfo

Returns:

this SemanticsInformation statement info as ASN1Object

Throws:

CodingException - if the ASN.1 object cannot be created because both semanticsidentifier and nameRegistrationAuthorites are null, which is not allowed

toString

public java.lang.String toString()

Returns a string that represents the contents of this SemanticsInformation statement info.

Specified by:

toString in class QCStatementInfo

Returns:

the string representation