org.asteriskjava.manager.event.QueueMemberEvent Maven / Gradle / Ivy
Show all versions of asterisk-java Show documentation
/*
* Copyright 2004-2006 Stefan Reuter
*
* Licensed under the Apache License, Version 2.0 (the "License");
* you may not use this file except in compliance with the License.
* You may obtain a copy of the License at
*
* http://www.apache.org/licenses/LICENSE-2.0
*
* Unless required by applicable law or agreed to in writing, software
* distributed under the License is distributed on an "AS IS" BASIS,
* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
* See the License for the specific language governing permissions and
* limitations under the License.
*
*/
package org.asteriskjava.manager.event;
/**
* A QueueMemberEvent is triggered in response to a QueueStatusAction and
* contains information about a member of a queue.
*
* It is implemented in apps/app_queue.c
*
* @author srt
* @version $Id$
* @see org.asteriskjava.manager.action.QueueStatusAction
*/
public class QueueMemberEvent extends ResponseEvent {
public static final int AST_DEVICE_UNKNOWN = 0;
/**
* Queue member is available.
*/
public static final int AST_DEVICE_NOT_INUSE = 1;
public static final int AST_DEVICE_INUSE = 2;
public static final int AST_DEVICE_BUSY = 3;
public static final int AST_DEVICE_INVALID = 4;
public static final int AST_DEVICE_UNAVAILABLE = 5;
public static final int AST_DEVICE_RINGING = 6;
public static final int AST_DEVICE_RINGINUSE = 7;
public static final int AST_DEVICE_ONHOLD = 8;
public static final String MEMBERSHIP_STATIC = "static";
public static final String MEMBERSHIP_DYNAMIC = "dynamic";
/**
* Serializable version identifier.
*/
private static final long serialVersionUID = 0L;
private String queue;
@SuppressWarnings("unused")
private String location;
private String membership;
private String name;
private Integer penalty;
private Integer callsTaken;
private Long lastCall;
private Long lastPause;
private Integer status;
private Boolean paused;
private String stateinterface;
private Integer incall;
private String pausedreason;
private Integer wrapuptime;
private String _interface;
private Integer logintime;
/**
* @param source
*/
public QueueMemberEvent(Object source) {
super(source);
}
/**
* Returns the name of the queue.
*
* @return the name of the queue.
*/
public String getQueue() {
return queue;
}
/**
* Sets the name of the queue.
*
* @param queue the name of the queue.
*/
public void setQueue(String queue) {
this.queue = queue;
}
/**
* Returns the name of the member's interface.
*
* E.g. the channel name or agent group.
*
* @return the name of the member's interface.
*/
final public String getInterface() {
return _interface;
}
/**
* Sets the name of the member's interface.
*
* @param member the name of the member's interface.
*/
final public void setInterface(String _interface) {
this._interface = _interface;
}
/**
* Returns the name of the member's interface.
*
* E.g. the channel name or agent group.
*
* @return the name of the member's interface.
* @deprecated since Asterisk 12
*/
@Deprecated
final public String getLocation() {
return _interface;
}
/**
* Sets the name of the member's interface.
*
* @param member the name of the member's interface.
* @deprecated since Asterisk 12
*/
@Deprecated
final public void setLocation(String _interface) {
if ((_interface != null) && (!"null".equals(_interface))) { // Location is not in use since asterisk 12
this._interface = _interface;
}
}
/**
* 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.
*
* @return "dynamic" if the added member is a dynamic queue member, "static"
* if the added member is a static queue member.
*/
public String getMembership() {
return membership;
}
/**
* Convenience method that checks whether this member has been statically
* defined in queues.conf.
*
* @return true if this member has been statically defined in
* queues.conf, false otherwise.
* @since 0.3
*/
public boolean isStatic() {
return MEMBERSHIP_STATIC.equals(membership);
}
/**
* Convenience method that checks whether this member has been dynamically
* added by the QueueAdd command.
*
* @return true if this member has been dynamically added by
* the QueueAdd command, false otherwise.
* @since 0.3
*/
public boolean isDynamic() {
return MEMBERSHIP_DYNAMIC.equals(membership);
}
/**
* Sets if this member has been dynamically or statically added.
*
* @param membership "dynamic" if the added member is a dynamic queue
* member, "static" if the added member is a static queue member.
*/
public void setMembership(String membership) {
this.membership = membership;
}
/**
* Returns the penalty for the added member. When calls are distributed
* members with higher penalties are considered last.
*
* @return the penalty for the added member.
*/
public Integer getPenalty() {
return penalty;
}
/**
* Sets the penalty for this member.
*
* @param penalty the penalty for this member.
*/
public void setPenalty(Integer penalty) {
this.penalty = penalty;
}
/**
* Returns the number of calls answered by the member.
*
* @return the number of calls answered by the member.
*/
public Integer getCallsTaken() {
return callsTaken;
}
/**
* Sets the number of calls answered by the added member.
*
* @param callsTaken the number of calls answered by the added member.
*/
public void setCallsTaken(Integer callsTaken) {
this.callsTaken = callsTaken;
}
/**
* Returns the time the last successful call answered by the added member
* was hungup.
*
* @return the time (in seconds since 01/01/1970) the last successful call
* answered by the added member was hungup.
*/
public Long getLastCall() {
return lastCall;
}
/**
* Sets the time the last successful call answered by this member was
* hungup.
*
* @param lastCall the time (in seconds since 01/01/1970) the last
* successful call answered by the added member was hungup.
*/
public void setLastCall(Long lastCall) {
this.lastCall = lastCall;
}
/**
* The time when started last pause for queue member.
*
* @return the time (in seconds since 01/01/1970)
*/
public Long getLastPause() {
return lastPause;
}
/**
* Sets the time when started last pause for queue member.
*
* @param lastPause the time (in seconds since 01/01/1970)
*/
public void setLastPause(Long lastPause) {
this.lastPause = lastPause;
}
/**
* Returns the status of this queue member.
*
* Available since Asterisk 1.2
*
* Valid status codes are:
*
* - AST_DEVICE_UNKNOWN (0)
* - Device valid but unknown channel state
* - AST_DEVICE_NOT_INUSE (1)
* - Device is not used
* - AST_DEVICE_INUSE (2)
* - Device is in use
* - AST_DEVICE_BUSY (3)
* - Device is Busy
* - AST_DEVICE_INVALID (4)
* - Device is invalid
* - AST_DEVICE_UNAVAILABLE (5)
* - Device is unavaiable
* - AST_DEVICE_RINGING (6)
* - Device is ringing
* - AST_DEVICE_RINGINUSE (7)
* - Device is ringing and in use
* - AST_DEVICE_ONHOLD (8)
* - Device is on hold
*
*
* @return the status of this queue member or null if this
* attribute is not supported by your version of Asterisk.
* @since 0.2
*/
public Integer getStatus() {
return status;
}
/**
* Sets the status of this queue member.
*
* @param status the status of this queue member
* @since 0.2
*/
public void setStatus(Integer status) {
this.status = status;
}
/**
* Is this queue member paused (not accepting calls)?
*
* Available since Asterisk 1.2.
*
* @return Boolean.TRUE if this member has been paused,
* Boolean.FALSE if not or null if pausing
* is not supported by your version of Asterisk.
* @since 0.2
*/
public Boolean getPaused() {
return paused;
}
/**
* Sets if this member has been paused.
*
* @since 0.2
*/
public void setPaused(Boolean paused) {
this.paused = paused;
}
/**
* Returns the name of the member.
*
* @return the name of the member supplied for logging when the member is
* added
* @since 1.0.0
*/
public String getName() {
return name;
}
public void setName(String name) {
this.name = name;
}
/**
* Returns the name of the member.
*
* @return the name of the member supplied for logging when the member is
* added
* @deprecated since 1.0.0. Use {@link #getName()} instead.
*/
@Deprecated
public String getMemberName() {
return name;
}
// Renamed to "name" in Asterisk 1.6
public void setMemberName(String memberName) {
this.name = memberName;
}
/**
* @return Name of the interface where device state is taken from.
*/
public String getStateinterface() {
return stateinterface;
}
public void setStateinterface(String stateinterface) {
this.stateinterface = stateinterface;
}
/**
* @return 1 if is incall 0 if not
*/
public Integer getIncall() {
return incall;
}
public void setIncall(Integer incall) {
this.incall = incall;
}
public String getPausedreason() {
return pausedreason;
}
public void setPausedreason(String pausedreason) {
this.pausedreason = pausedreason;
}
public Integer getWrapuptime() {
return wrapuptime;
}
public void setWrapuptime(Integer wrapuptime) {
this.wrapuptime = wrapuptime;
}
public Integer getLogintime() {
return logintime;
}
public void setLogintime(Integer logintime) {
this.logintime = logintime;
}
}