javax.telephony
Interface TerminalObserver

All Known Subinterfaces:

AgentTerminalObserver, CallControlTerminalObserver, PhoneTerminalObserver

Deprecated. As of JTAPI 1.4, replaced by TerminalListener

public interface TerminalObserver

The TerminalObserver interface reports all changes which happen to the Terminal object.

Introduction

These changes are reported as events to the TerminalObserver.terminalChangedEvent() method. Applications must instantiate an object which implements this interface and then use the Terminal.addObserver()) method to register the object to receive all future events associated with the Terminal object.

The TerminalObserver.terminalChangedEvent() method receives an array of events which all must extend the TermEv 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.

Terminal Observation Ending

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

See Also:

TermEv, TermObservationEndedEv

Method Summary

void	terminalChangedEvent(TermEv[] eventList) Deprecated. Reports all events associated with the Terminal object.

Method Detail

terminalChangedEvent

public void terminalChangedEvent(TermEv[] eventList)

Deprecated.

Reports all events associated with the Terminal object. This method passes an array of TermEv objects as its arguments which correspond to the list of events representing the changes to the Terminal object.

Parameters:

eventList - The list of Terminal events.