DtUpdateMsg Class Reference

Inheritance diagram for DtUpdateMsg:

Collaboration diagram for DtUpdateMsg:

Public Member Functions
	DtUpdateMsg (DtBufferPtr buffer=DtUSE_INTERNAL_BUFFER)
	Constructor.
virtual	~DtUpdateMsg ()
	Destructor.
virtual void	setClassHandle (DtObjectClassHandle hand)=0
	Set/Get handle.
virtual DtObjectClassHandle	classHandle () const =0
virtual void	setObjHandle (DtObjectInstanceHandle id)=0
	Set/Get handle.
virtual DtObjectInstanceHandle	objHandle () const =0
virtual void	setChannel (unsigned long handleValue)
	Set/Get DDM channel.
virtual unsigned long	channel () const
virtual void	setObjName (const char *name)
	Set/Get name.
virtual const char *	objName () const
virtual void	setTag (char const *tag)
	Set/Get tag.
virtual char const *	tag () const
virtual void	setAttrs (const DtAhvps &theAttributes, bool checkBufferSize=true)
	Set attributes.
virtual void	getAttrs (DtAhvps &attrSetBuff, bool useMsgMemory, DtObjectClassInfo *objDesc=NULL, DtHandle regionSetHandle=DtDefaultRegionSetHandle, DtRtiObject *obj=NULL, float tolerance=0.0) const
	Get attributes Attribute value set allocates own memory for values or accesses the message's memory directly Fills in only subscribed attributes if class info is provided otherwise gets all attributes in message.
virtual unsigned long	numAttrs () const
	Get number of parameters.
Public Member Functions inherited from DtRtiMsg
virtual	~DtRtiMsg ()
	Destructor.
virtual DtRtiMsg *	clone (bool copy=true) const =0
	Return a copy/empty object of the same type as this.
virtual DtRtiMsg *	cloneWithTransport (bool copy=true) const
	Return a copy/empty object of the same type as this using clone and set the transport type from the host message.
virtual DtNetMsgHeader *	netHeader () const
	Get header of network representation.
virtual int	version () const
	Return the message version.
virtual bool	isValidVersion () const
	Returns bool: message version is valid?
virtual void	setFedEx (const MAKRti::DtString &name)
	All RTI messages contain information to identify which federation execution the message applies to.
virtual void	setFedEx (int handle)
	Set federation execution identifier as a handle.
virtual bool	isForExec (const MAKRti::DtString &execName, int execHandle) const
	Returns true if the current message belongs to the indicated federation execution, false otherwise.
virtual DtRtiMsgKind	msgKind () const
	Get the message kind.
virtual const char *	kindString () const
	Returns the message kind string name.
virtual bool	isConstrained () const
	Return boolean: message type can be time constrained?
virtual bool	isAllowedDuringSave () const
	Return boolean: message type can be processed during save?
virtual void	setTime (const RTI::FedTime &time)
	Set/Get time Used in timestamped messages.
virtual RTI::FedTime const *	time (DtLogicalTimeFactory *fedTimeFactory) const
virtual bool	hasTime () const
	Returns true if time field is valid.
virtual void	setSerialNumber (unsigned long serialNumberValue)
	Set/Get event retraction serial number Used in timestamped messages.
virtual unsigned long	serialNumber () const
virtual void	setTransportType (DtTransportHandle type)
	Set/Get transport type.
virtual DtTransportHandle	transportType () const
virtual DtOrderHandle	orderType () const
	This base implementation always returns recieve order.
virtual bool	isMetadataPresent () const
	Test if metadata has been added to a DtRtiMsg object.
virtual bool	addMetadata (caddr_t *mtdAddr, unsigned int size, unsigned int *alignPad, unsigned int *headerPad=NULL)
	Allocate space for next block of metadata.
virtual void	removeMetadata (unsigned int size)
	Update the size of the message when metadata has been removed.
