#include <qmf/AgentSession.h>

Public Member Functions
	AgentSession (AgentSessionImpl *impl=0)
	AgentSession (const AgentSession &)
AgentSession &	operator= (const AgentSession &)
	~AgentSession ()
	AgentSession (qpid::messaging::Connection &conn, const std::string &options="")
	AgentSession A session that runs over an AMQP connection for QMF agent operation.
void	setDomain (const std::string &domain)
	setDomain - Change the QMF domain that this agent will operate in.
void	setVendor (const std::string &vendor)
	Set identifying attributes of this agent.
void	setProduct (const std::string &product)
void	setInstance (const std::string &instance)
void	setAttribute (const std::string &key, const qpid::types::Variant &value)
	setAttribute - Set an arbitrary attribute for this agent.
const std::string &	getName () const
	Get the identifying name of the agent.
void	open ()
	Open the agent session.
void	close ()
	Close the session.
bool	nextEvent (AgentEvent &outEvent, qpid::messaging::Duration timeout=qpid::messaging::Duration::FOREVER)
	Get the next event from the agent session.
int	pendingEvents () const
	Return the number of events pending for nextEvent.
void	registerSchema (Schema &schema)
	Register a schema to be exposed by this agent.
DataAddr	addData (Data &data, const std::string &name="", bool persistent=false)
	Add data to be managed internally by the agent.
void	delData (const DataAddr &dataAddr)
	Delete data from internal agent management.
void	authAccept (AgentEvent &event)
	The following methods are used to respond to events received in nextEvent.
void	authReject (AgentEvent &event, const std::string &diag="")
void	raiseException (AgentEvent &event, const std::string &errorText)
void	raiseException (AgentEvent &event, const Data &errorData)
void	response (AgentEvent &event, const Data &responseData)
void	complete (AgentEvent &event)
void	methodSuccess (AgentEvent &event)
void	raiseEvent (const Data &data)
	Raise an event to be sent into the QMF network.
