astxx::manager::action::events Class Reference

#include <astxx/manager/action/events.h>

Inheritance diagram for astxx::manager::action::events:

[legend]

Collaboration diagram for astxx::manager::action::events:

[legend]

List of all members.

---

Detailed Description

Set the event mask.

Definition at line 41 of file events.h.

Public Member Functions
message::action	action () const
	Format this command as a header for sending to Asterisk.
virtual void	action_id (const std::string &id)
	Set the ActionID for this action.
virtual std::string	action_id () const
	Get the ActionID for this action.
	events (bool mask)
	Set all events either on or off.
	events (const std::string &mask)
	Set the mask using a text mask.
	events (unsigned short mask)
	Set the mask using an integer mask.
virtual message::response	handle_response (message::response response)
	Handle a response from Asterisk.
message::response	operator() (connection &c)
	Send this action over this connection and handle the response.
Static Public Attributes
static const unsigned short	agent = 1 << 5
	Ability to read/set agent info.
static const unsigned short	call = 1 << 1
	Call event, such as state change, etc.
static const unsigned short	command = 1 << 4
	Ability to read/set commands.
static const unsigned short	config = 1 << 7
	Ability to modify configurations.
static const unsigned short	log = 1 << 2
	Log events.
static const unsigned short	system = 1 << 0
	System events such as module load/unload.
static const unsigned short	user = 1 << 6
	Ability to read/set user info.
static const unsigned short	verbose = 1 << 3
	Verbose messages.

---

Constructor & Destructor Documentation

astxx::manager::action::events::events

(

unsigned short

mask

)

[inline]

Set the mask using an integer mask.

Parameters:

mask

the integer mask

 events(events::system | events::call | events::log);

Definition at line 59 of file events.h.

astxx::manager::action::events::events

(

const std::string &

mask

)

[inline]

Set the mask using a text mask.

Parameters:

mask

the text mask

 events("system, call, log");

Definition at line 69 of file events.h.

astxx::manager::action::events::events

(

bool

mask

)

[inline]

Set all events either on or off.

Parameters:

mask

set events either on or off

 events(true);

Definition at line 79 of file events.h.

---

Member Function Documentation

message::action astxx::manager::action::events::action

(

)

const [inline, virtual]

Format this command as a header for sending to Asterisk.

This function is called by manager::connection::send_action() to get the data to send to Asterisk.

Returns:

a message::action message to send to Asterisk

Implements astxx::manager::basic_action.

Definition at line 82 of file events.h.

virtual std::string astxx::manager::basic_action::action_id

(

)

const [inline, virtual, inherited]

Get the ActionID for this action.

Returns:

the ActionID for this action.

Definition at line 62 of file basic_action.h.

Referenced by astxx::manager::action::status::action(), and astxx::manager::connection::send_action_async().

message::response astxx::manager::basic_action::handle_response

(

message::response

response

)

[virtual, inherited]

Handle a response from Asterisk.

Parameters:

response

the response to handle

This function is called from basic_action::operator()() and passed the response from Asterisk. This function may opt to throw exceptions if an error occours. The default implementation handles errors common to most manager actions. Overriding methods should call this method before processing the response if they would like to keep this error handling.

Returns:

the message::response we were passed

Exceptions:

	manager::permission_denied	on a permission error
	manager::authentication_required	on an authentication error
	manager::action::missing_data	if required data was not provided
	manager::action::bad_data	if the given data was invalid (invalid priority, channel, timeout...)
	manager::action::channel_not_found	if the given channel was not found

Reimplemented in astxx::manager::action::command, astxx::manager::action::getvar, and astxx::manager::action::login.

Definition at line 48 of file basic_action.cc.

References astxx::manager::basic_action::action().

Referenced by astxx::manager::action::login::handle_response(), astxx::manager::action::getvar::handle_response(), astxx::manager::action::command::handle_response(), and astxx::manager::basic_action::operator()().

message::response astxx::manager::basic_action::operator()

(

connection &

c

)

[inherited]

Send this action over this connection and handle the response.

Parameters:

c

the connection to use

This function sends this action over the give connection to Asterisk and then passes the response through basic_action::handle_response() before returning it. basic_action::handle_response() will throw exceptions for most common errors.

Returns:

the response from Asterisk

Definition at line 103 of file basic_action.cc.

References astxx::manager::basic_action::handle_response().

---

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

• include/astxx/manager/action/events.h