bool	isInteractionMsgType () const
	Utility functions, check the message type against known interaciton/update message types.
bool	isUpdateMsgType () const
virtual void	print (DtLogicalTimeFactory *logicalTimeFactory) const
	Printing functions.
virtual void	printHeader (DtLogicalTimeFactory *logicalTimeFactory) const
virtual void	printData (DtLogicalTimeFactory *logicalTimeFactory) const
virtual void	printTime (const char *label, RTI::FedTime const *timeValue) const
	Print the given time.
virtual void	printInterval (const char *label, RTI::FedTime const *intervalValue) const
	Print the interval.
virtual int	status () const
	Returns MSG_STATUS_OK if OK, a reason enumeration otherwise.
virtual const MAKRti::DtString	fedExName () const
	These two functions should be avoided in favor of isForExec().
virtual int	fedExHandle () const
	Get the federation execution identifier as a handle Returns 0 if the identifier is being represented as a name.
virtual void	setFederateHandle (DtFederateHandle handle)
	Set/Get federate handle.
virtual DtFederateHandle	federateHandle () const
	Set/Get federate handle.
virtual void	setSequenceNumber (unsigned long value)
	Set/Get message sequence number.
virtual unsigned long	sequenceNumber () const
	Set/Get message sequence number.
virtual void	setServiceCallNumber (unsigned long value)
	Set/Get service call number.
virtual unsigned long	serviceCallNumber () const
	Set/Get service call number.
virtual void	setTriggerMessageNumber (unsigned long value)
	Set/Get trigger message sequence number (i.e., the message being processed that triggered this message being sent).
virtual unsigned long	triggerMessageNumber () const
	Set/Get trigger message sequence number (i.e., the message being processed that triggered this message being sent).

Static Public Member Functions
static void	setChannelIncluded (bool includeChannel)
	Set/Get flag to include DDM channel identifier.
static bool	channelIncluded ()
Static Public Member Functions inherited from DtRtiMsg
static const char *	kindToString (DtRtiMsgKind kind)
	Returns the name of the message, by kind enumeration.
static const char *	kindString (const void *buffer)
	Extracts the message kind from the given buffer and returns its string name.
static void	setDefaultRegionSet (unsigned long defaultRegionSet)
	Set the default region set handle.
static void	setUse32BitsForValueSize (bool use32BitsForValueSizeEnabled)
	Set/Get flag to enable use of 32 bit size field for attribute/parameter values.
static bool	use32BitsForValueSize ()
static void	setSmartForwardingEnabled (bool enabled)
	Set/Get is SmartForwarding enabled?
static bool	smartForwardingEnabled ()

Protected Member Functions
virtual void	setNameSize (int size)=0
	Set/Get name size.
virtual int	nameSize () const =0
virtual void	setTagSize (int size)=0
	Set/Get tag size.
virtual int	tagSize () const =0
virtual DtNetU32 *	channelPtr () const =0
	Returns pointer to the channel in the netMsg.
virtual char *	namePtr ()=0
	Returns pointer to the name in the netMsg.
virtual char *	tagPtr ()=0
	Returns pointer to the tag in the netMsg.
virtual DtNetAttrs *	netAttrs ()=0
	Returns pointer to the network rep of the pvList.
virtual DtNetBigAttrs *	netBigAttrs ()=0
	Supports big attribute values > 64K.
virtual DtNetAttrValue *	nextNetAttr (DtNetAttrValue *netAttr) const
	Find pointer to next parameter in the network rep.
virtual DtNetBigAttrValue *	nextNetBigAttr (DtNetBigAttrValue *netAttr) const
	Supports big attribute values > 64K.
virtual void	fillFromNetAttrs (const DtNetAttrs *netRepAttrs, DtAhvps &attrs, bool useMsgMemory, DtObjectClassInfo *objDesc=NULL, DtHandle regionSetHandle=DtDefaultRegionSetHandle, DtRtiObject *obj=NULL, float tolerance=0.0) const
	Fill the supplied attribute set with the message's attributes Attribute value set allocates own memory for values or accesses the message's memory directly Fills in only subscribed attributes if class info is provided otherwise gets all attributes in message.
