MAKVrExchange::DtBrokerInitializer Class Reference

This class is used to initialize a DtBroker instance. More...

Inheritance diagram for MAKVrExchange::DtBrokerInitializer:

Public Member Functions
	DtBrokerInitializer (int argc, char **argv, const char *version)
	Takes the command line arguments and the version of this broker in the form of a const char *.
virtual	~DtBrokerInitializer ()
	Destructor.
DtBrokerInitializer &	operator= (const DtBrokerInitializer &other)
	Assignment Operator.
virtual void	parseCmdLine ()
	Parse the command line.
virtual void	loadFile ()
	Load a configuration file.
virtual void	loadFile (const DtString &fileName)
virtual void	saveFile ()
	Save a configuration file.
virtual void	saveFile (const DtString &fileName)
DtString	brokerName () const
	The name of this broker.
int	notifyLevel () const
	The notify level of this broker.
void	setNotifyLevel (int nl)
int	tcpPort () const
	The TCP port to use to maintain connectivity with the Data Exchange.
void	setTcpPort (int port)
	Sets the TCP port.
bool	dumpEnvironment () const
	The broker can be configured to dump its known environment at startup.
void	setDumpEnvironment (bool shouldDumpEnv)
int	maxControlMessages () const
	Returns the maximum number of control messages to read per tic.
void	setMaxControlMessages (int mcm)
int	maxInteractionMessages () const
	Returns the maximum number of Interaction messages to read per tick.
void	setMaxInteractionMessages (int mim)
int	maxObjectMessages () const
	Returns the maximum number of object messages to read per tick.
void	setMaxObjectMessages (int mom)
DtString	controlQueueName () const
	Returns the queue names for each type of queue.
DtString	interactionQueueName () const
DtString	objectQueueName () const
bool	oneToOneMapping () const
	Broker should generate a one to one mapping for translations.
void	setOneToOneMapping (bool val)
virtual DtTime	pollingInterval () const
	Returns the interval, in seconds, between each call to drainInput() on the exercise connection.
void	setPollingInterval (DtTime pi)
DtString	logFileName () const
	Returns the name of the log file to use.
void	setLogFileName (DtString lfn)
virtual const std::vector < DtString > &	debuggedTranslators () const
	Returns a list of translators who's debugging is enabled.
virtual void	addDebuggedTranslator (const DtString &)
virtual void	removeDebuggedTranslator (const DtString &)
virtual void	setDebuggedTranslators (const std::set< DtString > &debuggedSet)
virtual const std::vector < DtString > &	disabledTranslatorSet () const
	Returns a list of translators who are disabled.
virtual void	addDisabledTranslator (const DtString &)
virtual void	removeDisabledTranslator (const DtString &)
virtual void	setDisabledTranslators (const std::set< DtString > &disabledSet)
bool	useGui () const
	Returns true if the broker can use a GUI.
bool	showConnectionInfoDialog () const
	Returns true if the broker is given the argument to show the connection info dialog on startup.
int	argc () const
	The argument count as passed in the CTOR.
char **	argv () const
	The argument list as passed in the CTOR.
DtCmdLine::CmdLine &	cmdLine ()
	Returns a reference to the CMD Line Object.
const std::vector < DtObjectFilter > &	objectFilters () const
	A list of all objects set for filtering in this broker.
virtual void	setObjectFilters (const std::vector< DtObjectFilter > &filters)
virtual void	addObjectFilter (const DtObjectFilter &filter)
virtual void	removeObjectFilter (const DtObjectFilter &filter)
DtString	fileName () const
	Returns the name of the file that this initializer refers to.

