Java Programmer's Guide and Reference

Terminal class

A Terminal represents a hardware endpoint, such as a telephone, that is connected to the telephony network.

The IBM CallPath Enterprise Toolkit for Java's Terminal object implements the core Terminal interface (included in the javax.telephony package), the CallControlTerminal interface (included in the javax.telephony.callcontrol package), and the AgentTerminal interface (included in the javax.telephony.callcenter package).

Methods

Table 11, Table 12, and Table 13 list the methods (and provide comments about those methods, where appropriate) included in the core Terminal class, the CallControlTerminal class, and the AgentTerminal class, respectively:

Note:

An application can access any of the methods by casting to the appropriate interface.

Table 11. javax.telephony.Terminal methods

Method	Comments
void addObserver(TerminalObserver)
Address[] getAddresses()
String getName()
TerminalObserver[] getObservers()
Provider getProvider()
TerminalCapabilities getCapabilities()	Returns only the default TerminalCapabilities.
TerminalCapabilities getTerminalCapabilities(Terminal, Address)	Deprecated. Returns only the default TerminalCapabilities.
TerminalConnection[] getTerminalConnections()
void removeObserver(TerminalObserver)
void addCallObserver(CallObserver)
void removeCallObserver(CallObserver)
CallObserver[] getCallObservers()

Table 12. javax.telephony.callcontrol.CallControlTerminal methods

Method	Comments
boolean getDoNotDisturb()
TerminalConnection alternate()
TerminalConnection alternate(TerminalConnection, TerminalConnection)
CallControlConnection pickup(Connection, Address)	This method is not supported. It throws MethodNotSupportedException.
void pickupFromGroup(String, Address)	This method is not supported. It throws MethodNotSupportedException.
void pickupFromGroup(Address)	This method is not supported. It throws MethodNotSupportedException.
boolean setDoNotDisturb(boolean)

Table 13. javax.telephony.callcenter.AgentTerminal methods

Method	Comments
void addAgent(Address, ACDAddress, int, String, String)
void removeAgent(Agent)
void setAgents(Agent[] agents)	This method is not supported. It throws MethodNotSupportedException.
Agent[] getAgents()

For more information, refer to the JavaSoft JTAPI 1.2 documentation.