virtual void	fillFromNetBigAttrs (const DtNetBigAttrs *netAttrs, DtAhvps &attrs, bool useMsgMemory, DtObjectClassInfo *objDesc=NULL, DtHandle regionSetHandle=DtDefaultRegionSetHandle, DtRtiObject *obj=NULL, float tolerance=0.0) const
	Fill the supplied attribute set with the message's attributes Supports big attribute values > 64K Attribute value set allocates own memory for values or accesses the message's memory directly Fills in only subscribed attributes if class info is provided otherwise gets all attributes in message.
virtual void	fillNetAttrs (const DtAhvps &theAttributes, DtNetAttrs *netRepAttrs)
	Fill the message with the given attributes.
virtual void	fillNetBigAttrs (const DtAhvps &attrs, DtNetBigAttrs *netAttrs)
	Supports big attribute values > 64K.
virtual void	setSizeOfNetAttrs (unsigned long size)
	Sets size for the network rep of the pvList.
virtual unsigned long	sizeNeededForNetAttrs (const DtAhvps &attrs) const
	Returns the size the network representation will consume.
virtual int	channelFieldSize () const
	Returns size of serial number field.
virtual int	nameFieldSize () const
	Returns size of name field.
virtual int	tagFieldSize () const
	Returns size of tag field.
virtual DtUpdateMsg *	self () const
	Casts away const-ness.
Protected Member Functions inherited from DtRtiMsg
	DtRtiMsg ()
	Constructor.
virtual DtRtiMsgKind	internalDtRtiMsgKind ()=0
virtual void	sizeChanged (int size)
	Called whenever size is changed using changeSize, or insert/deleteBytes.
void	initDtRtiMsg (int size, DtRtiMsgKind msgKindVal, DtBufferPtr buffer)
	Called by ctor, so not virtual.
void	initDtRtiMsg (const void *initial, int size, DtBufferPtr buffer)
void	initDtRtiMsg (const DtNetMsgHeader *header, DtBufferPtr buffer)
virtual void	adjustBytes (int offset, int numBytes)
	Adjust numBytes bytes at the indicated offset in the net rep.
virtual void	adjustBytes (void *address, int numBytes)
	Adjust the numBytes starting at the indicated addres.

Protected Attributes
char *	myTag
char *	myName
int	myAttrFieldLength
Protected Attributes inherited from DtRtiMsg
DtTransportHandle	myTransportType
DtOrderHandle	myOrderType
RTI::FedTime *	myFedTime
bool	myTimeIsValid
bool	myConstrained
bool	myAllowedDuringSave
unsigned long	mySerialNumber
unsigned long	myServiceCallNumber
unsigned long	myTriggerMessage

Static Protected Attributes
static bool	theChannelIncluded = false
Static Protected Attributes inherited from DtRtiMsg
static bool	theUse32BitsForValueSize = false
static bool	theSmartForwardingEnabled = false

Additional Inherited Members
Static Public Attributes inherited from DtRtiMsg
static unsigned long	theDefaultRegionSetHandle = 0
static const char *	theDefaultTag = NULL

Constructor & Destructor Documentation

DtUpdateMsg::DtUpdateMsg

(

DtBufferPtr

buffer = DtUSE_INTERNAL_BUFFER

)

Constructor.

References DtRtiMsg::myAllowedDuringSave, and DtRtiMsg::myConstrained.

DtUpdateMsg::~DtUpdateMsg ( )

virtual

Destructor.

References myName, myTag, and NULL.

Member Function Documentation

unsigned long DtUpdateMsg::channel ( ) const

virtual

References channelIncluded(), channelPtr(), and DtDefaultRegionSetHandle.

