org.asteriskjava.manager.event

Class ManagerEvent

java.lang.Object

java.util.EventObject

org.asteriskjava.manager.event.ManagerEvent

All Implemented Interfaces:

Serializable

Direct Known Subclasses:

AbstractAgentEvent, AbstractBridgeEvent, AbstractChannelEvent, AbstractFaxEvent, AbstractHoldEvent, AbstractMeetMeEvent, AbstractMixMonitorEvent, AbstractMonitorEvent, AbstractParkedCallEvent, AbstractQueueMemberEvent, AbstractRtcpEvent, AbstractRtpStatEvent, AgentCallbackLoginEvent, AgentCallbackLogoffEvent, AgentCalledEvent, AgentLoginEvent, AgentLogoffEvent, AgiExecEvent, AlarmClearEvent, AlarmEvent, BridgeEvent, BridgeExecEvent, BridgeMergeEvent, CdrEvent, CelEvent, ChallengeResponseFailedEvent, ChallengeSentEvent, ChannelReloadEvent, ChannelUpdateEvent, ChanSpyStartEvent, ChanSpyStopEvent, ConnectEvent, ContactStatusEvent, DAHDIChannelEvent, DeviceStateChangeEvent, DialEvent, DialStateEvent, DisconnectEvent, DndStateEvent, DongleCallStateChangeEvent, DongleCENDEvent, DongleNewCMGREvent, DongleNewSMSBase64Event, DongleNewSMSEvent, DongleStatusEvent, DtmfEvent, ExtensionStatusEvent, FullyBootedEvent, HoldedCallEvent, InvalidAccountId, InvalidPasswordEvent, JabberEventEvent, JitterBufStatsEvent, LocalBridgeEvent, LocalOptimizationBeginEvent, LocalOptimizationEndEvent, LogChannelEvent, MasqueradeEvent, MeetMeEndEvent, MessageWaitingEvent, ModuleLoadReportEvent, MusicOnHoldEvent, NewAccountCodeEvent, NewConnectedLineEvent, NewExtenEvent, PeerStatusEvent, PickupEvent, PriEventEvent, ProtocolIdentifierReceivedEvent, QueueEvent, QueueMemberPenaltyEvent, ReceiveFaxEvent, RegistryEvent, ReloadEvent, RenameEvent, RequestBadFormatEvent, ResponseEvent, ShutdownEvent, SkypeAccountStatusEvent, SkypeBuddyStatusEvent, SkypeChatMessageEvent, SuccessfulAuthEvent, TransferEvent, UserEvent, VarSetEvent

public abstract class ManagerEvent
extends EventObject

Abstract base class for all Events that can be received from the Asterisk server.
Events contain data pertaining to an event generated from within the Asterisk core or an extension module.
There is one concrete subclass of ManagerEvent per each supported Asterisk Event.

Version:

$Id$

Author:

srt

See Also:

Serialized Form

Field Summary

Fields

Modifier and Type	Field and Description
protected String	callerIdName
protected String	callerIdNum
protected Integer	channelState
protected String	channelStateDesc
protected String	connectedLineName
protected String	connectedLineNum
protected String	context
protected String	exten
protected Integer	priority

Fields inherited from class java.util.EventObject

source

Constructor Summary

Constructors

Constructor and Description
ManagerEvent(Object source)

Method Summary

Modifier and Type	Method and Description
protected void	appendPropertyIfNotNull(StringBuilder sb, String property, Object value)
String	getCallerIdName() Returns the Caller ID name of the caller's channel.
String	getCallerIdNum()
Integer	getChannelState()
String	getChannelStateDesc()
String	getConnectedLineName()
String	getConnectedLineNum()
String	getContext()
Date	getDateReceived() Returns the point in time this event was received from the Asterisk server.
String	getExten()
String	getFile() Returns the name of the file in Asterisk's source code that triggered this event.
String	getFunc() Returns the name of the C function in Asterisk's source code that triggered this event.
Integer	getLine() Returns the line number in Asterisk's source code where this event was triggered.
Integer	getPriority()
String	getPrivilege() Returns the AMI authorization class of this event.
Integer	getSequenceNumber() Returns the sequence numbers of this event.
String	getServer() Returns the name of the Asterisk server from which this event has been received.
String	getSystemName()
Double	getTimestamp() Returns the timestamp for this event.
void	setCallerIdName(String callerIdName)
void	setCallerIdNum(String callerIdNum)
void	setChannelState(Integer channelState)
void	setChannelStateDesc(String channelStateDesc)
void	setConnectedLineName(String connectedLineName)
void	setConnectedLineNum(String connectedLineNum)
void	setContext(String context)
void	setDateReceived(Date dateReceived) Sets the point in time this event was received from the asterisk server.
void	setExten(String exten)
void	setFile(String file)
void	setFunc(String func)
void	setLine(Integer line)
void	setPriority(Integer priority)
void	setPrivilege(String privilege) Sets the AMI authorization class of this event.
void	setSequenceNumber(Integer sequenceNumber)
void	setServer(String server) Sets the name of the Asterisk server from which this event has been received.
void	setSystemName(String systemName)
void	setTimestamp(Double timestamp) Sets the timestamp for this event.
String	toString()

Methods inherited from class java.util.EventObject

getSource

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait

Field Detail

connectedLineNum

protected String connectedLineNum

connectedLineName

protected String connectedLineName

priority

protected Integer priority

channelState

protected Integer channelState

