VR-Link API Documentation for HLA Evolved
 All Classes Namespaces Files Functions Variables Typedefs Enumerations Enumerator Friends Macros Groups Pages
List of all members | Public Member Functions | Protected Member Functions
ReflectedTestList Class Reference

An instance of this class manages the list of "Test" objects that are simulated remotely, and reflected to us by the RTI. More...

+ Inheritance diagram for ReflectedTestList:
+ Collaboration diagram for ReflectedTestList:

Public Member Functions

 ReflectedTestList (DtExerciseConn *exConn)
 Constructor.
virtual ~ReflectedTestList ()
 destructor
virtual ReflectedTestlookup (RTI::ObjectHandle id)
 The following public functions are not required by VR-Link, but they are strongly recommended.
virtual ReflectedTestlookup (const DtGlobalObjectDesignator &objName)
 Look up object by name (global object designator).
virtual ReflectedTestfirst () const
 Get the first/last object in the list.
virtual ReflectedTestlast () const
virtual void addTestAdditionCallback (TestCallbackFunction cb, void *userData)
 Functions that allow a user to register callbacks that will be called when "Test" objects are added and removed from the list.
virtual void removeTestAdditionCallback (TestCallbackFunction cb, void *userData)
virtual void addTestRemovalCallback (TestCallbackFunction cb, void *userData)
 Registration/deregistration of object removal callbacks.
virtual void removeTestRemovalCallback (TestCallbackFunction cb, void *userData)
- Public Member Functions inherited from DtReflectedObjectList
 DtReflectedObjectList (DtExerciseConn *exConn, const DtDDMRegionSet *regionSetToUse=0, const DtString &updateRateTag=DtString(""))
 Constructor.
virtual ~DtReflectedObjectList ()
 destructor
virtual DtReflectedObjectlookupObj (RTI::ObjectHandle id)
 Look up object by identifier.
virtual DtReflectedObjectlookupObj (const DtGlobalObjectDesignator &objName)
 Look up object by global ID (which is the object name in RTI1.3.3).
virtual DtReflectedObjectfirstObj () const
 Get the first/last object in the list.
virtual DtReflectedObjectlastObj () const
virtual int count () const
 Get number of objects.
virtual DtExerciseConnexerciseConn () const
 Get my exerciseConn.
virtual void manageObjectClass (RTI::ObjectClassHandle handle)
 Register callbacks with exercise connection so that we get notified when an object of this class is discovered.
virtual bool removeObject (const DtObjectId &id)
 Have the application act as though we had never discovered the object.
virtual void addObjectAdditionCallback (DtReflectedObjectCallbackFunction cb, void *userData)
 Object added callback registration/deregistration.
virtual void removeObjectAdditionCallback (DtReflectedObjectCallbackFunction cb, void *userData)
virtual void addObjectRemovalCallback (DtReflectedObjectCallbackFunction cb, void *userData)
 Object removed callback registration/deregistration.
virtual void removeObjectRemovalCallback (DtReflectedObjectCallbackFunction cb, void *userData)
virtual void print ()
 Print the SRs of all objects.
virtual void setTimeoutProcessing (bool onOff)
 Set whether or not timeout processing occurs.
virtual bool isTimeoutProcessing () const
 Get whether or not timeout processing occurs.
virtual void setWaitListRefreshEnabled (bool on)
 Set whether or not we will request updates for objects which have not met discovery and are therefor wait listed.
virtual void setTimeoutInterval (DtTime time)
 Set/Get the remote object timeout period.
virtual DtTime timeoutInterval ()
virtual void setWaitlistRefreshPeriod (DtTime time)
 Set/Get the wait list refresh period.
virtual DtTime waitlistRefreshPeriod ()
virtual void setDiscoveryCondition (DtDiscoveryCondition fn, void *usr)
 Set the checker function which will determine when an object gets discovered and put into the reflected list.
virtual void clearDiscoveryCondition ()
 Unregisters the checker function set in setDiscoverCondition.
