DtExtendedAttributesInitializer Class Reference

DtExtendedAttributesInitializer performs all initialization required to register publishers, reflected lists, state repositories, encoders, and decoders for a set of object classes that should support extended attributes.

Inheritance diagram for DtExtendedAttributesInitializer:

Public Member Functions
	DtExtendedAttributesInitializer ()
virtual	~DtExtendedAttributesInitializer ()
virtual void	initialize (DtExerciseConn *exConn)
virtual void	setObjectClassChooser (DtObjectClassChooserPtr chooser)
virtual void	addSupportedClass (const DtString &fullClassName, bool addSubclasses=false)
virtual DtAttributeNameToHandleMapPtr	attributeNameToHandleMap (const RTI::ObjectClassHandle &classHdl) const
virtual void	setAttributeNameToHandleMap (const RTI::ObjectClassHandle &classHdl, const DtAttributeNameToHandleMap &mapping)

Static Public Member Functions
static tbb::spin_mutex &	GlobalHLAMutex ()

Protected Member Functions
virtual bool	needsInitialization (DtExerciseConn *exConn)
virtual const DtString &	publisherName () const =0
virtual const DtString &	reflectedListName () const =0
virtual const DtString &	defaultBaseObjectClass () const =0
virtual void	setUnknownAttributeFunctions (DtObjClassDesc *desc)=0
virtual void	setPublisherStateRepCreator ()=0
virtual void	setReflectedObjectStateRepCreator ()=0
virtual bool	areClassNamesEquivalent (const DtString &, const DtString &) const
virtual void	addSupportedSubclasses (DtExerciseConn *exConn)
virtual void	initializeObjectClassChooser (DtExerciseConn *exConn)
virtual void	initializeObjectClasses (DtExerciseConn *exConn)
virtual void	initializeAttributes (DtObjClassDesc *desc)
virtual void	initializeExtendedAttributes (DtExerciseConn *exConn)

Protected Attributes
bool	myNeedsInitialization
DtObjectClassChooserPtr	myObjectClassChooser
std::list< DtString >	myFullBaseClassNames
std::list< DtString >	myFullClassNames
DtClassAttributeNameToHandleMap	myAttributeHandlesByName

Static Protected Attributes
static tbb::spin_mutex	theGlobalHLAMutex
static DtString	theExtendedAttributesClassName

Constructor & Destructor Documentation

DtExtendedAttributesInitializer::DtExtendedAttributesInitializer

(

)

Constructor.

virtual DtExtendedAttributesInitializer::~DtExtendedAttributesInitializer ( )

virtual

Destructor.

Member Function Documentation

virtual void DtExtendedAttributesInitializer::initialize ( DtExerciseConn *  exConn )

virtual

Performs initialization. Generally only needs to be run once per publisher/reflected list/state rep type.

virtual void DtExtendedAttributesInitializer::setObjectClassChooser ( DtObjectClassChooserPtr  chooser )

virtual

Specifies an object class chooser to choose what object class to publish. Must be called prior to initialize().

virtual void DtExtendedAttributesInitializer::addSupportedClass ( const DtString &  fullClassName, bool  addSubclasses = false  )

virtual

Adds a new FOM class to be supported. If addSubclasses is true, all subclasses of the class will also be supported. Must be called prior to initialize().

virtual DtAttributeNameToHandleMapPtr DtExtendedAttributesInitializer::attributeNameToHandleMap ( const RTI::ObjectClassHandle &  classHdl ) const

virtual

Gets the current attribute name to handle mapping for the object class. Returns a nullptr if not found.

virtual void DtExtendedAttributesInitializer::setAttributeNameToHandleMap ( const RTI::ObjectClassHandle &  classHdl, const DtAttributeNameToHandleMap &  mapping  )

virtual

Sets the attribute name to handle mapping for the object class.

static tbb::spin_mutex& DtExtendedAttributesInitializer::GlobalHLAMutex ( )

inlinestatic

virtual bool DtExtendedAttributesInitializer::needsInitialization ( DtExerciseConn *  exConn )

protectedvirtual

These functions are called within initialize(). Must be implemented in subclasses as they are specific to the publishers, reflected lists, and state repositories for a category of object.

Returns true if initialization needs to be performed. Default behavior is to always_noconv return true unless overridden in subclass.

Reimplemented in DtControlObjectExtendedAttributesInitializer, DtAggregateExtendedAttributesInitializer, and DtEntityExtendedAttributesInitializer.

virtual const DtString& DtExtendedAttributesInitializer::publisherName ( ) const

