JSR-043: JTAPI-1.4

javax.telephony.callcenter
Interface CallCenterCallEvent

All Superinterfaces:
CallCenterEvent, CallEvent, Event
All Known Subinterfaces:
CallCenterConnectionEvent, CallCenterTrunkEvent

public interface CallCenterCallEvent
extends CallCenterEvent, CallEvent

The CallCenterCallEvent interface is the interface exposed for all events reported for the CallCenterCall interface. This interface extends the CallCenterEvent interface and the core CallEvent interface.

All CallCenterCallEvents are reported via the CallCenterCallListener interface, to objects registered as Listeners on a CallCenterCall. Objects register as Listeners of CallCenterCallEvents by implementing the CallCenterCallListener interface and invoking Call.addListener.

Since:
1.4
See Also:
Call, CallEvent, CallCenterCall

Field Summary
static int CALLCENT_CALL_APPLICATION_DATA_EVENT
          This event ID indicates that the application data associated with the Call has changed.
 
Fields inherited from interface javax.telephony.callcenter.CallCenterEvent
CAUSE_NO_AVAILABLE_AGENTS
 
Fields inherited from interface javax.telephony.Event
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
 
Fields inherited from interface javax.telephony.CallEvent
CALL_ACTIVE, CALL_EVENT_TRANSMISSION_ENDED, CALL_INVALID
 
Method Summary
 java.lang.Object getApplicationData()
          Returns the new application data for this call.
 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.callcenter.CallCenterEvent
getCallCenterCause
 
Methods inherited from interface javax.telephony.Event
getCause, getID, getMetaEvent, getSource
 
Methods inherited from interface javax.telephony.CallEvent
getCall
 

Field Detail

CALLCENT_CALL_APPLICATION_DATA_EVENT

public static final int CALLCENT_CALL_APPLICATION_DATA_EVENT
This event ID indicates that the application data associated with the Call has changed.
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.

getApplicationData

public java.lang.Object getApplicationData()
Returns the new application data for this call. This method returns null if the application data has been cleared from the call.

Returns:
The data object, null if it has been cleared.

JSR-043: JTAPI-1.4

Send comments to: JSR-43@ectf.org