Asn1NamedEventHandler Class Reference
[Named Event Handlers]

#include <asn1CppEvtHndlr.h>

Inheritance diagram for Asn1NamedEventHandler:
Asn1NullEventHandler

List of all members.

Public Member Functions

virtual void startElement (const char *name, int index)=0
virtual void endElement (const char *name, int index)=0
virtual void boolValue (OSBOOL value)
virtual void intValue (OSINT32 value)
virtual void uIntValue (OSUINT32 value)
virtual void int64Value (OSINT64 value)
virtual void uInt64Value (OSUINT64 value)
virtual void bitStrValue (OSUINT32 numbits, const OSOCTET *data)
virtual void octStrValue (OSUINT32 numocts, const OSOCTET *data)
virtual void charStrValue (const char *value)
virtual void charStrValue (OSUINT32 nchars, const OSUTF8CHAR *value)
virtual void charStrValue (OSUINT32 nchars, OSUNICHAR *data)
virtual void charStrValue (OSUINT32 nchars, OS32BITCHAR *data)
virtual void nullValue ()
virtual void oidValue (OSUINT32 numSubIds, OSUINT32 *pSubIds)
virtual void realValue (double value)
virtual void enumValue (OSUINT32 value, const OSUTF8CHAR *text)
virtual void openTypeValue (OSUINT32 numocts, const OSOCTET *data)

Static Public Member Functions

static EXTRTMETHOD void addEventHandler (OSCTXT *pCtxt, Asn1NamedEventHandler *pHandler)
static EXTRTMETHOD void removeEventHandler (OSCTXT *pCtxt, Asn1NamedEventHandler *pHandler)
static EXTRTMETHOD void invokeStartElement (OSCTXT *pCtxt, const char *name, int index)
static EXTRTMETHOD void invokeEndElement (OSCTXT *pCtxt, const char *name, int index)
static EXTRTMETHOD void invokeBoolValue (OSCTXT *pCtxt, OSBOOL value)
static EXTRTMETHOD void invokeIntValue (OSCTXT *pCtxt, OSINT32 value)
static EXTRTMETHOD void invokeUIntValue (OSCTXT *pCtxt, OSUINT32 value)
static EXTRTMETHOD void invokeInt64Value (OSCTXT *pCtxt, OSINT64 value)
static EXTRTMETHOD void invokeUInt64Value (OSCTXT *pCtxt, OSUINT64 value)
static EXTRTMETHOD void invokeBitStrValue (OSCTXT *pCtxt, OSUINT32 numbits, const OSOCTET *data)
static EXTRTMETHOD void invokeOctStrValue (OSCTXT *pCtxt, OSUINT32 numocts, const OSOCTET *data)
static EXTRTMETHOD void invokeCharStrValue (OSCTXT *pCtxt, const char *value)
static EXTRTMETHOD void invokeCharStrValue (OSCTXT *pCtxt, OSUINT32 nchars, OSUNICHAR *data)
static EXTRTMETHOD void invokeCharStrValue (OSCTXT *pCtxt, OSUINT32 nchars, OS32BITCHAR *data)
static EXTRTMETHOD void invokeCharStrValue (OSCTXT *pCtxt, OSUINT32 nchars, const OSUTF8CHAR *data)
static EXTRTMETHOD void invokeNullValue (OSCTXT *pCtxt)
static EXTRTMETHOD void invokeOidValue (OSCTXT *pCtxt, OSUINT32 numSubIds, OSUINT32 *pSubIds)
static EXTRTMETHOD void invokeRealValue (OSCTXT *pCtxt, double value)
static EXTRTMETHOD void invokeEnumValue (OSCTXT *pCtxt, OSUINT32 value, const OSUTF8CHAR *text)
static EXTRTMETHOD void invokeOpenTypeValue (OSCTXT *pCtxt, OSUINT32 numocts, const OSOCTET *data)

Detailed Description

Named event handler base class. This is the base class from which user-defined event handler classes are derived. These classes can be used to handle events during the parsing of an ASN.1 message. The event callback methods that can be implemented are startElement, endElement, and contents methods.


Member Function Documentation

virtual void Asn1NamedEventHandler::bitStrValue ( OSUINT32  numbits,
const OSOCTET *  data 
) [inline, virtual]

This method is invoked from within a decode function when a value of the BIT STRING ASN.1 type is parsed.

Parameters:
numbits - Number of bits in the parsed value.
data - Pointer to a byte array that contains the bit string data.
Returns:
- none
virtual void Asn1NamedEventHandler::boolValue ( OSBOOL  value  )  [inline, virtual]

This method is invoked from within a decode function when a value of the BOOLEAN ASN.1 type is parsed.

Parameters:
value Parsed value.
Returns:
- none
virtual void Asn1NamedEventHandler::charStrValue ( OSUINT32  nchars,
OS32BITCHAR *  data 
) [inline, virtual]

This method is invoked from within a decode function when a value of one of the 32-bit ASN.1 characer string types is parsed.

This is used for the ASN.1 UniversalString type.

Parameters:
nchars Number of characters in the parsed value.
data Pointer to an array containing 32-bit values. Each 32-bit integer value is a universal character.
Returns:
- none
virtual void Asn1NamedEventHandler::charStrValue ( OSUINT32  nchars,
OSUNICHAR *  data 
) [inline, virtual]