protectedpure virtual

The name of the publisher class in VR-Link.

Implemented in DtControlObjectExtendedAttributesInitializer, DtAggregateExtendedAttributesInitializer, and DtEntityExtendedAttributesInitializer.

virtual const DtString& DtExtendedAttributesInitializer::reflectedListName ( ) const

protectedpure virtual

The name of the reflected list class in VR-Link.

Implemented in DtControlObjectExtendedAttributesInitializer, DtAggregateExtendedAttributesInitializer, and DtEntityExtendedAttributesInitializer.

virtual const DtString& DtExtendedAttributesInitializer::defaultBaseObjectClass ( ) const

protectedpure virtual

The base object class that is supported by default. All subclasses will also be supported.

Implemented in DtControlObjectExtendedAttributesInitializer, DtAggregateExtendedAttributesInitializer, and DtEntityExtendedAttributesInitializer.

virtual void DtExtendedAttributesInitializer::setUnknownAttributeFunctions ( DtObjClassDesc *  desc )

protectedpure virtual

Sets the unknown attribute checker, encoder, and decoder functions in order to process them as extended attributes. Specific to a particular state repository class.

Implemented in DtControlObjectExtendedAttributesInitializer, DtAggregateExtendedAttributesInitializer, and DtEntityExtendedAttributesInitializer.

virtual void DtExtendedAttributesInitializer::setPublisherStateRepCreator ( )

protectedpure virtual

Sets the state rep creator for the associated publisher. Specific to a particular publisher class and state repository class.

Implemented in DtControlObjectExtendedAttributesInitializer, DtAggregateExtendedAttributesInitializer, DtEntityExtendedAttributesInitializer, and DtEntityExtendedAttributesWithTemperatureInitializer.

virtual void DtExtendedAttributesInitializer::setReflectedObjectStateRepCreator ( )

protectedpure virtual

Sets the state rep creator for the associated reflected object. Specific to a particular reflected object class and state repository class.

Implemented in DtControlObjectExtendedAttributesInitializer, DtAggregateExtendedAttributesInitializer, DtEntityExtendedAttributesInitializer, and DtEntityExtendedAttributesWithTemperatureInitializer.

virtual bool DtExtendedAttributesInitializer::areClassNamesEquivalent ( const DtString &  , const DtString &    ) const

protectedvirtual

These functions are called within initialize() to perform specific aspects of the process. Can be overridden in subclasses, but is usually not necessary.

Utility function that returns true if the two strings correspond to the same full object class names.

virtual void DtExtendedAttributesInitializer::addSupportedSubclasses ( DtExerciseConn *  exConn )

protectedvirtual

Finds all subclasses for supported base classes and adds them to the list of supported object classes.

virtual void DtExtendedAttributesInitializer::initializeObjectClassChooser ( DtExerciseConn *  exConn )

protectedvirtual

Initializes the object class chooser for the publisher.

virtual void DtExtendedAttributesInitializer::initializeObjectClasses ( DtExerciseConn *  exConn )

protectedvirtual

Initializes the object classes by specifying unknown attribute functions and setting up attribute mappings.

virtual void DtExtendedAttributesInitializer::initializeAttributes ( DtObjClassDesc *  desc )

protectedvirtual

Called by initializeObjectClasses() to set up the mapping of attribute handles to attribute names that is required to translate FOM class attributes into extended attributes.

virtual void DtExtendedAttributesInitializer::initializeExtendedAttributes ( DtExerciseConn *  exConn )

protectedvirtual

Initializes the attributes for extended attributes that are sent via an associated ExtendedAttributes object.

Member Data Documentation

bool DtExtendedAttributesInitializer::myNeedsInitialization

protected

DtObjectClassChooserPtr DtExtendedAttributesInitializer::myObjectClassChooser

protected

std::list<DtString> DtExtendedAttributesInitializer::myFullBaseClassNames

protected

std::list<DtString> DtExtendedAttributesInitializer::myFullClassNames

protected

tbb::spin_mutex DtExtendedAttributesInitializer::theGlobalHLAMutex

staticprotected

DtString DtExtendedAttributesInitializer::theExtendedAttributesClassName

staticprotected

DtClassAttributeNameToHandleMap DtExtendedAttributesInitializer::myAttributeHandlesByName

protected

A map of attribute handles by name for each object class supported by this repository. This is static since it can be shared by all state repositories of this type.

---

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

• /data/exports/nrhent7-1/nightly/docs/vrForces.vrf5-1-branch/include/vrfExtObjects/extendedAttributesInitializer.h