javax.telephony
Interface AddressListener

All Superinterfaces:

java.util.EventListener

All Known Subinterfaces:

ACDAddressListener, CallControlAddressListener, PrivateDataAddressListener

public interface AddressListener

extends java.util.EventListener

The AddressListener interface reports all changes which happen to the Address object.

Introduction

Such a state change is reported by a call to the method of this interface which corresponds to the type of state change that occurred. An event (an AddressEvent) which has an event ID which corresponds to the state change is passed as a parameter.

To receive all future events associated with an Address object, applications instantiate an object which implements this interface and then register their object as an Address Listener using the Address.addAddressListener() method.

The AddressListener methods each receive one event at a time.

Address Observation Ending

At various times, the underlying implementation may not be able to observe the Address. In these instances, the AddressListener is sent an event with event ID AddressEvent.ADDRESS_EVENT_TRANSMISSION_ENDED. This indicates that the application will not receive further events associated with the Address object. The listener is no longer reported via the Address.getAddressListeners() method.

See Also:

AddressEvent, Address

Method Summary

void	addressListenerEnded(AddressEvent event) The ADDRESS_EVENT_TRANSMISSION_ENDED event indicates that the application will no longer receive Address events on the instance of the AddressListener.

Method Detail

addressListenerEnded

public void addressListenerEnded(AddressEvent event)

The ADDRESS_EVENT_TRANSMISSION_ENDED event indicates that the application will no longer receive Address events on the instance of the AddressListener.

This constant indicates a specific event passed via a AddressEvent event, and is reported on the AddressListener interface.

See Also:

AddressEvent, Address