java.telephony.connection.html

JTAPI_html 用于JTAPI的HTML文档.

  <dd> The Connection.ALERTING state implies that the Address is being notified of
an incoming call. Typically, the Connection.ALERTING Connection will
answer the telephone call.
</dl>
<a name="CONNECTED"><img src="images/blue-ball.gif" width=12 height=12 alt=" o "></a>
<b>CONNECTED</b>
<pre>
  public final static int CONNECTED
</pre>
<dl>
  <dd> The Connection.CONNECTED state implies that a Connection and its Address is
actively part of a telephone call. In common terms, two people talking to
one another are represented by two Connections in the Connection.CONNECTED
state.
</dl>
<a name="DISCONNECTED"><img src="images/blue-ball.gif" width=12 height=12 alt=" o "></a>
<b>DISCONNECTED</b>
<pre>
  public final static int DISCONNECTED
</pre>
<dl>
  <dd> The Connection.DISCONNECTED state implies it is no longer part of the
telephone call, although its references to Call and Address still remain
valid. A Connection in the Connection.DISCONNECTED state is interpreted as
once previously belonging to this telephone call.
</dl>
<a name="FAILED"><img src="images/blue-ball.gif" width=12 height=12 alt=" o "></a>
<b>FAILED</b>
<pre>
  public final static int FAILED
</pre>
<dl>
  <dd> The Connection.FAILED state indicates that a Connection to that end of the
call has failed for some reason. One reason why a Connection would be in
the Connection.FAILED state is because the party was busy.
</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 Connection.UNKNOWN state implies that the implementation is unable to
determine the current state of the Connection. Typically, method are
invalid on Connections which are in the Connection.UNKNOWN state.
Connections may move in and out of the Connection.UNKNOWN state at any
time.
</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 current state of the Connection. The return value will
be one of states defined above.
<p>
  <dl>
    <dt> <b>Returns:</b>
    <dd> The current state of the Connection.
    <dt> <b>Throws:</b> <a href="java.telephony.PlatformException.html#_top_">PlatformException</a>
    <dd> An platform-specific exception occurred.
  </dl>
</dl>
<a name="getCall()"><img src="images/red-ball.gif" width=12 height=12 alt=" o "></a>
<a name="getCall"><b>getCall</b></a>
<pre>
  public abstract <a href="java.telephony.Call.html#_top_">Call</a> getCall() throws <a href="java.telephony.PlatformException.html#_top_">PlatformException</a>
</pre>
<dl>
  <dd> Returns the Call object associated with this Connection. This Call
reference remains valid throughout the lifetime of the Connection object,
despite its current state. This Call reference does not change after this
object is created.
<p>
  <dl>
    <dt> <b>Returns:</b>
    <dd> The call object associated with this Connection.
    <dt> <b>Throws:</b> <a href="java.telephony.PlatformException.html#_top_">PlatformException</a>
    <dd> A platform-specific exception occurred.
  </dl>
</dl>
<a name="getAddress()"><img src="images/red-ball.gif" width=12 height=12 alt=" o "></a>
<a name="getAddress"><b>getAddress</b></a>
<pre>
  public abstract <a href="java.telephony.Address.html#_top_">Address</a> getAddress() throws <a href="java.telephony.PlatformException.html#_top_">PlatformException</a>
</pre>
<dl>
  <dd> Returns the Address object associated with this Connection. This Address
object reference remains valid throughout the lifetime of the Connection
object despite its current state. This Address reference does not change
after this object is created.
<p>
  <dl>
    <dt> <b>Returns:</b>
    <dd> The Address associated with this Connection.
    <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 TerminalConnections associated with this Connection.
TerminalConnection objects represent the relationship between a Call
and a specific Terminal endpoint. There may be zero TerminalConnections
associated with this Connection. In that case, this method returns null.
Connection objects lose their reference to a TerminalConnection once the
TerminalConnection moves into the TerminalConnection.DROPPED state. The
Provider must be in the Provider.IN_SERVICE state for this method to be
valid.
<p>
The pre-conditions for this method are:
<OL>
<LI>((this.getCall()).getProvider()).getState() == Provider.IN_SERVICE
</OL>
<p>
The following post-conditions of this are:
<OL>
<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 this
Connection, null if there are no TerminalConnections
    <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="disconnect()"><img src="images/red-ball.gif" width=12 height=12 alt=" o "></a>
