org.asteriskjava.manager.event.PeerStatusEvent Maven / Gradle / Ivy
/*
* 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 PeerStatusEvent is triggered when a SIP or IAX client attempts to registrer
* at this asterisk
* server.
*
* This event is implemented in channels/chan_iax2.c and
* channels/chan_sip.c
*
* @author srt
* @version $Id$
*/
public class PeerStatusEvent extends ManagerEvent {
private static final long serialVersionUID = 5483365205577897673L;
public static final String STATUS_REGISTERED = "Registered";
public static final String STATUS_UNREGISTERED = "Unregistered";
public static final String STATUS_REACHABLE = "Reachable";
public static final String STATUS_LAGGED = "Lagged";
public static final String STATUS_UNREACHABLE = "Unreachable";
public static final String STATUS_REJECTED = "Rejected";
private String channelType;
private String peer;
private String peerStatus;
private String cause;
private Integer time;
private String address;
private Integer port;
public PeerStatusEvent(Object source) {
super(source);
}
/**
* Returns the type of channel that registers, that is "IAX2" for an IAX2
* channel or "SIP" for a SIP channel.
*
* Available since Asterisk 1.6.
*
* @return the type of channel that registers.
* @since 1.0.0
*/
public String getChannelType() {
return channelType;
}
/**
* Sets the type of channel that registers.
*
* @param channelType
* the type of channel that registers
* @since 1.0.0
*/
public void setChannelType(String channelType) {
this.channelType = channelType;
}
/**
* Returns the name of the peer that registered.
*
* The peer name includes the channel type prefix. So if you receive a
* PeerStatusEvent for a SIP peer defined as "john" in sip.conf
* this method returns "SIP/john".
* Peer names for IAX clients start with "IAX2/", peer names for SIP clients
* start with "SIP/".
*
* @return the peer's name including the channel type.
*/
public String getPeer() {
return peer;
}
/**
* Sets the name of the peer that registered.
*
* @param peer
* peer
*/
public void setPeer(String peer) {
this.peer = peer;
}
/**
* Returns the registration state.
*
* This may be one of
*
* - Registered
* - Unregistered
* - Reachable
* - Lagged
* - Unreachable
* - Rejected (IAX only)
*
*
* @return status
*/
public String getPeerStatus() {
return peerStatus;
}
/**
* Sets the registration state.
*
* @param peerStatus
* status
*/
public void setPeerStatus(String peerStatus) {
this.peerStatus = peerStatus;
}
/**
* Returns the cause of a rejection or unregistration.
*
* For IAX peers this is set only if the status equals "Rejected".
*
* For SIP peers this is set if the status equals "Unregistered" and the
* peer was unregistered due to an expiration. In that case the cause is set
* to "Expired".
*
* @return the cause of a rejection or unregistration.
*/
public String getCause() {
return cause;
}
/**
* Sets the cause of the rejection or unregistration.
*
* @param cause
* cause
*/
public void setCause(String cause) {
this.cause = cause;
}
/**
* Returns the ping time of the client if status equals "Reachable" or
* "Lagged"; if the status
* equals "Unreachable" it returns how long the last response took (in ms)
* for IAX peers or -1
* for SIP peers.
*
* @return time
*/
public Integer getTime() {
return time;
}
public void setTime(Integer time) {
this.time = time;
}
/**
* Returns the IP address of the peer that registered. Only available for
* SIP channels.
*
* Available since Asterisk 1.6.
*
* @return the IP address of the peer that registered or null
* if not available.
* @since 1.0.0
*/
public String getAddress() {
return address;
}
public void setAddress(String address) {
this.address = address;
}
/**
* Returns the port of the peer that registered. Only available for SIP
* channels.
*
* Available since Asterisk 1.6.
*
* @return the port of the peer that registered or null if not
* available.
* @since 1.0.0
*/
public Integer getPort() {
return port;
}
public void setPort(Integer port) {
this.port = port;
}
}