📄 java.telephony.terminal.html
字号:
<!--NewPage--><html><head><!-- Generated by javadoc on Fri Feb 07 16:42:30 PST 1997 --><a name="_top_"></a><title> Interface java.telephony.Terminal</title></head><body><pre><a href="packages.html">All Packages</a> <a href="tree.html">Class Hierarchy</a> <a href="Package-java.telephony.html">This Package</a> <a href="java.telephony.ProviderObserver.html#_top_">Previous</a> <a href="java.telephony.TerminalConnection.html#_top_">Next</a> <a href="AllNames.html">Index</a></pre><hr><h1> Interface java.telephony.Terminal</h1><dl> <dt> public interface <b>Terminal</b> <dt> extends <a href="java.lang.Object.html#_top_">Object</a></dl>A Terminal represents a physical hardware endpoint connected to thetelephony network. An example of a Terminal is a telephone set, buta Terminal does not have to take the form of this limited and traditionalexample. A wide variety of hardware can act as Terminals.<p>Terminal objects are distinguished from one another by their names; eachTerminal has a unique name. How Terminals are named within a Provideris up to the implementaion. Typically, when choosing a Terminal,applications simply obtain the names of the available Terminals. This listis presented to the user who will be able to identify the desiredTerminal. Typically, the user will have no trouble identifying the desiredTerminal. Therefore, the portability of applications is not affected bythe lack of standardization of Terminal names. A common way to nameTerminals is by a "primary" telephone number Address at that Terminal. Thisis only an example, however, and implementations need not name theirTerminals in this manner.<p>There may be many Terminals associated with a Provider. The applicationobtains a list of these Terminals via the <EM>Provider.getTerminals()</EM>method. Applications may obtain a specific Terminal object given its namevia the <EM>Provider.getTerminal(name)</EM> method. These two methodsrepresent the manner in which applications obtain Terminal objects.Applications never create Terminal objects, either through the Provider orusing the "new" constructor.<p>A Terminal may have one or more Address objects associated with it. Inreal-terms, this corresponds to telephones having multiple telephone numbersassociated with a Terminal. Address objects are the logical endpoints oftelephone calls, described by a Connection object between the Call andAddress. Terminals act as the physical endpoint of a Call. A Connectionobject may have zero or more TerminalConnection objects. TheseTerminalConnection objects describe which Terminals act as the physicalendpoint of the Call for that Connection's Address object.<p>Terminal objects are responsible for reporting information about telephone calls which were created before the Provider. In other words, Terminalobject must report on all TerminalConnection objects which are part of alltelephone calls in the Provider's domain--even if these telephone Calls werecreated before the Provider was created.<p>More than one Terminal object may share the same Address object. In real-terms, this corresponds to a telephone number appearing on more than onetelephone terminal. Because each Terminal may be in a different state w.r.tthe telephone call, Terminal objects are associated with Calls via theTerminalConnection object. The TerminalConnection object describes thespecific state of the Terminal with respect to the Call.<p>All changes in a Terminal object are reported via the TerminalObserverinterface. Applications instantiate an object which implements thisinterface and begins this delivery of events to this object using the<EM>Terminal.addObserver()</EM> method.<p><dl> <dt> <b>See Also:</b> <dd> <a href="java.telephony.TerminalObserver.html#_top_">TerminalObserver</a></dl><hr><a name="index"></a><h2> <img src="images/method-index.gif" width=207 height=38 alt="Method Index"></h2><dl> <dt> <img src="images/red-ball-small.gif" width=6 height=6 alt=" o "> <a href="#addCallObserver(java.telephony.CallObserver)"><b>addCallObserver</b></a>(CallObserver) <dd> Adds an observer to a Call object when this Terminal object first becomespart of that Call. <dt> <img src="images/red-ball-small.gif" width=6 height=6 alt=" o "> <a href="#addObserver(java.telephony.TerminalObserver)"><b>addObserver</b></a>(TerminalObserver) <dd> Adds an observer to the Terminal. <dt> <img src="images/red-ball-small.gif" width=6 height=6 alt=" o "> <a href="#getAddresses()"><b>getAddresses</b></a>() <dd> Returns an array of Address objects associated with this Terminal object. <dt> <img src="images/red-ball-small.gif" width=6 height=6 alt=" o "> <a href="#getCallObservers()"><b>getCallObservers</b></a>() <dd> Returns a list of all CallObservers associated with this Terminalobject. <dt> <img src="images/red-ball-small.gif" width=6 height=6 alt=" o "> <a href="#getName()"><b>getName</b></a>() <dd> Returns the name of the Terminal. <dt> <img src="images/red-ball-small.gif" width=6 height=6 alt=" o "> <a href="#getObservers()"><b>getObservers</b></a>() <dd> Returns a list of all TerminalObservers associated with this Terminal object. <dt> <img src="images/red-ball-small.gif" width=6 height=6 alt=" o "> <a href="#getProvider()"><b>getProvider</b></a>() <dd> Returns the Provider associated with this Terminal. <dt> <img src="images/red-ball-small.gif" width=6 height=6 alt=" o "> <a href="#getTerminalCapabilities(java.telephony.Terminal, java.telephony.Address)"><b>getTerminalCapabilities</b></a>(Terminal, Address) <dd> Gets the TerminalConnectionCapabilities object with respect to a Terminal and anAddress. <dt> <img src="images/red-ball-small.gif" width=6 height=6 alt=" o "> <a href="#getTerminalConnections()"><b>getTerminalConnections</b></a>() <dd> Returns an array of TerminalConnection objects associated with thisTerminal. <dt> <img src="images/red-ball-small.gif" width=6 height=6 alt=" o "> <a href="#removeCallObserver(java.telephony.CallObserver)"><b>removeCallObserver</b></a>(CallObserver) <dd> Removes the given CallObserver from the Terminal. <dt> <img src="images/red-ball-small.gif" width=6 height=6 alt=" o "> <a href="#removeObserver(java.telephony.TerminalObserver)"><b>removeObserver</b></a>(TerminalObserver) <dd> Removes the given observer from the Terminal.</dl><a name="methods"></a><h2> <img src="images/methods.gif" width=151 height=38 alt="Methods"></h2><a name="getName()"><img src="images/red-ball.gif" width=12 height=12 alt=" o "></a><a name="getName"><b>getName</b></a><pre> public abstract <a href="java.lang.String.html#_top_">String</a> getName() throws <a href="java.telephony.PlatformException.html#_top_">PlatformException</a></pre><dl> <dd> Returns the name of the Terminal. Each Terminal possesses a uniquename, which is assigned to it by the JTAPI implementation.<p> <dl> <dt> <b>Returns:</b> <dd> The name of the Terminal. <dt> <b>Throws:</b> <a href="java.telephony.PlatformException.html#_top_">PlatformException</a> <dd> A platform-specific exception occurred. </dl></dl><a name="getProvider()"><img src="images/red-ball.gif" width=12 height=12 alt=" o "></a><a name="getProvider"><b>getProvider</b></a><pre> public abstract <a href="java.telephony.Provider.html#_top_">Provider</a> getProvider() throws <a href="java.telephony.PlatformException.html#_top_">PlatformException</a></pre><dl> <dd> Returns the Provider associated with this Terminal. This Provider objectis valid throughout the lifetime of the Terminal and does not changeonce the Terminal is created.<p> <dl> <dt> <b>Returns:</b> <dd> The Provider associated with this Terminal. <dt> <b>Throws:</b> <a href="java.telephony.PlatformException.html#_top_">PlatformException</a> <dd> A platform-specific exception occurred. </dl></dl><a name="getAddresses()"><img src="images/red-ball.gif" width=12 height=12 alt=" o "></a><a name="getAddresses"><b>getAddresses</b></a><pre> public abstract <a href="java.telephony.Address.html#_top_">Address</a>[] getAddresses() throws <a href="java.telephony.InvalidStateException.html#_top_">InvalidStateException</a>, <a href="java.telephony.PlatformException.html#_top_">PlatformException</a></pre><dl> <dd> Returns an array of Address objects associated with this Terminal object.The Terminal object must have at least one Address object associatedwith it. The Provider must be in the Provider.IN_SERVICE state for thismethod to be valid.<p>The pre-conditions for this method are:<OL><LI>(this.getProvider()).getState() == Provider.IN_SERVICE.</OL><p>The post-conditions for this method are:<OL><LI>(this.getProvider()).getState() == Provider.IN_SERVICE<LI>Let Address[] addrs = this.getAddresses()<LI>addrs.length >= 1</OL><p> <dl> <dt> <b>Returns:</b> <dd> An array of Address objects associated with this Terminal. <dt> <b>Throws:</b> <a href="java.telephony.InvalidStateException.html#_top_">InvalidStateException</a> <dd> The Provider is not IN_SERVICE. <dt> <b>Throws:</b> <a href="java.telephony.PlatformException.html#_top_">PlatformException</a> <dd> A platform-specific exception occurred. </dl></dl><a name="getTerminalConnections()"><img src="images/red-ball.gif" width=12 height=12 alt=" o "></a><a name="getTerminalConnections"><b>getTerminalConnections</b></a><pre> public abstract <a href="java.telephony.TerminalConnection.html#_top_">TerminalConnection</a>[] getTerminalConnections() throws <a href="java.telephony.InvalidStateException.html#_top_">InvalidStateException</a>, <a href="java.telephony.PlatformException.html#_top_">PlatformException</a></pre><dl> <dd> Returns an array of TerminalConnection objects associated with thisTerminal. Once a TerminalConnection is added to a Terminal, the Terminalmaintains a reference until the TerminalConnection moves into theTerminalConnection.DROPPED state. The Provider must be IN_SERVICE forthis method to be valid. If there are no TerminalConnections associatedwith this Terminal, then this method returns null.<p>The pre-conditions for this method are:<OL><LI>(this.getProvider()).getState() == Provider.IN_SERVICE</OL><p>The post-conditions for this method are:<OL><LI>(this.getProvider()).getState() == Provider.IN_SERVICE<LI>Let TerminalConnection tc[] = this.getTerminalConnections()<LI>tc == null or tc.length >= 1<LI>For all i, tc[i].getState() != TerminalConnection.DROPPED</OL><p> <dl> <dt> <b>Returns:</b> <dd> An array of TerminalConnection objects associated with thisTerminal. <dt> <b>Throws:</b> <a href="java.telephony.InvalidStateException.html#_top_">InvalidStateException</a> <dd> The Provider is not IN_SERVICE. <dt> <b>Throws:</b> <a href="java.telephony.PlatformException.html#_top_">PlatformException</a>⌨️ 快捷键说明
复制代码
Ctrl + C
搜索代码
Ctrl + F
全屏模式
F11
切换主题
Ctrl + Shift + D
显示快捷键
?
增大字号
Ctrl + =
减小字号
Ctrl + -