java.telephony.terminalconnection.html

JTAPI_html 用于JTAPI的HTML文档.

<a name="ACTIVE"><img src="images/blue-ball.gif" width=12 height=12 alt=" o "></a>
<b>ACTIVE</b>
<pre>
  public final static int ACTIVE
</pre>
<dl>
  <dd> The ACTIVE state indicates that a Terminal is actively part of a
telephone call. This usually implies that the party speaking on that
Terminal is party of the telephone call.
</dl>
<a name="DROPPED"><img src="images/blue-ball.gif" width=12 height=12 alt=" o "></a>
<b>DROPPED</b>
<pre>
  public final static int DROPPED
</pre>
<dl>
  <dd> The DROPPED state indicates that a particular Terminal has permanently
left the telephone call.
</dl>
<a name="UNKNOWN"><img src="images/blue-ball.gif" width=12 height=12 alt=" o "></a>
<b>UNKNOWN</b>
<pre>
  public final static int UNKNOWN
</pre>
<dl>
  <dd> The UNKNOWN state indicates that the implementation is unable to determine
the state of the TerminalConnection.
</dl>
<a name="methods"></a>
<h2>
  <img src="images/methods.gif" width=151 height=38 alt="Methods">
</h2>
<a name="getState()"><img src="images/red-ball.gif" width=12 height=12 alt=" o "></a>
<a name="getState"><b>getState</b></a>
<pre>
  public abstract int getState() throws <a href="java.telephony.PlatformException.html#_top_">PlatformException</a>
</pre>
<dl>
  <dd> Returns the state of the TerminalConnection object.
<p>
  <dl>
    <dt> <b>Returns:</b>
    <dd> The current state of the TerminalConnection object.
    <dt> <b>Throws:</b> <a href="java.telephony.PlatformException.html#_top_">PlatformException</a>
    <dd> A platform-specific exception occurred.
  </dl>
</dl>
<a name="getTerminal()"><img src="images/red-ball.gif" width=12 height=12 alt=" o "></a>
<a name="getTerminal"><b>getTerminal</b></a>
<pre>
  public abstract <a href="java.telephony.Terminal.html#_top_">Terminal</a> getTerminal() throws <a href="java.telephony.PlatformException.html#_top_">PlatformException</a>
</pre>
<dl>
  <dd> Returns the Terminal associated with this TerminalConnection object.
A TerminalConnection's reference to its Terminal remains valid for
the lifetime of the object, even if the Terminal loses its references
to this TerminalConnection object. Also, this reference does not
change once the TerminalConnection object has been created.
<p>
  <dl>
    <dt> <b>Returns:</b>
    <dd> The Terminal object associated with this TerminalConnection.
    <dt> <b>Throws:</b> <a href="java.telephony.PlatformException.html#_top_">PlatformException</a>
    <dd> A platform-specific exception occurred.
  </dl>
</dl>
<a name="getConnection()"><img src="images/red-ball.gif" width=12 height=12 alt=" o "></a>
<a name="getConnection"><b>getConnection</b></a>
<pre>
  public abstract <a href="java.telephony.Connection.html#_top_">Connection</a> getConnection() throws <a href="java.telephony.PlatformException.html#_top_">PlatformException</a>
</pre>
<dl>
  <dd> Returns the Connection object associated with this TerminalConnection.
A TerminalConnection's reference to the Connection remains valid
thoughout the lifetime of the TerminalConnection. Also, this reference
does not change once the TerminalConnection object has been created.
<p>
  <dl>
    <dt> <b>Returns:</b>
    <dd> The Connections associated with this TerminalConnection.
    <dt> <b>Throws:</b> <a href="java.telephony.PlatformException.html#_top_">PlatformException</a>
    <dd> A platform-specific exception occurred.
  </dl>
</dl>
<a name="answer()"><img src="images/red-ball.gif" width=12 height=12 alt=" o "></a>
<a name="answer"><b>answer</b></a>
<pre>
  public abstract void answer() throws <a href="java.telephony.PrivilegeViolationException.html#_top_">PrivilegeViolationException</a>, <a href="java.telephony.ResourceUnavailableException.html#_top_">ResourceUnavailableException</a>, <a href="java.telephony.MethodNotSupportedException.html#_top_">MethodNotSupportedException</a>, <a href="java.telephony.InvalidStateException.html#_top_">InvalidStateException</a>, <a href="java.telephony.PlatformException.html#_top_">PlatformException</a>
</pre>
<dl>
  <dd> Answers a telephone call. The TerminalConnection object must be in the