Protected Attributes
DtConfigVariable< bool > *	myShowInfoDialogFlag
DtConfigVariable< DtString > *	myMtlFileName
DtConfigVariable< DtString > *	myCmdLineBrokerName
DtConfigVariable< int > *	myCmdLineTcpPort
DtConfigVariable< int > *	myCmdLineNotifyLevel
DtConfigVariable< bool > *	myCmdLineDumpEnvFlag
DtConfigVariable< bool > *	myUseGuiFlag
DtConfigVariable< DtString > *	myLogFileName
DtConfigVariable< DtString > *	myControlQueueName
DtConfigVariable< DtString > *	myInteractionQueueName
DtConfigVariable< DtString > *	myObjectQueueName
DtConfigVariable< bool > *	myOneToOneTranslation
DtConfigVariable< int > *	myMaxControlMessages
DtConfigVariable< int > *	myMaxInterMessages
DtConfigVariable< int > *	myMaxObjectMessages
DtConfigVariable< DtTime > *	myPollingInterval
DtMultiConfigVariable< DtString > *	myDebuggedTranslators
DtMultiConfigVariable< DtString > *	myDisabledTranslators
DtMultiConfigVariable < DtObjectFilter > *	myFilterManagerConfig
int	myArgc
char **	myArgv
DtString	myProgramName
DtString	myVersionString
DtVRLApplicationSettings	mySettings

Private Member Functions
	DtBrokerInitializer (const DtBrokerInitializer &other)
	Copy CTOR not implemented, this class can not be copied yet.

Detailed Description

This class is used to initialize a DtBroker instance.

A class to initialize DtBroker instances.

Because brokers are used in standalone applications which are started by the portal, initial values come from both the command line and an MTL file. Much of the command line needs to be consistant between brokers, one such parameter is -l, the MTL file to read. This class will look for the -l command line and the file name that comes after it. That MTL file will then be processed. This class is defined in libBroker.

Examples

• Simple Broker Example

Constructor & Destructor Documentation

MAKVrExchange::DtBrokerInitializer::DtBrokerInitializer	(	int	argc,
		char **	argv,
		const char *	version
	)

Takes the command line arguments and the version of this broker in the form of a const char *.

virtual MAKVrExchange::DtBrokerInitializer::~DtBrokerInitializer ( )

virtual

Destructor.

MAKVrExchange::DtBrokerInitializer::DtBrokerInitializer ( const DtBrokerInitializer &  other )

private

Copy CTOR not implemented, this class can not be copied yet.

Member Function Documentation

DtBrokerInitializer& MAKVrExchange::DtBrokerInitializer::operator=

(

const DtBrokerInitializer &

other

)

Assignment Operator.

virtual void MAKVrExchange::DtBrokerInitializer::parseCmdLine ( )

virtual

Parse the command line.

This method will parse the command line and set values according to what options have been set on the command line. This should be called by the creator of this instance. In addition this will load the configuration file specified by the -l argument (broker.bcf by default)

virtual void MAKVrExchange::DtBrokerInitializer::loadFile ( )

virtual

Load a configuration file.

virtual void MAKVrExchange::DtBrokerInitializer::loadFile ( const DtString &  fileName )

virtual

virtual void MAKVrExchange::DtBrokerInitializer::saveFile ( )

virtual

Save a configuration file.

virtual void MAKVrExchange::DtBrokerInitializer::saveFile ( const DtString &  fileName )

virtual

DtString MAKVrExchange::DtBrokerInitializer::brokerName

(

)

const

The name of this broker.

Referenced by MAKVrExchange::DtBroker::brokerName().

int MAKVrExchange::DtBrokerInitializer::notifyLevel

(

)

const

The notify level of this broker.

void MAKVrExchange::DtBrokerInitializer::setNotifyLevel

(

int

nl

)

int MAKVrExchange::DtBrokerInitializer::tcpPort

(

)

const

The TCP port to use to maintain connectivity with the Data Exchange.

The Default is 5111, and setting this to 0 will disable this functionality.

void MAKVrExchange::DtBrokerInitializer::setTcpPort

(

int

port

)

Sets the TCP port.

bool MAKVrExchange::DtBrokerInitializer::dumpEnvironment

(

)

const

The broker can be configured to dump its known environment at startup.

