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
*
* @see org.asteriskjava.manager.action.QueueStatusAction
* @author srt
* @version $Id$
*/
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 String _interface;
/**
* @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.
*
* @deprecated since Asterisk 12
* @return the name of the member's interface.
*/
@Deprecated
final public String getLocation()
{
return _interface;
}
/**
* Sets the name of the member's interface.
*
* @deprecated since Asterisk 12
* @param member the name of the member's interface.
*/
@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;
}
}