java.telephony.callcontrol.callcontrolcall.html

JTAPI_html 用于JTAPI的HTML文档.

    <dt> <b>Throws:</b> <a href="java.telephony.PlatformException.html#_top_">PlatformException</a>
    <dd> A platform-specific exception occurred.
  </dl>
</dl>
<a name="setTransferEnable(boolean)"><img src="images/red-ball.gif" width=12 height=12 alt=" o "></a>
<a name="setTransferEnable"><b>setTransferEnable</b></a>
<pre>
  public abstract void setTransferEnable(boolean enable) throws <a href="java.telephony.InvalidArgumentException.html#_top_">InvalidArgumentException</a>, <a href="java.telephony.InvalidStateException.html#_top_">InvalidStateException</a>, <a href="java.telephony.MethodNotSupportedException.html#_top_">MethodNotSupportedException</a>, <a href="java.telephony.PrivilegeViolationException.html#_top_">PrivilegeViolationException</a>, <a href="java.telephony.PlatformException.html#_top_">PlatformException</a>
</pre>
<dl>
  <dd> Controls whether this Call object is permitted or able to perform
the transfering feature. If the 'enable' argument is true, this
method attempts to turn on the transfering ability. If 'false' this
method turns disallows the transfering feature. If the implementation
is unable to support transfering, a setTransferEnable(true) will
throw an exception.
<p>
This method must be called when the Call object is first create and
in the IDLE state. The provider must also be in service. The pre-
conditions are as follows:
<p>
<OL>
<LI>(call.getProvider()).getState() == IN_SERVICE
<LI>call.getState() == IDLE
</OL>
<p>
The post-conditions are as follows, given an exception is not thrown
and the variable 'enable' represents the value of the parameter passed
to this method.
<p>
<OL>
<LI>(call.getProvider()).getState() == IN_SERVICE
<LI>call.getState() == IDLE
<LI>enable = call.getTransferEnable();
</OL>
<p>
  <dl>
    <dt> <b>Parameters:</b>
    <dd> enable - True turns transfering on, false turns transfering off.
    <dt> <b>Throws:</b> <a href="java.telephony.InvalidArgumentException.html#_top_">InvalidArgumentException</a>
    <dd> The Connection object provided is
not associated with this Address object.
    <dt> <b>Throws:</b> <a href="java.telephony.InvalidStateException.html#_top_">InvalidStateException</a>
    <dd> The state of some object is not valid
as designated by the pre-conditions for this method.
    <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.PrivilegeViolationException.html#_top_">PrivilegeViolationException</a>
    <dd> The application does not have
the proper authority to invoke this method.
    <dt> <b>Throws:</b> <a href="java.telephony.PlatformException.html#_top_">PlatformException</a>
    <dd> A platform-specific exception occurred.
  </dl>
</dl>
<a name="getTransferEnable()"><img src="images/red-ball.gif" width=12 height=12 alt=" o "></a>
<a name="getTransferEnable"><b>getTransferEnable</b></a>
<pre>
  public abstract boolean getTransferEnable() throws <a href="java.telephony.PlatformException.html#_top_">PlatformException</a>
</pre>
<dl>
  <dd> Return true if transfering is enabled, false otherwise. Applications
may use this method initially to obtain the default value set by the
implementation and may attempt to change this value using the
CallControlCall.setTransferEnable() method.
<p>
  <dl>
    <dt> <b>Returns:</b>
    <dd> True if transfering is enabled, false otherwise.
    <dt> <b>Throws:</b> <a href="java.telephony.PlatformException.html#_top_">PlatformException</a>
    <dd> A platform-specific exception occurred.
  </dl>
</dl>
<a name="consult(java.telephony.TerminalConnection, java.lang.String)"><img src="images/red-ball.gif" width=12 height=12 alt=" o "></a>
<a name="consult"><b>consult</b></a>
<pre>
  public abstract <a href="#_top_">CallControlCall</a> consult(<a href="java.telephony.TerminalConnection.html#_top_">TerminalConnection</a> termconn,
                                          <a href="java.lang.String.html#_top_">String</a> address) throws <a href="java.telephony.InvalidStateException.html#_top_">InvalidStateException</a>, <a href="java.telephony.InvalidArgumentException.html#_top_">InvalidArgumentException</a>, <a href="java.telephony.MethodNotSupportedException.html#_top_">MethodNotSupportedException</a>, <a href="java.telephony.ResourceUnavailableException.html#_top_">ResourceUnavailableException</a>, <a href="java.telephony.PrivilegeViolationException.html#_top_">PrivilegeViolationException</a>, <a href="java.telephony.PlatformException.html#_top_">PlatformException</a>
</pre>
<dl>
  <dd> Begins a consultation Call with the existing Call. A consultation