This can be helpful in debugging.

void MAKVrExchange::DtBrokerInitializer::setDumpEnvironment

(

bool

shouldDumpEnv

)

int MAKVrExchange::DtBrokerInitializer::maxControlMessages

(

)

const

Returns the maximum number of control messages to read per tic.

void MAKVrExchange::DtBrokerInitializer::setMaxControlMessages

(

int

mcm

)

int MAKVrExchange::DtBrokerInitializer::maxInteractionMessages

(

)

const

Returns the maximum number of Interaction messages to read per tick.

void MAKVrExchange::DtBrokerInitializer::setMaxInteractionMessages

(

int

mim

)

int MAKVrExchange::DtBrokerInitializer::maxObjectMessages

(

)

const

Returns the maximum number of object messages to read per tick.

void MAKVrExchange::DtBrokerInitializer::setMaxObjectMessages

(

int

mom

)

DtString MAKVrExchange::DtBrokerInitializer::controlQueueName

(

)

const

Returns the queue names for each type of queue.

Queues are set through the command line by the portal that is controlling this broker.

DtString MAKVrExchange::DtBrokerInitializer::interactionQueueName

(

)

const

DtString MAKVrExchange::DtBrokerInitializer::objectQueueName

(

)

const

bool MAKVrExchange::DtBrokerInitializer::oneToOneMapping

(

)

const

Broker should generate a one to one mapping for translations.

void MAKVrExchange::DtBrokerInitializer::setOneToOneMapping

(

bool

val

)

virtual DtTime MAKVrExchange::DtBrokerInitializer::pollingInterval ( ) const

virtual

Returns the interval, in seconds, between each call to drainInput() on the exercise connection.

Referenced by MAKVrExchange::DtBroker::pollingInterval().

void MAKVrExchange::DtBrokerInitializer::setPollingInterval

(

DtTime

pi

)

DtString MAKVrExchange::DtBrokerInitializer::logFileName

(

)

const

Returns the name of the log file to use.

If the logFileName is "" then a file is not used for logging.

void MAKVrExchange::DtBrokerInitializer::setLogFileName

(

DtString

lfn

)

virtual const std::vector<DtString>& MAKVrExchange::DtBrokerInitializer::debuggedTranslators ( ) const

virtual

Returns a list of translators who's debugging is enabled.

This list of translator names is assembled by reading the broker's .mtl configuration file for the "debuggedTranslators" parameter.

Returns

A list of translator names.

virtual void MAKVrExchange::DtBrokerInitializer::addDebuggedTranslator ( const DtString &  )

virtual

virtual void MAKVrExchange::DtBrokerInitializer::removeDebuggedTranslator ( const DtString &  )

virtual

virtual void MAKVrExchange::DtBrokerInitializer::setDebuggedTranslators ( const std::set< DtString > &  debuggedSet )

virtual

virtual const std::vector<DtString>& MAKVrExchange::DtBrokerInitializer::disabledTranslatorSet ( ) const

virtual

Returns a list of translators who are disabled.

This list of translator names is assembled by reading the broker's .mtl configuration file for the "disabledTranslators" parameter.

Returns

A list of translator names.

virtual void MAKVrExchange::DtBrokerInitializer::addDisabledTranslator ( const DtString &  )

virtual

virtual void MAKVrExchange::DtBrokerInitializer::removeDisabledTranslator ( const DtString &  )

virtual

virtual void MAKVrExchange::DtBrokerInitializer::setDisabledTranslators ( const std::set< DtString > &  disabledSet )

virtual

bool MAKVrExchange::DtBrokerInitializer::useGui

(

)

const

Returns true if the broker can use a GUI.

This can be disabled via a command line argument or by not having the DISPLAY variable set.

bool MAKVrExchange::DtBrokerInitializer::showConnectionInfoDialog

(

)

const

Returns true if the broker is given the argument to show the connection info dialog on startup.

int MAKVrExchange::DtBrokerInitializer::argc

