java.telephony.call.html

JTAPI_html 用于JTAPI的HTML文档.

   Connections. The first element at index 0 represents the originating
   Connection. The second element at index 1 represents the destination
   Connection. Both Connections are in the Connection.IDLE state.
<p>
   The following events are delivered to the application via a CallObserver
   on this Call: a <EM>java.telephony.events.CallActiveEv</EM>, a
   <EM>java.telephony.events.ConnCreatedEv</EM> for each of the two Connections
   created.
<p>
<LI>Once the Provider begins to place the telephone call, the originating
   Connection moves from the Connection.IDLE state into the
   Connection.CONNECTED state. A TerminalConnection is created in the
   TerminalConnection.ACTIVE state between the originating Terminal and
   the Call.
<p>
   The following events are delivered to the application via a CallObserver
   on this Call: a <EM>java.telephony.events.ConnConnectedEv</EM> for the
   originating Connection, a <EM>java.telephony.events.TermConnCreatedEv</EM>
   for the new TerminalConnection created, and a
   <EM>java.telephony.events.TermConnActiveEv</EM> for the new Terminal
   Connection.
<p>
  Depending upon the configuration of the switch, additional
  TerminalConnections may be created. These TerminalConnections will be
  associated with Terminals which have the originating Address as one of
  their Addresseses. Unfortunately, there is no way for the implementation
  to tell which TerminalConnections will be created in advance, only that
  the number cannot be greater than the number of Terminals associated
  with the originating Address and each TerminalConnection must go to
  one of those Terminals associated with the originating Address. If such
  a Terminal Connection is created, it will be in the
  TerminalConnection.PASSIVE state.
<p>
  Additional events are delivered because of the above paragraph: a
  <EM>java.telephony.events.TermConnCreateEv</EM> for all additional
  Terminal Connections created, and a
  <EM>java.telephony.events.TermConnPassiveEv</EM> for each of those Terminal
  Connections. 
<LI>The destination Connection moves from the Connection.IDLE state into
   the TerminalConnection.INPROGRESS state.
<p>
   The following events are delivered to the application via the
   CallObserver interface: a <EM>java.telephony.events.ConnInProgressEv</EM>
   for the destination Connection.
<LI>The destination Connection moves from the Connection.INPROGRESS state
   into the Connection.FAILED state.
<p>
   The following events are delivered to the application via the
   CallObserver interface: a <EM>java.telephony.events.ConnFailedEv</EM> for
   the destination Connection.
</OL>
<p>
The post condition predicates for scenario 2 are as follows. These
post-conditions state what is true about the call model after the final
step of scenario 1 completes.
<OL>
<LI>this.getState() == Call.ACTIVE
<LI>(this.getProvider()).getState() == Provider.IN_SERVICE
<LI>Let Connection c[] = this.getConnections()
<LI>c[0].getState() == Connection.CONNECTED
<LI>c[1].getState() == Connection.FAILED
<LI>Let TerminalConnection origtc[] = c[0].getTerminalConnections()
<LI>There exists an i, such that origtc[i].getState() ==
TerminalConnection.ACITVE.
</OL>
<p>
  <dl>
    <dt> <b>Parameters:</b>
    <dd> origterm - The originating Terminal for this telephone call.
    <dd> origaddr - The originating Address for this telephone call.
    <dd> destaddr - The destination Address for this telephone call.
    <dt> <b>Throws:</b> <a href="java.telephony.ResourceUnavailableException.html#_top_">ResourceUnavailableException</a>
    <dd> An internal resource neccessary
for placing the phone call is unavailable.
    <dt> <b>Throws:</b> <a href="java.telephony.PrivilegeViolationException.html#_top_">PrivilegeViolationException</a>
    <dd> The application does not have
the proper authority to place a telephone call.
    <dt> <b>Throws:</b> <a href="java.telephony.InvalidPartyException.html#_top_">InvalidPartyException</a>
    <dd> Either the originator or the destination
does not represent a valid party required to place a telephone call.
    <dt> <b>Throws:</b> <a href="java.telephony.InvalidArgumentException.html#_top_">InvalidArgumentException</a>
    <dd> An argument provided is not valid
either by not providing enough information for connect() or is
inconsistent with another argument.
    <dt> <b>Throws:</b> <a href="java.telephony.InvalidStateException.html#_top_">InvalidStateException</a>
    <dd> Some object required by this method is
not is a valid state as designated by the pre-conditions for this method.
    <dt> <b>Throws:</b> <a href="java.telephony.MethodNotSupportedException.html#_top_">MethodNotSupportedException</a>
    <dd> The implementation does not
support 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.CallActiveEv.html#_top_">CallActiveEv</a>, <a href="java.telephony.events.ConnAlertingEv.html#_top_">ConnAlertingEv</a>, <a href="java.telephony.events.ConnConnectedEv.html#_top_">ConnConnectedEv</a>, <a href="java.telephony.events.ConnCreatedEv.html#_top_">ConnCreatedEv</a>, <a href="java.telephony.events.ConnInProgressEv.html#_top_">ConnInProgressEv</a>, <a href="java.telephony.events.TermConnActiveEv.html#_top_">TermConnActiveEv</a>, <a href="java.telephony.events.TermConnCreatedEv.html#_top_">TermConnCreatedEv</a>, <a href="java.telephony.events.TermConnDroppedEv.html#_top_">TermConnDroppedEv</a>, <a href="java.telephony.events.TermConnPassiveEv.html#_top_">TermConnPassiveEv</a>, <a href="java.telephony.events.TermConnRingingEv
<p>.html#_top_">TermConnRingingEv
<p></a>
  </dl>