virtual const DtDDMRegionSetsubscribedRegions ()
 Returns list of regions subscribed to.

Protected Member Functions

virtual DtReflectedObjectnewReflectedObject (DtHlaObject *obj) const
 Override of virtual function that the base class uses to create the appropriate kind of DtReflectedObject.
- Protected Member Functions inherited from DtReflectedObjectList
virtual void processDiscoverObject (DtHlaObject *obj)
 Process the discovery of a remote object on the network.
virtual void processRemoveObject (DtHlaObject *obj)
 Process the removal of a remote object from the network.
virtual void processTimedOutObjectReflect (const DtStateMsg &msg, DtHlaObject *obj)
 Handle the receipt of attributes for a remote object which was timed out.
virtual void doTimeouts ()
 Remove any remote objects which have not been updated during the timeout period.
virtual void doRequestWaitListUpdates ()
 Request an update for any objects which have not met their discovery criteria yet.
virtual void removeAndDelete (DtReflectedObject *obj, char *msg=NULL)
 Remove the remote object from the list if found and delete it.
virtual void objectAdded (DtReflectedObject *object)
 Called from processDiscoverObject() after a remote object has been added to the list.
virtual bool shouldBeTimedOut (DtReflectedObject *object)
 Returns whether or not the object should be timed out.
virtual void timeOutObject (DtReflectedObject *object)
 Times out object by removing it from the remote object list and deleting it.
virtual void unTimeOutObject (DtHlaObject *obj)
 Manages callbacks and data used for reinstating a remote object which was timed out.
virtual void addObjectClass (RTI::ObjectClassHandle handle)
 Register interest in this FOM object class.
virtual void addObjectClassByName (const char *className)
 Register interest in this FOM object class by className.
virtual void init (const DtList *handleList)
 Register interest in a whole list of RTI::ObjectClassHandles all at once.
void emptyLists ()
 Empty the object list and the timeout list.
void emptyCallbackLists ()
 Empty the callback lists.
virtual void processObjectAdditionCallbacks (DtReflectedObject *object)
 Process object addition/removal callbacks.
virtual void processObjectRemovalCallbacks (DtReflectedObject *object)
virtual void findAlreadyDiscoveredObjects ()
 When list is created, we call this function to go through the list of all discovered HLA objects to see if any should be managed by this list.
virtual void checkDiscoveryCondition (DtReflectedObject *refObj)
virtual bool readyToAdd (DtReflectedObject *obj)
 Returns true if the obj is ready to be added to myObjectList; calls myWaitListChecker from within.
virtual void addToObjectList (DtReflectedObject *refObj)
 Add refObj to myObjectList and initiates discovery callbacks.
virtual DtReflectedObjectlookupObjInWaitList (RTI::ObjectHandle id)
 Find object in waitList by identifier.
virtual DtReflectedObjectlookupObjInWaitList (const DtGlobalObjectDesignator &name)
 Find object in waitList by name.
void unsubscribeRegions ()
const DtStringupdateRateSubscriptionName () const
 Return the name of the update rate associated with our subscription, if any.

Additional Inherited Members

- Static Public Member Functions inherited from DtReflectedObjectList
static void setAutoSubscribeFlag (bool flag)
 Set/Get flag which determines whether to subscribe to object classes that this list manages.
static bool autoSubscribeFlag ()
static void setRequestClassUpdateFlag (bool onOff)
 Set/Get flag that determines whether we request updates from all objects of the object classes we subscribe to.
static bool requestClassUpdateFlag ()
static void setRequestObjectUpdateFlag (bool onOff)
 Set/Get flag that determines whether we request updates from an object as we discover it.
static bool requestObjectUpdateFlag ()
static void findDiscoveredObjectsCb (void *usr)
 Post-drain callback that calls findAlreadyDiscovedObjects().
- Static Protected Member Functions inherited from DtReflectedObjectList
static void discoverObjectCb (DtHlaObject *hlaObj, void *rel)
 Cast the void* to a DtReflectedObjectList* and calls processDiscoverObject().