(

)

const

The argument count as passed in the CTOR.

char** MAKVrExchange::DtBrokerInitializer::argv

(

)

const

The argument list as passed in the CTOR.

DtCmdLine::CmdLine& MAKVrExchange::DtBrokerInitializer::cmdLine

(

)

Returns a reference to the CMD Line Object.

const std::vector< DtObjectFilter > & MAKVrExchange::DtBrokerInitializer::objectFilters ( ) const

inline

A list of all objects set for filtering in this broker.

References myFilterManagerConfig.

virtual void MAKVrExchange::DtBrokerInitializer::setObjectFilters ( const std::vector< DtObjectFilter > &  filters )

virtual

virtual void MAKVrExchange::DtBrokerInitializer::addObjectFilter ( const DtObjectFilter &  filter )

virtual

virtual void MAKVrExchange::DtBrokerInitializer::removeObjectFilter ( const DtObjectFilter &  filter )

virtual

DtString MAKVrExchange::DtBrokerInitializer::fileName ( ) const

inline

Returns the name of the file that this initializer refers to.

References myMtlFileName.

Member Data Documentation

DtConfigVariable<bool>* MAKVrExchange::DtBrokerInitializer::myShowInfoDialogFlag

protected

DtConfigVariable<DtString>* MAKVrExchange::DtBrokerInitializer::myMtlFileName

protected

Referenced by fileName().

DtConfigVariable<DtString>* MAKVrExchange::DtBrokerInitializer::myCmdLineBrokerName

protected

DtConfigVariable<int>* MAKVrExchange::DtBrokerInitializer::myCmdLineTcpPort

protected

DtConfigVariable<int>* MAKVrExchange::DtBrokerInitializer::myCmdLineNotifyLevel

protected

DtConfigVariable<bool>* MAKVrExchange::DtBrokerInitializer::myCmdLineDumpEnvFlag

protected

DtConfigVariable<bool>* MAKVrExchange::DtBrokerInitializer::myUseGuiFlag

protected

DtConfigVariable<DtString>* MAKVrExchange::DtBrokerInitializer::myLogFileName

protected

DtConfigVariable<DtString>* MAKVrExchange::DtBrokerInitializer::myControlQueueName

protected

DtConfigVariable<DtString>* MAKVrExchange::DtBrokerInitializer::myInteractionQueueName

protected

DtConfigVariable<DtString>* MAKVrExchange::DtBrokerInitializer::myObjectQueueName

protected

DtConfigVariable<bool>* MAKVrExchange::DtBrokerInitializer::myOneToOneTranslation

protected

DtConfigVariable<int>* MAKVrExchange::DtBrokerInitializer::myMaxControlMessages

protected

DtConfigVariable<int>* MAKVrExchange::DtBrokerInitializer::myMaxInterMessages

protected

DtConfigVariable<int>* MAKVrExchange::DtBrokerInitializer::myMaxObjectMessages

protected

DtConfigVariable<DtTime>* MAKVrExchange::DtBrokerInitializer::myPollingInterval

protected

DtMultiConfigVariable<DtString>* MAKVrExchange::DtBrokerInitializer::myDebuggedTranslators

protected

DtMultiConfigVariable<DtString>* MAKVrExchange::DtBrokerInitializer::myDisabledTranslators

protected

DtMultiConfigVariable<DtObjectFilter>* MAKVrExchange::DtBrokerInitializer::myFilterManagerConfig

protected

Referenced by objectFilters().

int MAKVrExchange::DtBrokerInitializer::myArgc

protected

char** MAKVrExchange::DtBrokerInitializer::myArgv

protected

DtString MAKVrExchange::DtBrokerInitializer::myProgramName

protected

DtString MAKVrExchange::DtBrokerInitializer::myVersionString

protected

DtVRLApplicationSettings MAKVrExchange::DtBrokerInitializer::mySettings

protected

---

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

• brokerInitializer.h