javax.telephony
Interface CallObserver

All Known Subinterfaces:

CallCenterCallObserver, CallControlCallObserver, MediaCallObserver

Deprecated. As of JTAPI 1.4, replaced by CallListener

public interface CallObserver

The CallObserver interface reports all changes which happen to the Call object and all of the Connection and TerminalConnection objects which are part of the Call.

Introduction

These changes are reported as events to the CallObserver.callChangedEvent() method. Applications must instantiate an object which implements this interface and then add the observer to the call using one of several mechanisms described below to receive all future events associated with the Call and its Connections and TerminalConnections.

The CallObserver.callChangedEvent() method receives an array of events which all must extend the CallEv interface. Since several changes may happen to a single JTAPI object at once, a list of events is needed to convey those changes which happen at the same time. Applications iterate through the array of events provided.

Adding an Observer to a Call

Applications may add an observer to a Call via one of several mechanisms. They may directly add an observer via the Call.addObserver() method. Applications may also add observers to Calls indirectly via the Address.addCallObserver() and Terminal.addCallObserver() methods. These methods add the given observer to the Call when the Call comes to the Address or Terminal. See the specifications for Call, Address, and Terminal for more information.

Call State Changes

In the core package, an event is delivered whenever the Call changes state. The event interfaces which correspond to these state changes for the core package are: CallActiveEv and CallInvalidEv.

Connection Events

All events pertaining to the Connection object are reported on this interface. Connection events extend the ConnEv event, which in turn, extends the CallEv event. In the core package, an event is delivered to this interface whenever the Connection changes state.

TerminalConnection Events

All events pertaining to the TerminalConnection object are reported on this interface. TerminalConnection events extend the TermConnEv interface, which in turn, extends the CallEv interface. In the core package, an event is delivered to this interface whenever the TerminalConnection changes state.

Call Observation Ending

At various times, the underlying implementation may not be able to observe the Call. In these instances, the CallObserver is sent an CallObservationEndedEv event. This indicates that the application will not receive further events associated with the Call object. This observer is no longer reported via the Call.getObservers() method.

See Also:

CallEv, ConnEv, TermConnEv, CallObservationEndedEv, CallActiveEv, CallInvalidEv, ConnAlertingEv, ConnConnectedEv, ConnCreatedEv, ConnDisconnectedEv, ConnFailedEv, ConnInProgressEv, ConnUnknownEv, TermConnActiveEv, TermConnCreatedEv, TermConnDroppedEv, TermConnPassiveEv, TermConnRingingEv, TermConnUnknownEv

Method Summary

void	callChangedEvent(CallEv[] eventList) Deprecated. Reports all events associated with the Call object.

Method Detail

callChangedEvent

public void callChangedEvent(CallEv[] eventList)

Deprecated.

Reports all events associated with the Call object. This method passes an array of CallEv objects as its arguments which correspond to the list of events representing the changes to the Call object as well as changes to all of the Connection and TerminalConnection objects associated with this Call.

Parameters:

eventList - The list of Call events.