DtRtiAmbassadorBaseImplementor Class Reference

This class is a base for the protocol specific DtRtiAmbassadorImplementor class. More...

Collaboration diagram for DtRtiAmbassadorBaseImplementor:

Public Member Functions
virtual	~DtRtiAmbassadorBaseImplementor ()
	Destructor.
virtual void	addObserver (const MAKRti::DtString &name, DtRtiAmbassadorObserver *observer)
	Add/Remove observers to the LRC's observer list.
virtual DtRtiAmbassadorObserver *	removeObserver (const MAKRti::DtString &name)
virtual void	addFedAmbWrapper (const MAKRti::DtString &name, DtFedAmbWrapper *wrapper)
	Add/Remove federate wrappers to the LRC's federate wrapper list.
virtual DtFedAmbWrapper *	removeFedAmbWrapper (const MAKRti::DtString &name)
virtual bool	enterServiceCall (const MAKRti::DtString &serviceCallName)
	Prepare for a service call Called by RTI Ambassador services to gain mutually exclusive access to RTI managers.
virtual void	exitServiceCall (const MAKRti::DtString &serviceCallName)
	Finish a service call.
virtual bool	isConnected () const
	Is the connection completed?
virtual DtRIDParameters *	params ()
	Get the RID parameters.
virtual DtFederateMgr *	validatedFedMgr ()
	Get the federate mgr Will throw RTI Exception if not initialized.
virtual DtFederateMgr *	nakedFedMgr ()
	Get the federate mgr Returns even when not initialized (with null)
virtual DtConnectionMgr *	validatedConnectMgr ()
	Get the connection mgr Will throw RTI Exception if not initialized.
virtual DtConnectionMgr *	nakedConnectMgr ()
	Get the connection mgr Returns even when not initialized (with null)
virtual DtObjectMgr *	objMgr ()
	Get the object mgr If the LRC is unjoined, this will return NULL.
virtual DtInteractionMgr *	interMgr ()
	Get the interaction mgr If the LRC is unjoined, this will return NULL.
virtual DtFomClassMgr *	fomMgr ()
	Get the fom mgr If the LRC is unjoined, this will return NULL.
virtual DtRtiAmbObserverList *	observers ()
	Return the observer list.
virtual const DtRtiAmbObserverList *	observers () const
	Return the observer list.
virtual void	enableLogging ()
	Enables logging if it is not already enabled Plugin Users should never need to call this.
virtual DtBoost::shared_ptr < MAKRti::DtFilePrinter >	logPrinter ()
	Get the printer which prints output to the log file.
unsigned long	flags () const
virtual DtFederateMgr *	validateIsJoined (const char *serviceCallName)
	Validate that federate is joined.
virtual const DtFederateMgr *	validateIsJoined (const char *serviceCallName) const
	Validate that federate is joined.

Protected Types
enum	DtProcessingModelOverride { DtImmediateCallbacks = 0, DtEvokedCallbacks, DtDefaultModel }
	0 == Use an immediate callback processing model 1 == Use an evoked callback processing model 2 == Use default processing model More...

Protected Member Functions
	DtRtiAmbassadorBaseImplementor ()
	Abstract class, do not instantiate.
virtual void	setupConnection (const std::vector< MAKRti::DtString > &rid, DtProcessingModelOverride processingModelOverride=DtDefaultModel)
	Establish preliminary connection configuration and infrastructure.
virtual void	performParameterOverrides (DtRIDParameters &ridParams, DtProcessingModelOverride processingModelOverride) const
	Override RID parameter options.
virtual bool	completeConnection (MAKRti::DtString &errorMessage)
	Complete the connection infrastructure Throws if there is a fatal failure Returns boolean: connection completed successfully? If not it is possible to try again.
virtual void	clearConnection ()
	Remove the connection.
virtual void	clearManagers ()
virtual void	shutdown ()
	Prepare asynchronous connection for shutdown.
virtual bool	performMulticastDiscovery ()
	Attempt to automatically detect the RTI Forwarder (or RTI Exec) Returns false if not found.
virtual void	printDisabledService (const MAKRti::DtString &service)
	Print a disabled service.
virtual unsigned long	incrementServiceCallCount ()
	Increment the service call count and return its value.