This method is invoked from within a decode function when a value of one of the 16-bit ASN.1 character string types is parsed.

This is used for the ASN.1 BmpString type.

Parameters:
nchars Number of characters in the parsed value.
data Pointer to an array containing 16-bit values. These are represented using unsigned short integer values.
Returns:
- none
virtual void Asn1NamedEventHandler::charStrValue ( OSUINT32  nchars,
const OSUTF8CHAR *  value 
) [inline, virtual]

This method is invoked from within a decode function when a value of a UTF-8 character string type is parsed.

Parameters:
nchars Number of characters in the parsed value.
value A UTF-8 character string.
Returns:
- none
virtual void Asn1NamedEventHandler::charStrValue ( const char *  value  )  [inline, virtual]

This method is invoked from within a decode function when a value of one of the 8-bit ASN.1 character string types is parsed.

Parameters:
value Null terminated character string value.
Returns:
- none
virtual void Asn1NamedEventHandler::endElement ( const char *  name,
int  index 
) [pure virtual]

This method is invoked from within a decode function when parsing is complete on an element of a SEQUENCE, SET, SEQUENCE OF, SET OF, or CHOICE construct.

Parameters:
name For SEQUENCE, SET, or CHOICE, this is the name of the element as defined in the ASN.1 defination. For SEQUENCE OF or SET OF, this is set to the name "element".
index For SEQUENCE, SET, or CHOICE, this is not used and is set to the value -1. For SEQUENCE OF or SET OF, this contains the zero-based index of the element in the conceptual array associated with the construct.
Returns:
- none

Implemented in Asn1NullEventHandler.

virtual void Asn1NamedEventHandler::enumValue ( OSUINT32  value,
const OSUTF8CHAR *  text 
) [inline, virtual]

This method is invoked from within a decode function when a value of the ENUMERATED ASN.1 type is parsed.

Parameters:
value - Parsed enumerated value
text - Textual value of enumerated identifier
Returns:
- none
virtual void Asn1NamedEventHandler::int64Value ( OSINT64  value  )  [inline, virtual]

This method is invoked from within a decode function when a value of the 64-bit INTEGER ASN.1 type is parsed.

Parameters:
value Parsed value.
Returns:
- none
virtual void Asn1NamedEventHandler::intValue ( OSINT32  value  )  [inline, virtual]

This method is invoked from within a decode function when a value of the INTEGER ASN.1 type is parsed.

Parameters:
value Parsed value.
Returns:
- none
virtual void Asn1NamedEventHandler::nullValue (  )  [inline, virtual]

This method is invoked from within a decode function when a value of the NULL ASN.1 type is parsed.

Parameters:
- none
Returns:
- none
virtual void Asn1NamedEventHandler::octStrValue ( OSUINT32  numocts,
const OSOCTET *  data 
) [inline, virtual]

This method is invoked from within a decode function when a value of one of the OCTET STRING ASN.1 type is parsed.

Parameters:
numocts Number of octets in the parsed value.
data Pointer to byte array containing the octet string data.
Returns:
- none
virtual void Asn1NamedEventHandler::oidValue ( OSUINT32  numSubIds,
OSUINT32 *  pSubIds 
) [inline, virtual]

This method is invoked from within a decode function whn a value the OBJECT IDENTIFIER ASN.1 type is parsed.

Parameters:
numSubIds Number of subidentifiers in the object identifier.
pSubIds Pointer to array containing the subidentifier values.
Returns:
-none
virtual void Asn1NamedEventHandler::openTypeValue ( OSUINT32  numocts,
const OSOCTET *  data 
) [inline, virtual]

This value is invoked from within a decode function when an ASN.1 open type is parsed.

Parameters:
numocts Number of octets in the parsed value.
data Pointer to byet array contain in tencoded ASN.1 value.
Returns:
- none
virtual void Asn1NamedEventHandler::realValue ( double  value  )  [inline, virtual]

This method is invoked from within a decode function when a value the REAL ASN.1 type is parsed.

Parameters:
value Parsed value.
Returns:
- none
virtual void Asn1NamedEventHandler::startElement ( const char *  name,
int  index 
) [pure virtual]

This method is invoked from within a decode function when an element of a SEQUENCE, SET, SEQUENCE OF, SET OF, or CHOICE construct is parsed.

Parameters:
name For SEQUENCE, SET, or CHOICE, this is the name of the element as defined in the ASN.1 defination. For SEQUENCE OF or SET OF, this is set to the name "element".
index For SEQUENCE, SET, or CHOICE, this is not used and is set to the value -1. For SEQUENCE OF or SET OF, this contains the zero-based index of the element in the conceptual array associated with the construct.
Returns:
- none

Implemented in Asn1NullEventHandler.

virtual void Asn1NamedEventHandler::uInt64Value ( OSUINT64  value  )  [inline, virtual]

This method is invoked from within a decode function when a value of the 64-bit INTEGER ASN.1 type is parsed.

Parameters:
value Parsed value.
Returns:
- none
virtual void Asn1NamedEventHandler::uIntValue ( OSUINT32  value  )  [inline, virtual]

This method is invoked from within a decode function when a value of the INTEGER ASN.1 type is parsed.

In this case, constraints on the integer value forced the use of unsigned integer C type to represent the value.

Parameters:
value Parsed value.
Returns:
- none

The documentation for this class was generated from the following file: