org.mjsip.sip.call

Class CallListenerAdapter

java.lang.Object

org.mjsip.sip.call.CallListenerAdapter

All Implemented Interfaces:

CallListener, ExtendedCallListener

Direct Known Subclasses:

UserAgent

public abstract class CallListenerAdapter
extends java.lang.Object
implements ExtendedCallListener

Class CallListenerAdapter implements CallListener interface providing a dummy implementation of all Call callback functions used to capture Call events.

CallListenerAdapter can be extended to manage basic SIP calls. The callback methods defined in this class have basically a void implementation. This class exists as convenience for creating call listener objects.
You can extend this class overriding only methods corresponding to events you want to handle.

onCallInvite(NameAddress,String) is the only non-empty method. It signals the receiver the ring status (by using method Call.ring()), adapts the sdp body and accepts the call (by using method Call.accept(sdp)).

Constructor Summary

Constructors

Modifier	Constructor and Description
protected	CallListenerAdapter() Creates a new dummy call listener

Method Summary

Modifier and Type	Method and Description
void	onCallAccepted(Call call, java.lang.String sdp, SipMessage resp) Does nothing.
void	onCallAttendedTransfer(ExtendedCall call, NameAddress refer_to, NameAddress refered_by, java.lang.String replcall_id, SipMessage refer) Callback function called when arriving a new REFER method (transfer request) with Replaces header, replacing an existing call.
void	onCallBye(Call call, SipMessage bye) Does nothing.
void	onCallCancel(Call call, SipMessage cancel) Does nothing.
void	onCallClosed(Call call, SipMessage resp) Does nothing.
void	onCallConfirmed(Call call, java.lang.String sdp, SipMessage ack) Does nothing.
void	onCallInfo(Call call, java.lang.String info_package, java.lang.String content_type, byte[] body, SipMessage msg) Does nothing.
void	onCallInvite(Call call, NameAddress callee, NameAddress caller, java.lang.String sdp, SipMessage invite) Accepts an incoming call.
void	onCallModify(Call call, java.lang.String sdp, SipMessage invite) Changes the call when remotly requested.
void	onCallModifyAccepted(Call call, java.lang.String sdp, SipMessage resp) Does nothing.
void	onCallModifyRefused(Call call, java.lang.String reason, SipMessage resp) Does nothing.
void	onCallModifyTimeout(Call call) Does nothing.
void	onCallProgress(Call call, SipMessage resp) Does nothing.
void	onCallRedirected(Call call, java.lang.String reason, java.util.Vector contact_list, SipMessage resp) Redirects the call when remotly requested.
void	onCallRefused(Call call, java.lang.String reason, SipMessage resp) Does nothing.
void	onCallRinging(Call call, SipMessage resp) Does nothing.
void	onCallTimeout(Call call) Does nothing.
void	onCallTransfer(ExtendedCall call, NameAddress refer_to, NameAddress refered_by, SipMessage refer) Does nothing.
void	onCallTransferAccepted(ExtendedCall call, SipMessage resp) Does nothing.
void	onCallTransferFailure(ExtendedCall call, java.lang.String reason, SipMessage notify) Does nothing.
void	onCallTransferRefused(ExtendedCall call, java.lang.String reason, SipMessage resp) Does nothing.
void	onCallTransferSuccess(ExtendedCall call, SipMessage notify) Does nothing.
void	onCallUpdate(Call call, java.lang.String sdp, SipMessage update) From ExtendedCallListener.
void	onCallUpdateAccepted(Call call, java.lang.String sdp, SipMessage resp) Callback function called when arriving a 2xx for an UPDATE request
void	onCallUpdateRefused(Call call, java.lang.String sdp, SipMessage resp) Callback function called when arriving a non 2xx for an UPDATE request

Methods inherited from class java.lang.Object

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

Methods inherited from interface org.mjsip.sip.call.CallListener

onCallConfirmableProgress, onCallProgressConfirmed

Constructor Detail

CallListenerAdapter

protected CallListenerAdapter()

Creates a new dummy call listener

Method Detail

onCallInvite

public void onCallInvite(Call call,
                         NameAddress callee,
                         NameAddress caller,
                         java.lang.String sdp,
                         SipMessage invite)

Accepts an incoming call. Callback function called when arriving a new INVITE method (incoming call)

Specified by:

onCallInvite in interface CallListener

onCallModify

public void onCallModify(Call call,
                         java.lang.String sdp,
                         SipMessage invite)

Changes the call when remotly requested. Callback function called when arriving a new Re-INVITE method (re-inviting/call modify)

Specified by:

onCallModify in interface CallListener

onCallProgress

public void onCallProgress(Call call,
                           SipMessage resp)

Does nothing. Callback function called when arriving a 183 Session Progress

Specified by:

onCallProgress in interface CallListener

onCallRinging

public void onCallRinging(Call call,
                          SipMessage resp)

Does nothing. Callback function called when arriving a 180 Ringing

Specified by:

onCallRinging in interface CallListener

onCallAccepted

public void onCallAccepted(Call call,
                           java.lang.String sdp,
                           SipMessage resp)

Does nothing. Callback function called when arriving a 2xx (call accepted)