virtual bool	tickOnce ()
	Called from tick/evokeCallback: Ticks the federate manager.
virtual void	throwInternalError (const MAKRti::DtString &errorMessage) const =0
	Throw an RTI internal exception.
virtual void	throwNotConnected (const MAKRti::DtString &errorMessage) const =0
	Throw an RTI not connected exception (internal for 1.3 & 1516)
virtual void	throwNotJoined (const MAKRti::DtString &errorMessage) const =0
	Throw an RTI not joined exception.
virtual void	attachStreams (MAKRti::DtPrinter *printer)
virtual void	detachStreams (MAKRti::DtPrinter *printer)
virtual void	detachAllStreams ()

Protected Attributes
DtRIDParameters *	myParams
	The RTI initialization parameters.
DtConnectionMgr *	myConnectMgr
	The connection manager.
DtFederateMgr *	myFedMgr
	The federate manager.
DtRtiPluginManager *	myPluginMgr
	The plugin manager.
DtRtiAmbObserverList *	myObservers
	The list of RTI Ambassador observers.
DtRtiAmbObserverList *	myEmptyObserverList
	The empty list.
DtBoost::shared_ptr < DtRtiAssistantLrcClient >	myAssistantClient
	The assistant client. We cache it until we're initialized.
DtBoost::shared_ptr < MAKRti::DtFilePrinter >	myLogPrinter
	The printer which prints output to the log file.
DtBoost::shared_ptr < DtAssistantPrinter >	myAssistantPrinter
	The printer which sends output to the assistant file.
DtBoost::shared_ptr< DtPrinterBuf >	myPrinterBuffer
	The printer which captures output before connecting.
DtBoost::shared_ptr < DtBufferPrinter >	myBufferPrinter
bool	myCallbacksEnabled
	Indicates callbacks enabled status.
MAKRti::DtClock	myClock
	Clock used for timing.
unsigned long	myFlags
bool	myUseBusyWaitForTick

Private Member Functions
	DtRtiAmbassadorBaseImplementor (const DtRtiAmbassadorBaseImplementor &)
	Copy Constructor not implemented – Copy Not Allowed!
DtRtiAmbassadorBaseImplementor &	operator= (const DtRtiAmbassadorBaseImplementor &)
	Assignment not implemented – Assignment Not Allowed!

Detailed Description

This class is a base for the protocol specific DtRtiAmbassadorImplementor class.

It performs the common initialization and processing for setting up connections and establishing the common infrastructure. The protocol specific DtRtiAmbassadorImplementor that derive from this class implement the RTIambassador services defined in the HLA specification by forwarding federate requests to the appropriate sub-managers.

Member Enumeration Documentation

enum DtRtiAmbassadorBaseImplementor::DtProcessingModelOverride

protected

0 == Use an immediate callback processing model 1 == Use an evoked callback processing model 2 == Use default processing model

Enumerator:

DtImmediateCallbacks
DtEvokedCallbacks
DtDefaultModel

Constructor & Destructor Documentation

DtRtiAmbassadorBaseImplementor::DtRtiAmbassadorBaseImplementor ( )

protected

Abstract class, do not instantiate.

virtual DtRtiAmbassadorBaseImplementor::~DtRtiAmbassadorBaseImplementor ( )

virtual

Destructor.

DtRtiAmbassadorBaseImplementor::DtRtiAmbassadorBaseImplementor ( const DtRtiAmbassadorBaseImplementor &  )

private

Copy Constructor not implemented – Copy Not Allowed!

Member Function Documentation

virtual void DtRtiAmbassadorBaseImplementor::addFedAmbWrapper ( const MAKRti::DtString &  name, DtFedAmbWrapper *  wrapper  )

virtual

Add/Remove federate wrappers to the LRC's federate wrapper list.

virtual void DtRtiAmbassadorBaseImplementor::addObserver ( const MAKRti::DtString &  name, DtRtiAmbassadorObserver *  observer  )

virtual

Add/Remove observers to the LRC's observer list.

virtual void DtRtiAmbassadorBaseImplementor::attachStreams ( MAKRti::DtPrinter *  printer )

protectedvirtual

virtual void DtRtiAmbassadorBaseImplementor::clearConnection ( )

protectedvirtual

Remove the connection.