channelStateDesc

protected String channelStateDesc

exten

protected String exten

callerIdNum

protected String callerIdNum

callerIdName

protected String callerIdName

context

protected String context

Constructor Detail

ManagerEvent

public ManagerEvent(Object source)

Method Detail

getCallerIdName

public String getCallerIdName()

Returns the Caller ID name of the caller's channel.

Returns:

the Caller ID name of the caller's channel or "unknown" if none has been set.

Since:

0.2

setCallerIdName

public void setCallerIdName(String callerIdName)

getConnectedLineNum

public String getConnectedLineNum()

setConnectedLineNum

public void setConnectedLineNum(String connectedLineNum)

getConnectedLineName

public String getConnectedLineName()

setConnectedLineName

public void setConnectedLineName(String connectedLineName)

getPriority

public Integer getPriority()

setPriority

public void setPriority(Integer priority)

getChannelState

public Integer getChannelState()

setChannelState

public void setChannelState(Integer channelState)

getChannelStateDesc

public String getChannelStateDesc()

setChannelStateDesc

public void setChannelStateDesc(String channelStateDesc)

getExten

public String getExten()

setExten

public void setExten(String exten)

getCallerIdNum

public String getCallerIdNum()

setCallerIdNum

public void setCallerIdNum(String callerIdNum)

getContext

public String getContext()

setContext

public void setContext(String context)

getDateReceived

public Date getDateReceived()

Returns the point in time this event was received from the Asterisk server.
Pseudo events that are not directly received from the asterisk server (for example ConnectEvent and DisconnectEvent) may return null.

setDateReceived

public void setDateReceived(Date dateReceived)

Sets the point in time this event was received from the asterisk server.

getPrivilege

public String getPrivilege()

Returns the AMI authorization class of this event.
This is one or more of system, call, log, verbose, command, agent or user. Multiple privileges are separated by comma.
Note: This property is not available from Asterisk 1.0 servers.

Since:

0.2

setPrivilege

public void setPrivilege(String privilege)

Sets the AMI authorization class of this event.

Since:

0.2

getTimestamp

public final Double getTimestamp()

Returns the timestamp for this event.
The timestamp property is available in Asterisk since 1.4 if enabled in manager.conf by setting timestampevents = yes.
In contains the time the event was generated in seconds since the epoch.
Example: 1159310429.569108

Returns:

the timestamp for this event.

Since:

0.3

setTimestamp

public final void setTimestamp(Double timestamp)

Sets the timestamp for this event.

Parameters:

timestamp - the timestamp to set.

Since:

0.3

getServer

public final String getServer()

Returns the name of the Asterisk server from which this event has been received.
This property is only available when using to AstManProxy.

Returns:

the name of the Asterisk server from which this event has been received or null when directly connected to an Asterisk server instead of AstManProxy.

Since:

1.0.0

setServer

public final void setServer(String server)

Sets the name of the Asterisk server from which this event has been received.

Parameters:

server - the name of the Asterisk server from which this event has been received.

Since:

1.0.0

getSystemName

public String getSystemName()

setSystemName

public void setSystemName(String systemName)

getFile

public String getFile()

Returns the name of the file in Asterisk's source code that triggered this event. For example pbx.c.

This property is only available if debugging for the Manager API has been turned on in Asterisk. This can be done by calling manager debug on on Asterisk's command line interface or by adding debug=on to Asterisk's manager.conf. This feature is availble in Asterisk since 1.6.0.

Returns:

the name of the file in that triggered this event or null if debgging is turned off.

Since:

1.0.0

See Also:

getFunc(), getLine()

setFile

public void setFile(String file)

getLine

public Integer getLine()

Returns the line number in Asterisk's source code where this event was triggered.

This property is only available if debugging for the Manager API has been turned on in Asterisk. This can be done by calling manager debug on on Asterisk's command line interface or by adding debug=on to Asterisk's manager.conf. This feature is availble in Asterisk since 1.6.0.

Returns:

the line number where this event was triggered or null if debgging is turned off.

Since:

1.0.0

See Also:

getFile(), getFunc()

setLine

public void setLine(Integer line)

getFunc

public String getFunc()

Returns the name of the C function in Asterisk's source code that triggered this event. For example pbx_builtin_setvar_helper

This property is only available if debugging for the Manager API has been turned on in Asterisk. This can be done by calling manager debug on on Asterisk's command line interface or by adding debug=on to Asterisk's manager.conf. This feature is availble in Asterisk since 1.6.0.

Returns:

the name of the C function that triggered this event or null if debgging is turned off.

Since:

1.0.0

See Also:

getFile(), getLine()

setFunc

public void setFunc(String func)

getSequenceNumber

public Integer getSequenceNumber()

Returns the sequence numbers of this event. Sequence numbers are only incremented while debugging is enabled.

This property is only available if debugging for the Manager API has been turned on in Asterisk. This can be done by calling manager debug on on Asterisk's command line interface or by adding debug=on to Asterisk's manager.conf. This feature is availble in Asterisk since 1.6.0.

Returns:

the sequence number of this event or null if debgging is turned off.

Since:

1.0.0

See Also:

getFile(), getLine()

setSequenceNumber

public void setSequenceNumber(Integer sequenceNumber)

toString

public String toString()

Overrides:

toString in class EventObject

appendPropertyIfNotNull

protected void appendPropertyIfNotNull(StringBuilder sb,
                                       String property,
                                       Object value)