Specified by:

onCallAccepted in interface CallListener

onCallRefused

public void onCallRefused(Call call,
                          java.lang.String reason,
                          SipMessage resp)

Does nothing. Callback function called when arriving a 4xx (call failure)

Specified by:

onCallRefused in interface CallListener

onCallRedirected

public void onCallRedirected(Call call,
                             java.lang.String reason,
                             java.util.Vector contact_list,
                             SipMessage resp)

Redirects the call when remotly requested. Callback function called when arriving a 3xx (call redirection)

Specified by:

onCallRedirected in interface CallListener

onCallConfirmed

public void onCallConfirmed(Call call,
                            java.lang.String sdp,
                            SipMessage ack)

Does nothing. Callback function called when arriving an ACK method (call confirmed)

Specified by:

onCallConfirmed in interface CallListener

onCallInfo

public void onCallInfo(Call call,
                       java.lang.String info_package,
                       java.lang.String content_type,
                       byte[] body,
                       SipMessage msg)

Does nothing. Callback function called when arriving an INFO method.

Specified by:

onCallInfo in interface CallListener

onCallTimeout

public void onCallTimeout(Call call)

Does nothing. Callback function called when the invite expires

Specified by:

onCallTimeout in interface CallListener

onCallModifyAccepted

public void onCallModifyAccepted(Call call,
                                 java.lang.String sdp,
                                 SipMessage resp)

Does nothing. Callback function called when arriving a 2xx (re-invite/modify accepted)

Specified by:

onCallModifyAccepted in interface CallListener

onCallModifyRefused

public void onCallModifyRefused(Call call,
                                java.lang.String reason,
                                SipMessage resp)

Does nothing. Callback function called when arriving a 4xx (re-invite/modify failure)

Specified by:

onCallModifyRefused in interface CallListener

onCallModifyTimeout

public void onCallModifyTimeout(Call call)

Does nothing. Callback function called when a re-invite expires

Specified by:

onCallModifyTimeout in interface CallListener

onCallCancel

public void onCallCancel(Call call,
                         SipMessage cancel)

Does nothing. Callback function called when arriving a CANCEL request

Specified by:

onCallCancel in interface CallListener

onCallBye

public void onCallBye(Call call,
                      SipMessage bye)

Does nothing. Callback function that may be overloaded (extended). Called when arriving a BYE request

Specified by:

onCallBye in interface CallListener

onCallClosed

public void onCallClosed(Call call,
                         SipMessage resp)

Does nothing. Callback function that may be overloaded (extended). Called when arriving a response for a BYE request (call closed)

Specified by:

onCallClosed in interface CallListener

onCallUpdate

public void onCallUpdate(Call call,
                         java.lang.String sdp,
                         SipMessage update)

From ExtendedCallListener. Callback function called when arriving a new UPDATE method (update request).

Specified by:

onCallUpdate in interface CallListener

onCallUpdateAccepted

public void onCallUpdateAccepted(Call call,
                                 java.lang.String sdp,
                                 SipMessage resp)

Callback function called when arriving a 2xx for an UPDATE request

Specified by:

onCallUpdateAccepted in interface CallListener

onCallUpdateRefused

public void onCallUpdateRefused(Call call,
                                java.lang.String sdp,
                                SipMessage resp)

Callback function called when arriving a non 2xx for an UPDATE request

Specified by:

onCallUpdateRefused in interface CallListener

onCallTransfer

public void onCallTransfer(ExtendedCall call,
                           NameAddress refer_to,
                           NameAddress refered_by,
                           SipMessage refer)

Does nothing. Callback function called when arriving a new REFER method (transfer request)

Specified by:

onCallTransfer in interface ExtendedCallListener

onCallAttendedTransfer

public void onCallAttendedTransfer(ExtendedCall call,
                                   NameAddress refer_to,
                                   NameAddress refered_by,
                                   java.lang.String replcall_id,
                                   SipMessage refer)

Callback function called when arriving a new REFER method (transfer request) with Replaces header, replacing an existing call.

Specified by:

onCallAttendedTransfer in interface ExtendedCallListener

onCallTransferAccepted

public void onCallTransferAccepted(ExtendedCall call,
                                   SipMessage resp)

Does nothing. Callback function called when a call transfer is accepted.

Specified by:

onCallTransferAccepted in interface ExtendedCallListener

onCallTransferRefused

public void onCallTransferRefused(ExtendedCall call,
                                  java.lang.String reason,
                                  SipMessage resp)

Does nothing. Callback function called when a call transfer is refused.

Specified by:

onCallTransferRefused in interface ExtendedCallListener

onCallTransferSuccess

public void onCallTransferSuccess(ExtendedCall call,
                                  SipMessage notify)

Does nothing. Callback function called when a call transfer is successfully completed

Specified by:

onCallTransferSuccess in interface ExtendedCallListener

onCallTransferFailure

public void onCallTransferFailure(ExtendedCall call,
                                  java.lang.String reason,
                                  SipMessage notify)

Does nothing. Callback function called when a call transfer is NOT sucessfully completed

Specified by:

onCallTransferFailure in interface ExtendedCallListener