Referenced by DtUpdateRoMsg::printData(), and DtObjectMgr::processUpdate().

int DtUpdateMsg::channelFieldSize ( ) const

protectedvirtual

Returns size of serial number field.

References channelIncluded().

Referenced by DtUpdateRoMsg::tagPtr().

bool DtUpdateMsg::channelIncluded ( )

inlinestatic

References theChannelIncluded.

Referenced by DtUpdateRoMsg::addCallback(), channel(), channelFieldSize(), DtUpdateRoMsg::DtUpdateRoMsg(), DtUpdateRoMsg::internalDtRtiMsgKind(), DtUpdateRoMsg::printData(), DtUpdateRoMsg::removeCallback(), and setChannel().

virtual DtNetU32* DtUpdateMsg::channelPtr ( ) const

protectedpure virtual

Returns pointer to the channel in the netMsg.

Implemented in DtUpdateRoMsg.

Referenced by channel(), and setChannel().

virtual DtObjectClassHandle DtUpdateMsg::classHandle ( ) const

pure virtual

Implemented in DtUpdateRoMsg.

Referenced by DtObjectMgr::processUpdate(), and DtNetStatsMonitor::recordObjectStats().

void DtUpdateMsg::fillFromNetAttrs ( const DtNetAttrs *  netRepAttrs, DtAhvps &  attrs, bool  useMsgMemory, DtObjectClassInfo *  objDesc = NULL, DtHandle  regionSetHandle = DtDefaultRegionSetHandle, DtRtiObject *  obj = NULL, float  tolerance = 0.0  ) const

protectedvirtual

Fill the supplied attribute set with the message's attributes Attribute value set allocates own memory for values or accesses the message's memory directly Fills in only subscribed attributes if class info is provided otherwise gets all attributes in message.

References DtNetAttrValue::handle, DtObjectClassInfo::isSubscribed(), nextNetAttr(), DtNetAttrs::numAttrs, numAttrs(), DtRtiObject::okToReceive(), and DtNetAttrValue::size.

Referenced by getAttrs().

void DtUpdateMsg::fillFromNetBigAttrs ( const DtNetBigAttrs *  netAttrs, DtAhvps &  attrs, bool  useMsgMemory, DtObjectClassInfo *  objDesc = NULL, DtHandle  regionSetHandle = DtDefaultRegionSetHandle, DtRtiObject *  obj = NULL, float  tolerance = 0.0  ) const

protectedvirtual

Fill the supplied attribute set with the message's attributes Supports big attribute values > 64K Attribute value set allocates own memory for values or accesses the message's memory directly Fills in only subscribed attributes if class info is provided otherwise gets all attributes in message.

References DtNetBigAttrValue::handle, DtObjectClassInfo::isSubscribed(), nextNetBigAttr(), DtNetBigAttrs::numAttrs, numAttrs(), DtRtiObject::okToReceive(), and DtNetBigAttrValue::size.

Referenced by getAttrs().

void DtUpdateMsg::fillNetAttrs ( const DtAhvps &  theAttributes, DtNetAttrs *  netRepAttrs  )

protectedvirtual

Fill the message with the given attributes.

References DtNetAttrValue::handle, nextNetAttr(), DtNetAttrs::numAttrs, and DtNetAttrValue::size.

Referenced by setAttrs().

void DtUpdateMsg::fillNetBigAttrs ( const DtAhvps &  attrs, DtNetBigAttrs *  netAttrs  )

protectedvirtual

Supports big attribute values > 64K.

References DtNetBigAttrValue::handle, nextNetBigAttr(), DtNetBigAttrs::numAttrs, and DtNetBigAttrValue::size.

Referenced by setAttrs().

void DtUpdateMsg::getAttrs ( DtAhvps &  attrSetBuff, bool  useMsgMemory, DtObjectClassInfo *  objDesc = NULL, DtHandle  regionSetHandle = DtDefaultRegionSetHandle, DtRtiObject *  obj = NULL, float  tolerance = 0.0  ) const

