javax.telephony.callcontrol.events
Interface CallCtlCallEv

All Superinterfaces:

CallCtlEv, CallEv, Ev

All Known Subinterfaces:

CallCtlConnAlertingEv, CallCtlConnDialingEv, CallCtlConnDisconnectedEv, CallCtlConnEstablishedEv, CallCtlConnEv, CallCtlConnFailedEv, CallCtlConnInitiatedEv, CallCtlConnNetworkAlertingEv, CallCtlConnNetworkReachedEv, CallCtlConnOfferedEv, CallCtlConnQueuedEv, CallCtlConnUnknownEv, CallCtlTermConnBridgedEv, CallCtlTermConnDroppedEv, CallCtlTermConnEv, CallCtlTermConnHeldEv, CallCtlTermConnInUseEv, CallCtlTermConnRingingEv, CallCtlTermConnTalkingEv, CallCtlTermConnUnknownEv, ITsapiConnNetworkReachedEvent, LucentConnNetworkReachedEvent

public interface CallCtlCallEv

extends CallCtlEv, CallEv

The CallCtlCallEv interface is the base interface for all call control package Call-related events. All events which pertain to the CallControlCall interface must extend this interface. Events which extend this interface are reported via the CallObserver.callChangedEvent() method. The observer object must also implement the CallControlCallObserver interface to signal it is interested in call control package events. This interface extend both the CallCtlEv and core CallEv interfaces.

The CallCtlConnEv and CallCtlTermConnEv events extend this interface. This reflects the fact that all events pertaining to the CallControlConnection interface and the CallControlTerminalConnection interface are reported via the CallControlCallObserver interface.

Additional Call Information

This interface supports methods which return additional information regarding the telephone call. Specifically, it returns the calling address, calling terminal, called address, and last redirected address information. This information is returned by the getCallingAddress(), getCallingTerminal(), getCalledAddress(), and getLastRedirectedAddress() methods on this interface, respectively.

Avaya is providing its backward-compatible Observer model implementation in this release; in the specification this interface is deprecated as of JTAPI 1.4, replaced by CallControlCallEvent

See Also:

Call, Address, Terminal, CallObserver, CallEv, CallControlCall, CallControlCallObserver, CallCtlEv, CallCtlConnEv, CallCtlTermConnEv

Field Summary

Fields inherited from interface javax.telephony.callcontrol.events.CallCtlEv

CAUSE_ALTERNATE, CAUSE_BUSY, CAUSE_CALL_BACK, CAUSE_CALL_NOT_ANSWERED, CAUSE_CALL_PICKUP, CAUSE_CONFERENCE, CAUSE_DO_NOT_DISTURB, CAUSE_PARK, CAUSE_REDIRECTED, CAUSE_REORDER_TONE, CAUSE_TRANSFER, CAUSE_TRUNKS_BUSY, CAUSE_UNHOLD

Fields inherited from interface javax.telephony.events.Ev

CAUSE_CALL_CANCELLED, CAUSE_DEST_NOT_OBTAINABLE, CAUSE_INCOMPATIBLE_DESTINATION, CAUSE_LOCKOUT, CAUSE_NETWORK_CONGESTION, CAUSE_NETWORK_NOT_OBTAINABLE, CAUSE_NEW_CALL, CAUSE_NORMAL, CAUSE_RESOURCES_NOT_AVAILABLE, CAUSE_SNAPSHOT, CAUSE_UNKNOWN, META_CALL_ADDITIONAL_PARTY, META_CALL_ENDING, META_CALL_MERGING, META_CALL_PROGRESS, META_CALL_REMOVING_PARTY, META_CALL_STARTING, META_CALL_TRANSFERRING, META_SNAPSHOT, META_UNKNOWN

Method Summary

Address	getCalledAddress() Returns the called Address associated with this Call.
Address	getCallingAddress() Returns the calling Address associated with this call.
Terminal	getCallingTerminal() Returns the calling Terminal associated with this Call.
Address	getLastRedirectedAddress() Returns the last redirected Address associated with this Call.

Methods inherited from interface javax.telephony.callcontrol.events.CallCtlEv

getCallControlCause

Methods inherited from interface javax.telephony.events.Ev

getCause, getID, getMetaCode, getObserved, isNewMetaEvent

Methods inherited from interface javax.telephony.events.CallEv

getCall

Method Detail

getCallingAddress

public Address getCallingAddress()

Returns the calling Address associated with this call. The calling Address is defined as the Address which placed the telephone call.

If the calling address is unknown or not yet known, this method returns null.

Returns:

The calling Address.

getCallingTerminal

public Terminal getCallingTerminal()

Returns the calling Terminal associated with this Call. The calling Terminal is defined as the Terminal which placed the telephone call.

If the calling Terminal is unknown or not yet know, this method returns null.

Returns:

The calling Terminal.

getCalledAddress

public Address getCalledAddress()

Returns the called Address associated with this Call. The called Address is defined as the Address to which the call has been originally placed.

If the called address is unknown or not yet known, this method returns null.

Returns:

The called Address.

getLastRedirectedAddress

public Address getLastRedirectedAddress()

Returns the last redirected Address associated with this Call. The last redirected Address is the Address at which the current telephone call was placed immediately before the current Address. This is common if a Call is forwarded to several Addresses before being answered.

If the the last redirected address is unknown or not yet known, this method returns null.

Returns:

The last redirected Address for this telephone Call.