</dl>
<a name="addObserver(java.telephony.CallObserver)"><img src="images/red-ball.gif" width=12 height=12 alt=" o "></a>
<a name="addObserver"><b>addObserver</b></a>
<pre>
  public abstract void addObserver(<a href="java.telephony.CallObserver.html#_top_">CallObserver</a> observer) throws <a href="java.telephony.ResourceUnavailableException.html#_top_">ResourceUnavailableException</a>, <a href="java.telephony.PlatformException.html#_top_">PlatformException</a>
</pre>
<dl>
  <dd> Adds an observer to the Call. The CallObserver reports all Call-related
state changes as events as well as all Connection state changes and
TerminalConnection state changes.  The Call object will report events to
this CallObserver object for the lifetime of the Call object or until the
observer is removed with the <EM>Call.removeObserver()</EM> method or
until the Call moves into the Call.INVALID state. The Call must be either
in the Call.IDLE state or Call.ACTIVE state as a pre-condition for this
method.
<p>
By default, when an observer is added to a telephone call, the first
batch of events may be a "snapshot". That is, if the observer was added
certain state changes in the call, the first batch of events will inform
the application of the current state of the call. Note that these
snapshot events do NOT provide a history of all events on the call. Rather
they provide the minimum neccessary event to bring the application
up-to-date with the current state of the call.
<p>
If an application attempts to add an instance of an observer already
present on this Call, then repeated attempts to add the instance
of the observer will silently fail, i.e. multiple instances of an
observer are not added and no exception will be thrown.
<p>
There are no pre-conditions for this method.
<p>
The post-condition predicates for this method are:
<OL>
<LI>observer is an element of this.getObservers()
</OL>
<p>
  <dl>
    <dt> <b>Parameters:</b>
    <dd> observer - The observer being added.
    <dt> <b>Throws:</b> <a href="java.telephony.ResourceUnavailableException.html#_top_">ResourceUnavailableException</a>
    <dd> The resource limit for the
numbers of observers has been exceeded.
    <dt> <b>Throws:</b> <a href="java.telephony.PlatformException.html#_top_">PlatformException</a>
    <dd> A platform-specific exception occurred.
  </dl>
</dl>
<a name="getObservers()"><img src="images/red-ball.gif" width=12 height=12 alt=" o "></a>
<a name="getObservers"><b>getObservers</b></a>
<pre>
  public abstract <a href="java.telephony.CallObserver.html#_top_">CallObserver</a>[] getObservers() throws <a href="java.telephony.PlatformException.html#_top_">PlatformException</a>
</pre>
<dl>
  <dd> Returns a list of all CallObservers associated with this call object.
If no observers are on this Call object, then this method returns null.
<p>
There are no pre-conditions for this method.
<p>
The post-conditions for this method are:
<OL>
<LI>Let CallObserver[] obs = this.getObservers()
<LI>obs == null or obs.length >= 1
</OL>
<p>
  <dl>
    <dt> <b>Returns:</b>
    <dd> An array of CallObserver objects associated with this
Call.
    <dt> <b>Throws:</b> <a href="java.telephony.PlatformException.html#_top_">PlatformException</a>
    <dd> A platform-specific exception occurred.
  </dl>
</dl>
<a name="removeObserver(java.telephony.CallObserver)"><img src="images/red-ball.gif" width=12 height=12 alt=" o "></a>
<a name="removeObserver"><b>removeObserver</b></a>
<pre>
  public abstract void removeObserver(<a href="java.telephony.CallObserver.html#_top_">CallObserver</a> observer) throws <a href="java.telephony.PlatformException.html#_top_">PlatformException</a>
</pre>
<dl>
  <dd> Removes the given observer from the Call. If successful, the observer
will no longer receive events generated by this call object.
<p>
Also, if an observer is not part of the Call, then this method
fails silently, i.e. no observer is removed an no exception is thrown.
<p>
There are no pre-conditions for this method.
<p>
The post-condition predicates for this method are:
<OL>
<LI>observer is not an element of this.getObservers()
</OL>
<p>
  <dl>
    <dt> <b>Parameters:</b>
    <dd> observer - The observer which is being removed.
    <dt> <b>Throws:</b> <a href="java.telephony.PlatformException.html#_top_">PlatformException</a>
    <dd> A platform-specific exception occurred.
  </dl>
</dl>
<a name="getCallCapabilities(java.telephony.Terminal, java.telephony.Address)"><img src="images/red-ball.gif" width=12 height=12 alt=" o "></a>
<a name="getCallCapabilities"><b>getCallCapabilities</b></a>
<pre>
  public abstract <a href="java.telephony.capabilities.CallCapabilities.html#_top_">CallCapabilities</a> getCallCapabilities(<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 CallCapabilities object with respect to a Terminal and an
Address.
If null is passed as a Terminal parameter, the general/provider-wide Call 
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.AddressObserver.html#_top_">Previous</a>  <a href="java.telephony.CallObserver.html#_top_">Next</a>  <a href="AllNames.html">Index</a></pre>
</body>
</html>