TerminalConnection represents the relationship between a Connection and a Terminal.
Table 19 and Table 20 list the methods (and provide comments
about those methods, where appropriate) included in the core
TerminalConnection class and the CallControl TerminalConnection class,
respectively:
Table 19. javax.telephony.TerminalConnection methods
| Method | Comments |
|---|---|
|
void answer()
|
|
|
Connection getConnection()
|
|
|
int getState()
| See Table 21 for a list of supported states. |
|
Terminal getTerminal()
|
|
|
TerminalConnectionCapabilities getCapabilities()
| Returns only the default TerminalConnectionCapabilities. |
|
TerminalConnectionCapabilities getTerminalConnectionCapabilities
(Terminal, Connection)
| Deprecated. Returns only the default TerminalConnectionCapabilities. |
Table 20. javax.telephony.callcontrol.CallControlTerminalConnection methods
| Method | Comments |
|---|---|
|
int getCallControlState()
| See Table 22 for a list of supported states. |
|
void hold()
|
|
|
void join()
| This method is not supported. It throws MethodNotSupportedException. |
|
void leave()
| This method is not supported. It throws MethodNotSupportedException. |
|
void unhold()
|
|
For more information, refer to the JavaSoft JTAPI 1.2 documentation.
TerminalConnection objects always have states associated with them. The state changes depending on the status of the Terminal Connection. Each object has both a core TerminalConnection state and a CallControlTerminalConnection state.
Table 21 and Table 22 list all states (and provide comments about
those states, where appropriate) for the core TerminalConnection class and the
CallControlTerminalConnection class, respectively:
Table 21. javax.telephony.TerminalConnection states
| States | Comments |
|---|---|
|
TerminalConnection.IDLE
|
|
|
TerminalConnection.RINGING
|
|
|
TerminalConnection.PASSIVE
| State not supported. |
|
TerminalConnection.ACTIVE
|
|
|
TerminalConnection.DROPPED
|
|
|
TerminalConnection.UNKNOWN
|
|
Table 22. javax.telephony.callcontrol.CallControlTerminalConnection states
| State | Comments |
|---|---|
|
CallControlTerminalConnection.IDLE
|
|
|
CallControlTerminalConnection.RINGING
|
|
|
CallControlTerminalConnection.TALKING
|
|
|
CallControlTerminalConnection.HELD
|
|
|
CallControlTerminalConnection.BRIDGED
| State not supported. |
|
CallControlTerminalConnection.INUSE
| State not supported. |
|
CallControlTerminalConnection.DROPPED
|
|
|
CallControlTerminalConnection.UNKNOWN
|
|