static void removeObjectCb (DtHlaObject *hlaObj, void *rel)
 Cast the void* to a DtReflectedObjectList* and calls processRemoveObject().
static void timedOutObjectReflectCb (const DtStateMsg &msg, DtHlaObject *obj, void *usr)
 Cast the void* to a DtReflectedObjectList* and calls processTimedOutObjectReflect().
static void doTimeoutsPostDrainCb (void *usr)
 Calls doTimeouts.
static void doRequestWaitListUpdatesPostDrainCb (void *usr)
 Calls doRequestWaitListUpdates.
static void postUpdateCb (DtReflectedObject *obj, void *usr)
 Calls checkDiscoveryCondition.
- Protected Attributes inherited from DtReflectedObjectList
DtExerciseConnmyExConn
DtRefHlaObjectMap myObjectList
DtHashList myObjectListByName
DtRefHlaObjectMap myWaitList
DtList myTimedOutObjectList
std::vector
< RTI::ObjectClassHandle > 
myHandleList
DtIntrusiveList myObjectAddedCallbacks
DtIntrusiveList myObjectRemovedCallbacks
DtTime myTimeoutInterval
bool myTimeoutProcessingFlag
bool myWaitListRequestUpdateFlag
DtDiscoveryCondition myDiscoveryCondition
void * myDiscoveryConditionParameter
DtTime myWaitlistTime
DtTime myWaitlistRefreshPeriod
DtDDMRegionSet mySubscribedRegions
DtString myUpdateRateTag
- Static Protected Attributes inherited from DtReflectedObjectList
static bool theAutoSubscribeFlag
static bool theRequestClassUpdateFlag
static bool theRequestObjectUpdateFlag

Detailed Description

An instance of this class manages the list of "Test" objects that are simulated remotely, and reflected to us by the RTI.

This class is derived from DtReflectedObjectList, which does most of the work. The derived class mostly exists to provide type safety, and to let the base class know which FOM classes should be managed by this list.

Constructor & Destructor Documentation

ReflectedTestList::ReflectedTestList ( DtExerciseConn exConn)

Constructor.

virtual ReflectedTestList::~ReflectedTestList ( )
virtual

destructor

Member Function Documentation

virtual void ReflectedTestList::addTestAdditionCallback ( TestCallbackFunction  cb,
void *  userData 
)
virtual

Functions that allow a user to register callbacks that will be called when "Test" objects are added and removed from the list.

Registration/deregistration of object addition callbacks

virtual void ReflectedTestList::addTestRemovalCallback ( TestCallbackFunction  cb,
void *  userData 
)
virtual

Registration/deregistration of object removal callbacks.

virtual ReflectedTest* ReflectedTestList::first ( ) const
virtual

Get the first/last object in the list.

virtual ReflectedTest* ReflectedTestList::last ( ) const
virtual
virtual ReflectedTest* ReflectedTestList::lookup ( RTI::ObjectHandle  id)
virtual

The following public functions are not required by VR-Link, but they are strongly recommended.

The functions call down to base class versions, and cast to and from more generic types. Look up object by identifier.

virtual ReflectedTest* ReflectedTestList::lookup ( const DtGlobalObjectDesignator objName)
virtual

Look up object by name (global object designator).

virtual DtReflectedObject* ReflectedTestList::newReflectedObject ( DtHlaObject obj) const
protectedvirtual

Override of virtual function that the base class uses to create the appropriate kind of DtReflectedObject.

Here, we create a ReflectedTest.

Implements DtReflectedObjectList.

virtual void ReflectedTestList::removeTestAdditionCallback ( TestCallbackFunction  cb,
void *  userData 
)
virtual
virtual void ReflectedTestList::removeTestRemovalCallback ( TestCallbackFunction  cb,
void *  userData 
)
virtual

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

Document ID: Generated on Fri Dec 2 02:42:08 EST 2016 from SVN revision 171416
Copyright © 2005-2016 VT MÄK. All Rights Reserved (www.mak.com)