virtual void DtRtiAmbassadorBaseImplementor::clearManagers ( )

protectedvirtual

virtual bool DtRtiAmbassadorBaseImplementor::completeConnection ( MAKRti::DtString &  errorMessage )

protectedvirtual

Complete the connection infrastructure Throws if there is a fatal failure Returns boolean: connection completed successfully? If not it is possible to try again.

Error message provided if recoverable failure occurs

virtual void DtRtiAmbassadorBaseImplementor::detachAllStreams ( )

protectedvirtual

virtual void DtRtiAmbassadorBaseImplementor::detachStreams ( MAKRti::DtPrinter *  printer )

protectedvirtual

virtual void DtRtiAmbassadorBaseImplementor::enableLogging ( )

virtual

Enables logging if it is not already enabled Plugin Users should never need to call this.

virtual bool DtRtiAmbassadorBaseImplementor::enterServiceCall ( const MAKRti::DtString &  serviceCallName )

virtual

Prepare for a service call Called by RTI Ambassador services to gain mutually exclusive access to RTI managers.

Also checks that connection is fully initialized (throws if not). Return true if entered with access to lock

virtual void DtRtiAmbassadorBaseImplementor::exitServiceCall ( const MAKRti::DtString &  serviceCallName )

virtual

Finish a service call.

unsigned long DtRtiAmbassadorBaseImplementor::flags

(

)

const

virtual DtFomClassMgr* DtRtiAmbassadorBaseImplementor::fomMgr ( )

virtual

Get the fom mgr If the LRC is unjoined, this will return NULL.

virtual unsigned long DtRtiAmbassadorBaseImplementor::incrementServiceCallCount ( )

protectedvirtual

Increment the service call count and return its value.

Null operation if not yet connected (returns 0).

virtual DtInteractionMgr* DtRtiAmbassadorBaseImplementor::interMgr ( )

virtual

Get the interaction mgr If the LRC is unjoined, this will return NULL.

virtual bool DtRtiAmbassadorBaseImplementor::isConnected ( ) const

virtual

Is the connection completed?

virtual DtBoost::shared_ptr<MAKRti::DtFilePrinter> DtRtiAmbassadorBaseImplementor::logPrinter ( )

virtual

Get the printer which prints output to the log file.

virtual DtConnectionMgr* DtRtiAmbassadorBaseImplementor::nakedConnectMgr ( )

virtual

Get the connection mgr Returns even when not initialized (with null)

virtual DtFederateMgr* DtRtiAmbassadorBaseImplementor::nakedFedMgr ( )

virtual

Get the federate mgr Returns even when not initialized (with null)

virtual DtObjectMgr* DtRtiAmbassadorBaseImplementor::objMgr ( )

virtual

Get the object mgr If the LRC is unjoined, this will return NULL.

virtual DtRtiAmbObserverList* DtRtiAmbassadorBaseImplementor::observers ( )

virtual

Return the observer list.

virtual const DtRtiAmbObserverList* DtRtiAmbassadorBaseImplementor::observers ( ) const

virtual

Return the observer list.

DtRtiAmbassadorBaseImplementor& DtRtiAmbassadorBaseImplementor::operator= ( const DtRtiAmbassadorBaseImplementor &  )

private

Assignment not implemented – Assignment Not Allowed!

virtual DtRIDParameters* DtRtiAmbassadorBaseImplementor::params ( )

virtual

Get the RID parameters.

virtual bool DtRtiAmbassadorBaseImplementor::performMulticastDiscovery ( )

protectedvirtual

Attempt to automatically detect the RTI Forwarder (or RTI Exec) Returns false if not found.

virtual void DtRtiAmbassadorBaseImplementor::performParameterOverrides ( DtRIDParameters &  ridParams, DtProcessingModelOverride  processingModelOverride  ) const

protectedvirtual

Override RID parameter options.

Overrides RID parameters based on connection status and other settings.

virtual void DtRtiAmbassadorBaseImplementor::printDisabledService ( const MAKRti::DtString &  service )

protectedvirtual

Print a disabled service.

virtual DtFedAmbWrapper* DtRtiAmbassadorBaseImplementor::removeFedAmbWrapper ( const MAKRti::DtString &  name )

virtual