virtual

Get attributes Attribute value set allocates own memory for values or accesses the message's memory directly Fills in only subscribed attributes if class info is provided otherwise gets all attributes in message.

References fillFromNetAttrs(), fillFromNetBigAttrs(), netAttrs(), netBigAttrs(), and DtRtiMsg::use32BitsForValueSize().

Referenced by DtUpdateRoMsg::printData(), and DtObjectMgr::processUpdate().

int DtUpdateMsg::nameFieldSize ( ) const

protectedvirtual

Returns size of name field.

References nameSize().

Referenced by DtUpdateRoMsg::DtUpdateRoMsg(), DtUpdateRoMsg::netAttrs(), DtUpdateRoMsg::netBigAttrs(), and setObjName().

virtual char* DtUpdateMsg::namePtr ( )

protectedpure virtual

Returns pointer to the name in the netMsg.

Implemented in DtUpdateRoMsg.

Referenced by objName(), and setObjName().

virtual int DtUpdateMsg::nameSize ( ) const

protectedpure virtual

Implemented in DtUpdateRoMsg.

Referenced by nameFieldSize(), objName(), and setObjName().

virtual DtNetAttrs* DtUpdateMsg::netAttrs ( )

protectedpure virtual

Returns pointer to the network rep of the pvList.

Implemented in DtUpdateRoMsg.

Referenced by getAttrs(), numAttrs(), setAttrs(), and setSizeOfNetAttrs().

virtual DtNetBigAttrs* DtUpdateMsg::netBigAttrs ( )

protectedpure virtual

Supports big attribute values > 64K.

Implemented in DtUpdateRoMsg.

Referenced by getAttrs(), numAttrs(), and setAttrs().

DtNetAttrValue * DtUpdateMsg::nextNetAttr ( DtNetAttrValue *  netAttr ) const

protectedvirtual

Find pointer to next parameter in the network rep.

References DtNetAttrValue::totalSize().

Referenced by fillFromNetAttrs(), and fillNetAttrs().

DtNetBigAttrValue * DtUpdateMsg::nextNetBigAttr ( DtNetBigAttrValue *  netAttr ) const

protectedvirtual

Supports big attribute values > 64K.

References DtNetBigAttrValue::totalSize().

Referenced by fillFromNetBigAttrs(), and fillNetBigAttrs().

unsigned long DtUpdateMsg::numAttrs ( ) const

virtual

Get number of parameters.

References netAttrs(), netBigAttrs(), DtNetAttrs::numAttrs, DtNetBigAttrs::numAttrs, and DtRtiMsg::use32BitsForValueSize().

Referenced by fillFromNetAttrs(), fillFromNetBigAttrs(), DtUpdateRoMsg::printData(), and DtObjectMgr::processUpdate().

virtual DtObjectInstanceHandle DtUpdateMsg::objHandle ( ) const

pure virtual

Implemented in DtUpdateRoMsg.

Referenced by DtObjectMgr::processUpdate(), and DtNetStatsMonitor::recordObjectStats().

const char * DtUpdateMsg::objName ( ) const

virtual

References myName, namePtr(), and nameSize().

Referenced by DtUpdateRoMsg::printData(), DtObjectMgr::processUpdate(), and DtNetStatsMonitor::recordObjectStats().

DtUpdateMsg * DtUpdateMsg::self ( ) const

inlineprotectedvirtual

Casts away const-ness.

void DtUpdateMsg::setAttrs ( const DtAhvps &  theAttributes, bool  checkBufferSize = true  )

virtual

Set attributes.

References fillNetAttrs(), fillNetBigAttrs(), netAttrs(), netBigAttrs(), setSizeOfNetAttrs(), sizeNeededForNetAttrs(), and DtRtiMsg::use32BitsForValueSize().