TerminalConnection.RINGING state. A successful invocation of this method
results in the TerminalConnection moving from the
TerminalConnection.RINGING state into the TerminalConnection.ACTIVE state.
The Provider must be in the Provider.IN_SERVICE state in order for
this method to be valid. The Connection associated with this
TerminalConnection must also be in the Connection.ALERTING state, however
this condition is implied when the TerminalConnection is in the
TerminalConnection.RINGING state.
<p>
The pre-condition predicates for this method are:
<OL>
<LI>((this.getTerminal()).getProvider()).getState() == Provider.IN_SERVICE
<LI>this.getState() == TerminalConnection.RINGING
<LI>(this.getConnection()).getState() == Connection.ALERTING
</OL>
<p>
The post-condition predicates for this method are, indicating the
successful completetion of this invocation:
<OL>
<LI>((this.getTerminal()).getProvider()).getState() == Provider.IN_SERVICE
<LI>this.getState() == TerminalConnection.ACTIVE
<LI>(this.getConnection()).getState() == Connection.CONNECTED
</OL>
<p>
Note that because the way in which TerminalConnections are related to
Connections, when the TerminalConnection is in the
TerminalConnection.RINGING state, it must be associated with a Connetion
in the Connection.ALERTING state. Also, when this method returns, the
TerminalConnection is in the TerminalConnection.ACTIVE state, however
this implies that the associated Connection moves into the
Connection.CONNECTED state at the same time.
<p>
Also, if the ALERTING Connection has more than one Terminal, all of these
Terminals will have TerminalConnections which will be in the
TerminalConnection.RINGING state. What happens to these other
TerminalConnections when the <EM>answer()</EM> method is invoked depends
upon the configuration of the switch. Unfortunately, this configuration
cannot be determined in advanced. These other TerminalConnections may
either go into the TerminalConnection.PASSIVE state or the
TerminalConnection.DROPPED state.
<p>
The following events are reported to the application via the CallObserver
interface for the Call associated with this TerminalConnection when this
method successfully completes: a <EM>java.telephony.events.TermConnActiveEv</EM>
for this TerminalConnection, a <EM>java.telephony.events.ConnConnectedEv</EM>
for the Connection associated with this TerminalConnection, and either
<EM>java.telephony.events.TermConnPassiveEv</EM> or a
<EM>java.telephony.events.TermConnDroppedEv</EM> for the other Terminal
Connections associated with this TerminalConnection's Connection.
<p>
  <dl>
    <dt> <b>Throws:</b> <a href="java.telephony.PrivilegeViolationException.html#_top_">PrivilegeViolationException</a>
    <dd> The application did not have
proper authority to answers the telephone call.
    <dt> <b>Throws:</b> <a href="java.telephony.ResourceUnavailableException.html#_top_">ResourceUnavailableException</a>
    <dd> The neccessary resources to
answer the telephone call were not available when the method was invoked.
    <dt> <b>Throws:</b> <a href="java.telephony.MethodNotSupportedException.html#_top_">MethodNotSupportedException</a>
    <dd> This method is currently not
supported by this implementation.
    <dt> <b>Throws:</b> <a href="java.telephony.InvalidStateException.html#_top_">InvalidStateException</a>
    <dd> An object was not in the proper state,
violating the pre-conditions of this method.
    <dt> <b>Throws:</b> <a href="java.telephony.PlatformException.html#_top_">PlatformException</a>
    <dd> A platform-specific exception occurred.
    <dt> <b>See Also:</b>
    <dd> <a href="java.telephony.events.TermConnActiveEv.html#_top_">TermConnActiveEv</a>, <a href="java.telephony.events.TermConnPassiveEv.html#_top_">TermConnPassiveEv</a>, <a href="java.telephony.events.TermConnDroppedEv..html#_top_"></a>, <a href="java.telephony.events.ConnConnectedEv
<p>.html#_top_">ConnConnectedEv
<p></a>
  </dl>
</dl>
<a name="getTerminalConnectionCapabilities(java.telephony.Terminal, java.telephony.Address)"><img src="images/red-ball.gif" width=12 height=12 alt=" o "></a>
<a name="getTerminalConnectionCapabilities"><b>getTerminalConnectionCapabilities</b></a>
<pre>
  public abstract <a href="java.telephony.capabilities.TerminalConnectionCapabilities.html#_top_">TerminalConnectionCapabilities</a> getTerminalConnectionCapabilities(<a href="java.telephony.Terminal.html#_top_">Terminal</a> terminal,
                                                                                   <a href="java.telephony.Address.html#_top_">Address</a> address) throws <a href="java.telephony.InvalidArgumentException.html#_top_">InvalidArgumentException</a>, <a href="java.telephony.PlatformException.html#_top_">PlatformException</a>
</pre>
<dl>
  <dd> Gets the TerminalConnectionCapabilities object with respect to a Terminal and an
Address.
If null is passed as a Terminal parameter, the general/provider-wide Terminal Connection 
capabilities are returned.
<p>
</dl>
<hr>
<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.Terminal.html#_top_">Previous</a>  <a href="java.telephony.TerminalObserver.html#_top_">Next</a>  <a href="AllNames.html">Index</a></pre>
</body>
</html>