virtual DtRtiAmbassadorObserver* DtRtiAmbassadorBaseImplementor::removeObserver ( const MAKRti::DtString &  name )

virtual

virtual void DtRtiAmbassadorBaseImplementor::setupConnection ( const std::vector< MAKRti::DtString > &  rid, DtProcessingModelOverride  processingModelOverride = DtDefaultModel  )

protectedvirtual

Establish preliminary connection configuration and infrastructure.

virtual void DtRtiAmbassadorBaseImplementor::shutdown ( )

protectedvirtual

Prepare asynchronous connection for shutdown.

virtual void DtRtiAmbassadorBaseImplementor::throwInternalError ( const MAKRti::DtString &  errorMessage ) const

protectedpure virtual

Throw an RTI internal exception.

virtual void DtRtiAmbassadorBaseImplementor::throwNotConnected ( const MAKRti::DtString &  errorMessage ) const

protectedpure virtual

Throw an RTI not connected exception (internal for 1.3 & 1516)

virtual void DtRtiAmbassadorBaseImplementor::throwNotJoined ( const MAKRti::DtString &  errorMessage ) const

protectedpure virtual

Throw an RTI not joined exception.

virtual bool DtRtiAmbassadorBaseImplementor::tickOnce ( )

protectedvirtual

Called from tick/evokeCallback: Ticks the federate manager.

virtual DtConnectionMgr* DtRtiAmbassadorBaseImplementor::validatedConnectMgr ( )

virtual

Get the connection mgr Will throw RTI Exception if not initialized.

virtual DtFederateMgr* DtRtiAmbassadorBaseImplementor::validatedFedMgr ( )

virtual

Get the federate mgr Will throw RTI Exception if not initialized.

virtual DtFederateMgr* DtRtiAmbassadorBaseImplementor::validateIsJoined ( const char *  serviceCallName )

virtual

Validate that federate is joined.

If not valid, throw not joined exception. Return the federate manager if everything is OK

virtual const DtFederateMgr* DtRtiAmbassadorBaseImplementor::validateIsJoined ( const char *  serviceCallName ) const

virtual

Validate that federate is joined.

If not valid, throw not joined exception. Return the federate manager if everything is OK

Member Data Documentation

DtBoost::shared_ptr<DtRtiAssistantLrcClient> DtRtiAmbassadorBaseImplementor::myAssistantClient

protected

The assistant client. We cache it until we're initialized.

DtBoost::shared_ptr<DtAssistantPrinter> DtRtiAmbassadorBaseImplementor::myAssistantPrinter

protected

The printer which sends output to the assistant file.

DtBoost::shared_ptr<DtBufferPrinter> DtRtiAmbassadorBaseImplementor::myBufferPrinter

protected

bool DtRtiAmbassadorBaseImplementor::myCallbacksEnabled

protected

Indicates callbacks enabled status.

MAKRti::DtClock DtRtiAmbassadorBaseImplementor::myClock

protected

Clock used for timing.

DtConnectionMgr* DtRtiAmbassadorBaseImplementor::myConnectMgr

protected

The connection manager.

DtRtiAmbObserverList* DtRtiAmbassadorBaseImplementor::myEmptyObserverList

protected

The empty list.

DtFederateMgr* DtRtiAmbassadorBaseImplementor::myFedMgr

protected

The federate manager.

unsigned long DtRtiAmbassadorBaseImplementor::myFlags

protected

DtBoost::shared_ptr<MAKRti::DtFilePrinter> DtRtiAmbassadorBaseImplementor::myLogPrinter

protected

The printer which prints output to the log file.

DtRtiAmbObserverList* DtRtiAmbassadorBaseImplementor::myObservers

protected

The list of RTI Ambassador observers.

DtRIDParameters* DtRtiAmbassadorBaseImplementor::myParams

protected

The RTI initialization parameters.

DtRtiPluginManager* DtRtiAmbassadorBaseImplementor::myPluginMgr

protected

The plugin manager.

DtBoost::shared_ptr<DtPrinterBuf> DtRtiAmbassadorBaseImplementor::myPrinterBuffer

protected

The printer which captures output before connecting.

bool DtRtiAmbassadorBaseImplementor::myUseBusyWaitForTick

protected

---

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

• ambImpBase.h