org.asteriskjava.live

Interface AsteriskQueueMember

All Superinterfaces:

LiveObject

public interface AsteriskQueueMember
extends LiveObject

A queue member. Queue Member can be an agent or a direkt sip account, eg. a Phone.

PropertyChangeEvents are fired for the following properties:

• state
• paused
• penalty (since Asterisk 1.6)

Since:

0.3.1

Version:

$Id$

Author:

Patrick Breucking, itaqua

Field Summary

Fields

Modifier and Type	Field and Description
static String	PROPERTY_CALLSTAKEN
static String	PROPERTY_LASTCALL
static String	PROPERTY_PAUSED
static String	PROPERTY_PENALTY
static String	PROPERTY_STATE

Method Summary

Modifier and Type	Method and Description
Integer	getCallsTaken() total calls taken
Long	getLastCall() get the timestamp when the last call was terminated
String	getLocation() Returns the location of this member.
String	getMembership() Returns if this member has been dynamically added by the QueueAdd command (in the dialplan or via the Manager API) or if this member is has been statically defined in queues.conf.
boolean	getPaused() Deprecated. as of 1.0.0. Use isPaused() instead.
Integer	getPenalty() Returns the penalty of this member.
AsteriskQueue	getQueue() Returns the queue this member is registerd to.
QueueMemberState	getState() Returns the state of this member.
boolean	isDynamic() Convenience method that checks whether this member has been dynamically added by the QueueAdd command.
boolean	isPaused() Returns whether this member is currently paused..
boolean	isStatic() Convenience method that checks whether this member has been statically defined in queues.conf.
void	setPaused(boolean paused) Pauses or unpauses this member on this queue.
void	setPausedAll(boolean paused) Pauses or unpauses this member on all queues.
void	setPenalty(int penalty) Assignes a new penalty to this queue member.

Methods inherited from interface org.asteriskjava.live.LiveObject

addPropertyChangeListener, addPropertyChangeListener, getLastUpdateMillis, getServer, removePropertyChangeListener, removePropertyChangeListener

Field Detail

PROPERTY_STATE

static final String PROPERTY_STATE

See Also:

Constant Field Values

PROPERTY_PENALTY

static final String PROPERTY_PENALTY

See Also:

Constant Field Values

PROPERTY_PAUSED

static final String PROPERTY_PAUSED

See Also:

Constant Field Values

PROPERTY_CALLSTAKEN

static final String PROPERTY_CALLSTAKEN

See Also:

Constant Field Values

PROPERTY_LASTCALL

static final String PROPERTY_LASTCALL

See Also:

Constant Field Values

Method Detail

getLocation

String getLocation()

Returns the location of this member.

Returns:

the location of this member.

getQueue

AsteriskQueue getQueue()

Returns the queue this member is registerd to.

Returns:

the queue this member is registerd to.

getState

QueueMemberState getState()

Returns the state of this member.

Returns:

the state of this member.

getPaused

@Deprecated
boolean getPaused()

Deprecated. as of 1.0.0. Use isPaused() instead.

Returns whether this member is currently paused..

Returns:

paused true is this queue member is paused, false otherwise.

isPaused

boolean isPaused()

Returns whether this member is currently paused..

Returns:

paused true is this queue member is paused, false otherwise.

Since:

1.0.0

setPaused

void setPaused(boolean paused)
        throws ManagerCommunicationException,
               NoSuchInterfaceException

Pauses or unpauses this member on this queue.

Parameters:

paused - true to pause this member, false to unpause.

Throws:

ManagerCommunicationException - if the QueuePauseAction could not be send to Asterisk.

NoSuchInterfaceException - if the interface or the queue do not exist.

Since:

1.0.0

setPausedAll

void setPausedAll(boolean paused)
           throws ManagerCommunicationException,
                  NoSuchInterfaceException

Pauses or unpauses this member on all queues.

Parameters:

paused - true to pause this member, false to unpause.

Throws:

ManagerCommunicationException - if the QueuePauseAction could not be send to Asterisk.

NoSuchInterfaceException - if the interface or the queue do not exist.

Since:

1.0.0

getMembership

String getMembership()

Returns if this member has been dynamically added by the QueueAdd command (in the dialplan or via the Manager API) or if this member is has been statically defined in queues.conf.

Returns:

"dynamic" if the added member is a dynamic queue member, "static" if the added member is a static queue member.

Since:

1.0.0

isStatic

boolean isStatic()

Convenience method that checks whether this member has been statically defined in queues.conf.

Returns:

true if this member has been statically defined in queues.conf, false otherwise.

Since:

1.0.0

isDynamic

boolean isDynamic()

Convenience method that checks whether this member has been dynamically added by the QueueAdd command.

Returns:

true if this member has been dynamically added by the QueueAdd command, false otherwise.

Since:

1.0.0

getPenalty

Integer getPenalty()

Returns the penalty of this member.

Returns:

the penalty of this member.

Since:

1.0.0

setPenalty

void setPenalty(int penalty)
         throws IllegalArgumentException,
                ManagerCommunicationException,
                InvalidPenaltyException

Assignes a new penalty to this queue member.

Available since Asterisk 1.6.

Parameters:

penalty - the new penalty value, must not be negative.

Throws:

IllegalArgumentException - if the penalty is negative.

ManagerCommunicationException - if the QueuePenaltyAction could not be send to Asterisk.

InvalidPenaltyException - if Asterisk refused to set the new penalty.

Since:

1.0.0

getLastCall

Long getLastCall()

get the timestamp when the last call was terminated

Returns:

getCallsTaken

Integer getCallsTaken()

total calls taken

Returns: