javax.telephony.callcontrol
Interface CallControlCallEvent

All Superinterfaces:

CallControlEvent, CallEvent, Event

All Known Subinterfaces:

CallControlConnectionEvent, CallControlTerminalConnectionEvent

public interface CallControlCallEvent

extends CallControlEvent, CallEvent

The CallControlCallEvent 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 CallControlCallListener interface. This interface extends both the CallControlEvent and core CallEvent interfaces.

The CallControlConnectionEvent and CallControlTerminalConnectionEvent events extend this 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.

Since:

1.4

See Also:

Call, CallEvent, CallControlCall, CallControlConnectionEvent, CallControlTerminalConnectionEvent, CallControlCallListener

Fields inherited from interface javax.telephony.callcontrol.CallControlEvent

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.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

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.CallControlEvent

getCallControlCause

Methods inherited from interface javax.telephony.Event

getCause, getID, getMetaEvent, getSource

Methods inherited from interface javax.telephony.CallEvent

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.