JSR-043: JTAPI-1.4

javax.telephony.callcontrol.capabilities
Interface CallControlCallCapabilities

All Superinterfaces:
CallCapabilities

public interface CallControlCallCapabilities
extends CallCapabilities

The CallControlCallCapabilities interface extends the core CallCapabilities interface. This interface provides methods to reflect the capabilities of the methods on the CallControlCall interface.

The Provider.getCallCapabilities() method returns the static Call capabilities, and the Call.getCapabilities() method returns the dynamic Call capabilities. The object returned from each of these methods can be queried with the instanceof operator to check if it supports this interface. This same interface is used to reflect both static and dynamic Call capabilities.

See Also:
Provider, Call, CallCapabilities

Method Summary
 boolean canAddParty()
          Returns true if the application can invoke the add party feature, false otherwise.
 boolean canConference()
          Returns true if the application can invoke the conference feature, false otherwise.
 boolean canConsult()
          Deprecated. Since JTAPI v1.2. The default behavior of this method in JTAPI v1.2 and later should invoke the canConsult(TerminalConnection, String) method.
 boolean canConsult(TerminalConnection tc)
          Returns true if the application can invoke the overloaded consult feature which takes a TerminalConnection as an argument, false otherwise.
 boolean canConsult(TerminalConnection tc, java.lang.String destination)
          Returns true if the application can invoke the overloaded consult feature which takes a TerminalConnection and string as arguments, false otherwise.
 boolean canDrop()
          Returns true if the application can invoke the drop feature, false otherwise.
 boolean canOffHook()
          Returns true if the application can invoke the off hook feature, false otherwise.
 boolean canSetConferenceController()
          Returns true if the application can set the conference controller, false otherwise.
 boolean canSetConferenceEnable()
          Returns true if the application can invoke the set conferencing enabling feature, false otherwise.
 boolean canSetTransferController()
          Returns true if the application can set the transfer controller, false otherwise.
 boolean canSetTransferEnable()
          Returns true if the application can invoke the set transferring enabling feature, false otherwise.
 boolean canTransfer()
          Deprecated. Since JTAPI v1.2. The default behavior of this method in JTAPI v1.2 and later should invoke the canTransfer(Call) method.
 boolean canTransfer(Call call)
          Returns true if the application can invoke the overloaded transfer feature which takes a Call as an argument, false otherwise.
 boolean canTransfer(java.lang.String destination)
          Returns true if the application can invoke the overloaded transfer feature which takes a destination string as an argument, false otherwise.
 
Methods inherited from interface javax.telephony.capabilities.CallCapabilities
canConnect, isObservable
 

Method Detail

canDrop

public boolean canDrop()
Returns true if the application can invoke the drop feature, false otherwise.

Returns:
True if the application can invoke the drop feature, false otherwise.

canOffHook

public boolean canOffHook()
Returns true if the application can invoke the off hook feature, false otherwise.

Returns:
true if the application can invoke the off hook feature, false otherwise.

canSetConferenceController

public boolean canSetConferenceController()
Returns true if the application can set the conference controller, false otherwise.

Returns:
true if the application can set the conference controller, false otherwise.

canSetTransferController

public boolean canSetTransferController()
Returns true if the application can set the transfer controller, false otherwise.

Returns:
true if the application can set the transfer controller, false otherwise.

canSetTransferEnable

public boolean canSetTransferEnable()
Returns true if the application can invoke the set transferring enabling feature, false otherwise. The value returned by this method is independent of the ability of the application to invoke the transfer feature.

Applications are not required to inform the implementation of the purpose of the consultation call and may rely upon the default value returned by the CallControlCall.getTransferEnable() method.

Returns:
True if the application can invoke the set transferring enabling feature, false otherwise.

canSetConferenceEnable

public boolean canSetConferenceEnable()
Returns true if the application can invoke the set conferencing enabling feature, false otherwise. The value returned by this method is independent of the ability of the application to invoke the conference feature.

Applications are not required to inform the implementation of the purpose of the consultation call and may rely upon the default value returned by the CallControlCall.getConferenceEnable() method.

Returns:
True if the application can invoke the set conferencing enabling feature, false otherwise.

canTransfer

public boolean canTransfer()
Deprecated. Since JTAPI v1.2. The default behavior of this method in JTAPI v1.2 and later should invoke the canTransfer(Call) method.

Returns true if the application can invoke the transfer feature, false otherwise.

Note: This method has been replaced in JTAPI 1.2 with overloaded versions. These versions permit applications to give typed argument to obtain the capabilities for a particular overloaded version of the CallControlCall.transfer() method.

Returns:
True if the application can invoke the transfer feature, false otherwise.

canTransfer

public boolean canTransfer(Call call)
Returns true if the application can invoke the overloaded transfer feature which takes a Call as an argument, false otherwise.

The argument provided is for typing purposes only. The particular instance of the object given is ignored and not used to determine the capability outcome is any way.

Parameters:
call - This argument is used for typing information to determine the overloaded version of the transfer() method.
Returns:
True if the application can invoke the transfer feature which takes a Call as an argument, false otherwise.
Since:
JTAPI v1.2

canTransfer

public boolean canTransfer(java.lang.String destination)
Returns true if the application can invoke the overloaded transfer feature which takes a destination string as an argument, false otherwise.

The argument provided is for typing purposes only. The particular instance of the object given is ignored and not used to determine the capability outcome is any way.

Parameters:
destination - This argument is used for typing information to determine the overloaded version of the transfer() method.
Returns:
True if the application can invoke the transfer feature which takes a destination string as an argument, false otherwise.
Since:
JTAPI v1.2

canConference

public boolean canConference()
Returns true if the application can invoke the conference feature, false otherwise.

Returns:
True if the application can invoke the conference feature, false otherwise.

canAddParty

public boolean canAddParty()
Returns true if the application can invoke the add party feature, false otherwise.

Returns:
True if the application can invoke the add party feature, false otherwise.

canConsult

public boolean canConsult()
Deprecated. Since JTAPI v1.2. The default behavior of this method in JTAPI v1.2 and later should invoke the canConsult(TerminalConnection, String) method.

Returns true if the application can invoke the consult feature, false otherwise.

Note: This method has been replaced in JTAPI 1.2 with overloaded versions. These versions permit applications to give typed argument to obtain the capabilities for a particular overloaded version of the CallControlCall.consult() method.

Returns:
True if the application can invoke the consult feature, false otherwise.

canConsult

public boolean canConsult(TerminalConnection tc,
                          java.lang.String destination)
Returns true if the application can invoke the overloaded consult feature which takes a TerminalConnection and string as arguments, false otherwise.

The arguments provided are for typing purposes only. The particular instances of the objects given are ignored and not used to determine the capability outcome is any way.

Parameters:
tc - This argument is used for typing information to determine the overloaded version of the consult() method.
destination - This argument is used for typing information to destination the overloaded version of the consult() method.
Returns:
True if the application can invoke the consult feature which takes a TerminalConnection and a string as arguments.
Since:
JTAPI v1.2

canConsult

public boolean canConsult(TerminalConnection tc)
Returns true if the application can invoke the overloaded consult feature which takes a TerminalConnection as an argument, false otherwise.

The arguments provided are for typing purposes only. The particular instances of the objects given are ignored and not used to determine the capability outcome is any way.

Parameters:
tc - This argument is used for typing information to determine the overloaded version of the consult() method.
Returns:
True if the application can invoke the consult feature which takes a TerminalConnection as an argument.
Since:
JTAPI v1.2

JSR-043: JTAPI-1.4

Send comments to: JSR-43@ectf.org