void	raiseEvent (const Data &data, int severity)
QMF_INLINE_EXTERN bool	isValid () const
QMF_INLINE_EXTERN bool	isNull () const
QMF_INLINE_EXTERN	operator bool () const
	Conversion to bool supports idiom if (handle) { handle->...
QMF_INLINE_EXTERN bool	operator! () const
	Operator ! supports idiom if (!handle) { do_if_handle_is_null(); }.
void	swap (Handle< T > &h)
Protected Types
typedef T	Impl
Protected Attributes
Impl *	impl

Member Typedef Documentation

typedef T qmf::Handle::Impl [protected, inherited]

Definition at line 56 of file Handle.h.

Constructor & Destructor Documentation

qmf::AgentSession::AgentSession ( AgentSessionImpl * impl = 0 )

qmf::AgentSession::AgentSession ( const AgentSession & )

qmf::AgentSession::~AgentSession ( )

qmf::AgentSession::AgentSession	(	qpid::messaging::Connection &	conn,
		const std::string &	options = `""`
	)

AgentSession A session that runs over an AMQP connection for QMF agent operation.

Parameters:

connection	- An opened qpid::messaging::Connection
options	- An optional string containing options

The options string is of the form "{key:value,key:value}". The following keys are supported:

interval:N - Heartbeat interval in seconds [default: 60] external:{True,False} - Use external data storage (queries and subscriptions are pass-through) [default: False] allow-queries:{True,False} - If True: automatically allow all queries [default] If False: generate an AUTH_QUERY event to allow per-query authorization allow-methods:{True,False} - If True: automatically allow all methods [default] If False: generate an AUTH_METHOD event to allow per-method authorization max-subscriptions:N - Maximum number of concurrent subscription queries permitted [default: 64] min-sub-interval:N - Minimum publish interval (in milliseconds) permitted for a subscription [default: 3000] sub-lifetime:N - Lifetime (in seconds with no keepalive) for a subscription [default: 300] public-events:{True,False} - If True: QMF events are sent to the topic exchange [default] If False: QMF events are only sent to authorized subscribers listen-on-direct:{True,False} - If True: Listen on legacy direct-exchange address for backward compatibility [default] If False: Listen only on the routable direct address strict-security:{True,False} - If True: Cooperate with the broker to enforce strict access control to the network

If False: Operate more flexibly with regard to use of messaging facilities [default] max-thread-wait-time:N - Time (in seconds) the session thread will wait for messages from the network between periodic background processing passes. [default: 5] Must not be greater than 'interval'. Larger numbers will cause fewer wake-ups but will increase the time it takes to shut down the process. This setting will not affect the agent's response time for queries or method invocation.

Member Function Documentation

DataAddr qmf::AgentSession::addData	(	Data &	data,
		const std::string &	name = `""`,
		bool	persistent = `false`
	)

Add data to be managed internally by the agent.

If the option external:True is selected, this call should not be used.

Parameters:

data	- The data object being managed by the agent.
name	- A name unique to this object to be used to address the object. If left default, a unique name will be assigned by the agent.
persistent	- Set this to true if the data object is to be considered persistent across different sessions. If persistent, it is the agent application's responsibility to ensure the name is the same each time it is added.

void qmf::AgentSession::authAccept ( AgentEvent & event )

The following methods are used to respond to events received in nextEvent.

authAccept - Accept an authorization request. authReject - Reject/forbid an authorization request. raiseException - indicate failure of an operation (i.e. query or method call). response - Provide data in response to a query (only for option: external:True) complete - Indicate that the response to a query is complete (external:True only) methodSuccess - Indicate the successful completion of a method call.

void qmf::AgentSession::authReject	(	AgentEvent &	event,
		const std::string &	diag = `""`
	)

void qmf::AgentSession::close ( )

Close the session.

Once closed, the session no longer communicates on the messaging network.

void qmf::AgentSession::complete ( AgentEvent & event )

void qmf::AgentSession::delData ( const DataAddr & dataAddr )

Delete data from internal agent management.

const std::string& qmf::AgentSession::getName ( ) const

Get the identifying name of the agent.

QMF_INLINE_EXTERN bool qmf::Handle::isNull ( ) const [inline, inherited]

Returns:: true if handle is null. It is an error to call any function on a null handle.

Definition at line 45 of file Handle.h.

QMF_INLINE_EXTERN bool qmf::Handle::isValid ( ) const [inline, inherited]

Returns:: true if handle is valid, i.e. not null.

Definition at line 42 of file Handle.h.

void qmf::AgentSession::methodSuccess ( AgentEvent & event )

bool qmf::AgentSession::nextEvent	(	AgentEvent &	outEvent,
		qpid::messaging::Duration	timeout = `qpid::messaging::Duration::FOREVER`
	)

Get the next event from the agent session.

Events represent actions that must be acted upon by the agent application. This method blocks for up to the timeout if there are no events to be handled. This method will typically be the focus of the agent application's main execution loop. If the timeout is set to Duration::IMMEDIATE, the call will not block.

void qmf::AgentSession::open ( )

Open the agent session.

After opening the session, the domain, identifying strings, and attributes cannot be changed.

QMF_INLINE_EXTERN qmf::Handle::operator bool ( ) const [inline, inherited]

Conversion to bool supports idiom if (handle) { handle->...

}

Definition at line 48 of file Handle.h.

QMF_INLINE_EXTERN bool qmf::Handle::operator! ( ) const [inline, inherited]

Operator ! supports idiom if (!handle) { do_if_handle_is_null(); }.

Definition at line 51 of file Handle.h.

AgentSession& qmf::AgentSession::operator= ( const AgentSession & )

int qmf::AgentSession::pendingEvents ( ) const

Return the number of events pending for nextEvent.

This method will never block.

void qmf::AgentSession::raiseEvent ( const Data & data )

Raise an event to be sent into the QMF network.

Parameters:

data	- A data object that contains the event contents.
severity	- Explicit severity (from qmf/SchemaTypes.h). If omitted, the severity is set to the default severity for the data's schema. If the data has no schema, the severity defaults to SEV_NOTICE.

void qmf::AgentSession::raiseEvent	(	const Data &	data,
		int	severity
	)

void qmf::AgentSession::raiseException	(	AgentEvent &	event,
		const std::string &	errorText
	)

void qmf::AgentSession::raiseException	(	AgentEvent &	event,
		const Data &	errorData
	)

void qmf::AgentSession::registerSchema ( Schema & schema )

Register a schema to be exposed by this agent.

void qmf::AgentSession::response	(	AgentEvent &	event,
		const Data &	responseData
	)

void qmf::AgentSession::setAttribute	(	const std::string &	key,
		const qpid::types::Variant &	value
	)

setAttribute - Set an arbitrary attribute for this agent.

The attributes are not used to uniquely identify the agent but can be used as a search criteria when looking for agents. This must be called prior to opening the agent session.

void qmf::AgentSession::setDomain ( const std::string & domain )

setDomain - Change the QMF domain that this agent will operate in.

If this is not called, the domain will be "default". Agents in a domain can be seen only by consoles in the same domain. This must be called prior to opening the agent session.

void qmf::AgentSession::setInstance ( const std::string & instance )

void qmf::AgentSession::setProduct ( const std::string & product )

void qmf::AgentSession::setVendor ( const std::string & vendor )

Set identifying attributes of this agent.

setVendor - Set the vendor string setProduct - Set the product name string setInstance - Set the unique instance name (if not set, a UUID will be assigned) These must be called prior to opening the agent session.

void qmf::Handle::swap ( Handle< T > & h ) [inline, inherited]

Definition at line 53 of file Handle.h.

Member Data Documentation

Impl* qmf::Handle::impl [protected, inherited]

Definition at line 63 of file Handle.h.

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

qmf/AgentSession.h

Public Member Functions

Protected Types

Protected Attributes

Member Typedef Documentation

Constructor & Destructor Documentation

Member Function Documentation

Member Data Documentation