<a name="disconnect"><b>disconnect</b></a>
<pre>
  public abstract void disconnect() 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> Drops a Connection from an active telephone call. The Connection's Address
is no longer associated with the telephone call. The Connection object
must either be in the Connection.CONNECTED, the Connection.ALERTING,
the Connection.INPROGRESS, or the Connection.FAILED states in order for
this method to succeed, although this pre-condition does not guarantee its
success. This method returns upon success when this Connection moves to
the Connection.DISCONNECTED state. Also, all of the TerminalConnections
associated with this Connection move to the TerminalConnection.DROPPED
state. These TerminalConnections are no longer reported by this
Connection. 
<p>
The pre-condition predicates for this method are:
<OL>
<LI>((this.getCall()).getProvider()).getState() == Provider.IN_SERVICE
<LI>this.getState() == Connection.CONNECTED or Connection.ALERTING
or Connection.FAILED or Connection.INPROGRESS
<LI>Let TerminalConnection tc[] = this.getTerminalConnections (see post-
conditions)
</OL>
<p>
The post-condition predicates for this method are:
<OL>
<LI>((this.getCall()).getProvider()).getState() == Provider.IN_SERVICE
<LI>this.getState() == Connection.DISCONNECTED
<LI>For all i, tc[i].getState() == TerminalConnection.DROPPED
<LI>this.getTerminalConnections() == null.
<LI>this is not an element of (this.getCall()).getConnections()
</OL>
<p>
When this method returns, the following events are reported on the
CallObserver interface for the Call associated with this Connection:
a <EM>java.telephony.events.ConnDisconnectedEv</EM> for this Connection, and a
<EM>java.telephony.events.TermConnDroppedEv</EM> for all of its Terminal
Connections.
<p>
  <dl>
    <dt> <b>Throws:</b> <a href="java.telephony.PrivilegeViolationException.html#_top_">PrivilegeViolationException</a>
    <dd> The application does not have
the authority to drop the Connection.
    <dt> <b>Throws:</b> <a href="java.telephony.ResourceUnavailableException.html#_top_">ResourceUnavailableException</a>
    <dd> An internal resource required
to drop a connection is not available.
    <dt> <b>Throws:</b> <a href="java.telephony.MethodNotSupportedException.html#_top_">MethodNotSupportedException</a>
    <dd> This method is not supported by
the implementation.
    <dt> <b>Throws:</b> <a href="java.telephony.InvalidStateException.html#_top_">InvalidStateException</a>
    <dd> Some object required for the successful
invocation of this method is not in the proper state as given by this
method's pre-conditions.
    <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.ConnDisconnectedEv.html#_top_">ConnDisconnectedEv</a>, <a href="java.telephony.events.TermConnDroppedEv
<p>.html#_top_">TermConnDroppedEv
<p></a>
  </dl>
</dl>
<a name="getConnectionCapabilities(java.telephony.Terminal, java.telephony.Address)"><img src="images/red-ball.gif" width=12 height=12 alt=" o "></a>
<a name="getConnectionCapabilities"><b>getConnectionCapabilities</b></a>
<pre>
  public abstract <a href="java.telephony.capabilities.ConnectionCapabilities.html#_top_">ConnectionCapabilities</a> getConnectionCapabilities(<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 ConnectionCapabilities object with respect to a Terminal and
an Address.
If null is passed as a Terminal parameter, the general/provider-wide 
Connection capabilities are returned.
<p>
  <dl>
    <dt> <b>Throws:</b> <a href="java.telephony.PlatformException.html#_top_">PlatformException</a>
    <dd> A platform-specific exception occurred.
  </dl>
</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.CallObserver.html#_top_">Previous</a>  <a href="java.telephony.JtapiPeer.html#_top_">Next</a>  <a href="AllNames.html">Index</a></pre>
</body>
</html>