Call is a new telephone Call placed to a telephony number address
and is associated with the current telephony Call. The purpose of
creating a consultation call is to either simply consult with another
party or eventually to either conference in or transfer to with the
existing party. The creation of the new Call behaves in a similar
manner as Call.connect(), however the consult() method establishes
a special association between the new Call and the current telephone
Call. The consult() method
exists because it is often a switch feature and establishes the
special association between the current telephone Call. The telephone
number address provided must be valid and complete.
<p>
As mentioned above, the purpose of creating a consulation Call is
often to perform a transfer() or conference() on these two Calls.
Applications must specify their purpose by first telling the switch
whether they intend to perform a conference() or transfer() or both
using the setConferenceEnable() and setTransferEnable() methods on
this object.
<p>
The originator of this new consultation call is given by a
TerminalConnection which must be part of the current Call object and
must be in the active state. The destination address for this new
call is given by the second argument. Therefore, the new call placed is
similar to the Call.connect() method in that the originating Terminal
is termconn.getTerminal() and the origination Address is
(termconn.getConnection()).getAddress().
<p>
This method places termconn in the HELD state and create a new Call
object. This Call object has two connection, one each for the
originating side and the destination side. Both of these Connections
are in the IDLE state. This new Call object is returned by the consult()
method. The Provider must also be IN_SERVICE. The pre-conditions of this
method are given below:
<p>
<OL>
<LI>(call.getProvider()).getState() == IN_SERVICE
<LI>call.getState() == ACTIVE
<LI>termconn is element of call.getConnections().getTerminalConnections()
<LI>termconn.getState() == ACTIVE
</OL>
<p>
The post-conditions for this method are as follows, where the Call object
returned is denoted by 'newcall'.
<p>
<OL>
<LI>(call.getProvider()).getState() == IN_SERVICE
<LI>call.getState() == ACTIVE
<LI>termconn.getState() == HELD
<LI>newcall.getState() == ACTIVE
<LI>Let c = newcall.getConnections() such that c.length == 2
<LI>c[0].getState == IDLE
<LI>c[1].getState == IDLE
</OL>
<p>
An application can expect that this new Call object will exhibit the
same Connection and TerminalConnection state transition scenarios as
Calls placed using Call.connect() and as described in the documentation
for that method.
<p>
  <dl>
    <dt> <b>Parameters:</b>
    <dd> termconn - The controlling TerminalConnection for the consultation
call.
    <dd> address - The destination telephone number address.
    <dt> <b>Returns:</b>
    <dd> The new consultation Call object.
    <dt> <b>Throws:</b> <a href="java.telephony.ResourceUnavailableException.html#_top_">ResourceUnavailableException</a>
    <dd> An internal resource neccessary
for the successful invocation of this method 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 consultation 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 consult() 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.
  </dl>
</dl>
<a name="consult(java.telephony.TerminalConnection)"><img src="images/red-ball.gif" width=12 height=12 alt=" o "></a>
<a name="consult"><b>consult</b></a>
<pre>
  public abstract <a href="#_top_">CallControlCall</a> consult(<a href="java.telephony.TerminalConnection.html#_top_">TerminalConnection</a> termconn) throws <a href="java.telephony.InvalidStateException.html#_top_">InvalidStateException</a>, <a href="java.telephony.InvalidArgumentException.html#_top_">InvalidArgumentException</a>, <a href="java.telephony.MethodNotSupportedException.html#_top_">MethodNotSupportedException</a>, <a href="java.telephony.ResourceUnavailableException.html#_top_">ResourceUnavailableException</a>, <a href="java.telephony.PrivilegeViolationException.html#_top_">PrivilegeViolationException</a>, <a href="java.telephony.PlatformException.html#_top_">PlatformException</a>
</pre>
<dl>
  <dd> This overloaded version of consult() is similar to the other version
of consult, except it does not take a destination string address as
an argument. Instead, it creates a Call object with one Connection in
the CallControlConnection.INITIATED state. Applications may use the
<EM>CallControlConnection.addToAddress()</EM> method to dial the
destination digits.
<p>
This method places termconn in the HELD state and create a new Call
object. This new Call object is returned by the consult() method. The
Provider must also be IN_SERVICE. The pre-conditions of this
method are given below:
<p>
<OL>
<LI>(call.getProvider()).getState() == IN_SERVICE
<LI>call.getState() == ACTIVE
<LI>termconn is element of call.getConnections().getTerminalConnections()
<LI>termconn.getState() == ACTIVE
</OL>
<p>
The post-conditions for this method are as follows, where the Call object
returned is denoted by 'newcall'.
<p>
<OL>
<LI>(call.getProvider()).getState() == IN_SERVICE
<LI>call.getState() == ACTIVE
<LI>termconn.getState() == HELD
<LI>newcall.getState() == ACTIVE
<LI>Let c = newcall.getConnections() such that c.length == 1
<LI>c[0].getState == INITIATED
</OL>
<p>
  <dl>
    <dt> <b>Parameters:</b>
    <dd> termconn - The controlling TerminalConnection for the consultation
call.
    <dt> <b>Returns:</b>
    <dd> The new consultation Call object.
    <dt> <b>Throws:</b> <a href="java.telephony.ResourceUnavailableException.html#_top_">ResourceUnavailableException</a>
    <dd> An internal resource neccessary
for the successful invocation of this method 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 consultation 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 consult() 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.
  </dl>
</dl>
<hr>
<pre>
<a href="packages.html">All Packages</a>  <a href="tree.html">Class Hierarchy</a>  <a href="Package-java.telephony.callcontrol.html">This Package</a>  <a href="java.telephony.callcontrol.CallControlAddressObserver.html#_top_">Previous</a>  <a href="java.telephony.callcontrol.CallControlCallObserver.html#_top_">Next</a>  <a href="AllNames.html">Index</a></pre>
</body>
</html>