Referenced by DtUpdateRoMsg::DtUpdateRoMsg().

void DtUpdateMsg::setChannel ( unsigned long  handleValue )

virtual

Set/Get DDM channel.

References channelIncluded(), and channelPtr().

Referenced by DtUpdateRoMsg::DtUpdateRoMsg().

void DtUpdateMsg::setChannelIncluded ( bool  includeChannel )

static

Set/Get flag to include DDM channel identifier.

References theChannelIncluded.

Referenced by DtObjectMgr::DtObjectMgr(), and DtConnectionMgr::initParams().

virtual void DtUpdateMsg::setClassHandle ( DtObjectClassHandle  hand )

pure virtual

Set/Get handle.

Implemented in DtUpdateRoMsg.

virtual void DtUpdateMsg::setNameSize ( int  size )

protectedpure virtual

Set/Get name size.

Implemented in DtUpdateRoMsg.

Referenced by setObjName().

virtual void DtUpdateMsg::setObjHandle ( DtObjectInstanceHandle  id )

pure virtual

Set/Get handle.

Implemented in DtUpdateRoMsg.

void DtUpdateMsg::setObjName ( const char *  name )

virtual

Set/Get name.

References DtRtiMsg::adjustBytes(), myName, nameFieldSize(), namePtr(), nameSize(), NULL, and setNameSize().

Referenced by DtUpdateRoMsg::DtUpdateRoMsg().

void DtUpdateMsg::setSizeOfNetAttrs ( unsigned long  size )

protectedvirtual

Sets size for the network rep of the pvList.

References DtRtiMsg::adjustBytes(), myAttrFieldLength, and netAttrs().

Referenced by setAttrs().

void DtUpdateMsg::setTag ( char const *  tag )

virtual

Set/Get tag.

References DtRtiMsg::adjustBytes(), myTag, NULL, setTagSize(), tagFieldSize(), tagPtr(), and tagSize().

Referenced by DtUpdateRoMsg::DtUpdateRoMsg().

virtual void DtUpdateMsg::setTagSize ( int  size )

protectedpure virtual

Set/Get tag size.

Implemented in DtUpdateRoMsg.

Referenced by setTag().

unsigned long DtUpdateMsg::sizeNeededForNetAttrs ( const DtAhvps &  attrs ) const

protectedvirtual

Returns the size the network representation will consume.

References DtRtiMsg::use32BitsForValueSize().

Referenced by setAttrs().

const char * DtUpdateMsg::tag ( ) const

virtual

References myTag, NULL, tagPtr(), and tagSize().

Referenced by DtUpdateRoMsg::printData(), and DtObjectMgr::processUpdate().

int DtUpdateMsg::tagFieldSize ( ) const

protectedvirtual

Returns size of tag field.

References tagSize().

Referenced by DtUpdateRoMsg::DtUpdateRoMsg(), DtUpdateRoMsg::namePtr(), and setTag().

virtual char* DtUpdateMsg::tagPtr ( )

protectedpure virtual

Returns pointer to the tag in the netMsg.

Implemented in DtUpdateRoMsg.

Referenced by setTag(), and tag().

virtual int DtUpdateMsg::tagSize ( ) const

protectedpure virtual

Implemented in DtUpdateRoMsg.

Referenced by setTag(), tag(), and tagFieldSize().

Member Data Documentation

int DtUpdateMsg::myAttrFieldLength

protected

Referenced by DtUpdateRoMsg::DtUpdateRoMsg(), and setSizeOfNetAttrs().

char* DtUpdateMsg::myName

protected

Referenced by objName(), setObjName(), and ~DtUpdateMsg().

char* DtUpdateMsg::myTag

protected

Referenced by setTag(), tag(), and ~DtUpdateMsg().

bool DtUpdateMsg::theChannelIncluded = false

staticprotected

Referenced by channelIncluded(), and setChannelIncluded().

---

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

• updateMsg.h
• updateMsg.cxx