java.telephony.callcontrol.callcontrolconnection.html

JTAPI_html 用于JTAPI的HTML文档.

  <dd> Accepts a telephone call. This method is associated most commonly
with ISDN-type protocols which support the OFFERING state. Incoming
telephony calls are sometimes first "offered" to an address for
acceptance. Only after a call is accepted does the standard notions
of alerting take place. This method returns successfully when the
call has been accepted and this Connection has moved into the ALERTING
state, otherwise an exception is thrown to signal an error.
<p>
This Connection object must be in the OFFERING state. The Provider must
also be IN_SERVICE. These pre-conditions are given below:
<p>
<OL>
<LI>((this.getCall()).getProvider()).getState() == IN_SERVICE
<LI>this.getCallControlState() == OFFERING.
</OL>
<p>
The post-conditions are given below:
<OL>
<LI>((this.getCall()).getProvider()).getState() == IN_SERVICE
<LI>this.getCallControlState() == ALERTING.
</OL>
<p>
  <dl>
    <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.ResourceUnavailableException.html#_top_">ResourceUnavailableException</a>
    <dd> An internal resource neccessary
for the successful invocation of this method is not available.
    <dt> <b>Throws:</b> <a href="java.telephony.PlatformException.html#_top_">PlatformException</a>
    <dd> A platform-specific exception occurred.
  </dl>
</dl>
<a name="reject()"><img src="images/red-ball.gif" width=12 height=12 alt=" o "></a>
<a name="reject"><b>reject</b></a>
<pre>
  public abstract void reject() throws <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.ResourceUnavailableException.html#_top_">ResourceUnavailableException</a>, <a href="java.telephony.PlatformException.html#_top_">PlatformException</a>
</pre>
<dl>
  <dd> Rejects a telephone call. This method is associated most commonly
with ISDN-type protocols which support the OFFERING state. Incoming
telephony calls are sometimes first "offered" to an address for
acceptance. Only after a call is accepted does the standard notions
of alerting take place. A call may also be rejected, where the call
does not proceed to the alerting stage. This method returns when
this Connection successfully moves into the DISCONNECTED state, otherwise,
an exception is thrown to signal an error.
<p>
This Connection object must be in OFFERING state. The Provider must
also be IN_SERVICE. These pre-conditions are given below:
<p>
<OL>
<LI>((this.getCall()).getProvider()).getState() == IN_SERVICE
<LI>this.getCallControlState() == OFFERING.
</OL>
<p>
The post-conditions are given below:
<OL>
<LI>((this.getCall()).getProvider()).getState() == IN_SERVICE
<LI>this.getCallControlState() == DISCONNECTED.
</OL>
<p>
  <dl>
    <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.ResourceUnavailableException.html#_top_">ResourceUnavailableException</a>
    <dd> An internal resource neccessary
for the successful invocation of this method is not available.
    <dt> <b>Throws:</b> <a href="java.telephony.PlatformException.html#_top_">PlatformException</a>
    <dd> A platform-specific exception occurred.
  </dl>
</dl>
<a name="redirect(java.lang.String)"><img src="images/red-ball.gif" width=12 height=12 alt=" o "></a>
<a name="redirect"><b>redirect</b></a>
<pre>
  public abstract <a href="#_top_">CallControlConnection</a> redirect(<a href="java.lang.String.html#_top_">String</a> destinationAddress) throws <a href="java.telephony.InvalidStateException.html#_top_">InvalidStateException</a>, <a href="java.telephony.InvalidPartyException.html#_top_">InvalidPartyException</a>, <a href="java.telephony.MethodNotSupportedException.html#_top_">MethodNotSupportedException</a>, <a href="java.telephony.PrivilegeViolationException.html#_top_">PrivilegeViolationException</a>, <a href="java.telephony.ResourceUnavailableException.html#_top_">ResourceUnavailableException</a>, <a href="java.telephony.PlatformException.html#_top_">PlatformException</a>
</pre>
<dl>
  <dd> Redirects a telephone call to another telephone number. This feature
is very similar to a transfer feature, however, the application may
use the redirect() method when the Connection is either in the ALERTING
or OFFERING CallControlConnection states. The telephone address provided
must be valid and complete.
<p>
The Connection must be in the OFFERING or ALERTING state.
The first argument, destinationAddress, must be a valid telephone number
to dial. The Connection must also be associated with this Address
object and the Provider must be IN_SERVICE. These pre-conditions are given
below:
<p>
<OL>
<LI>((this.getCall()).getProvider()).getState() == IN_SERVICE
<LI>this.getCallControlState() == OFFERING or ALERTING
<LI>destinationAddress must be a valid telephone number.
</OL>
<p>
If successful, this method creates a new Connection associated with the
Address object, as given by the destinationAddress string. This new
Connection is in the IDLE state and is returned by this method. The
Connection given as an argument moves to the DISCONNECTED state when
this method returns. All of its TerminalConnections move to the DROPPED
state as well. These post-conditions are given as follows, where
'connection' is the argument, and 'newconnection' is the return value.
<p>
<OL>
<LI>((this.getCall()).getProvider()).getState() == IN_SERVICE
<LI>this.getCallControlState() == DISCONNECTED.
<LI>newconnection.getCallControlState() == IDLE
<LI>Let TerminalConnection tc[] = this.getTerminalConnections()
<LI>For all i, tc[i].getCallControlState() == DROPPED
</OL>
<p>
The newconnection object acts similar to a destination connection when
a telephone call is first placed. The Call.connect() method provides the
scenarios for this destination Connection and the possible state changes
it may undergo.
<p>
  <dl>
    <dt> <b>Parameters:</b>
    <dd> desintationAddress - The Connection is rerouted to this address
    <dt> <b>Returns:</b>
    <dd> The new Connection associated with the Address object of the
new address.
    <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.InvalidPartyException.html#_top_">InvalidPartyException</a>
    <dd> The party to which this call is
redirected is not valid.
    <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.ResourceUnavailableException.html#_top_">ResourceUnavailableException</a>
    <dd> An internal resource neccessary
for the successful invocation of this method is not available.
    <dt> <b>Throws:</b> <a href="java.telephony.PlatformException.html#_top_">PlatformException</a>
    <dd> A platform-specific exception occurred.
    <dt> <b>Throws:</b> <a href="java.lang.Exception.html#_top_">Exception</a>
    <dd> An implementation-specific exception occurred.
  </dl>
</dl>
<a name="addToAddress(java.lang.String)"><img src="images/red-ball.gif" width=12 height=12 alt=" o "></a>
<a name="addToAddress"><b>addToAddress</b></a>
<pre>
  public abstract void addToAddress(<a href="java.lang.String.html#_top_">String</a> additionalAddress) throws <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.ResourceUnavailableException.html#_top_">ResourceUnavailableException</a>, <a href="java.telephony.PlatformException.html#_top_">PlatformException</a>
</pre>
<dl>
  <dd> Appends additional address information onto an existing Connection.
This method is used when part of a telephone number has been dialed
and the application may complete the address with this method.
<p>
This Connection must be in the DIALING or INITIATED state and the 
Provider must also
be IN_SERVICE. These pre-conditions are given below:
<p>
<OL>
<LI>((this.getCall()).getProvider()).getState() == IN_SERVICE
<LI>this.getCallControlState() == DIALING | INITIATED.
</OL>
<p>
The post-conditions of this method depend upon whether the provided
additional addressing information is enough to complete the address.
This is determined by the switch. If the additional addressing information
is enough, the Connection moves from the DIALING state into the
ESTABLISHED state. If not, the Connection remains in the DIALING state.
The following post-conditions reflect this:
<p>
<OL>
<LI>((this.getCall()).getProvider()).getState() == IN_SERVICE
<LI>this.getCallControlState() == DIALING if the addressing information was
not enough as determined by the switch.
<LI>this.getCallControlState() == ESTABLISHED if the addressing information was
sufficient to complete the address, determined by the switch
</OL>
<p>
  <dl>
    <dt> <b>Parameters:</b>
    <dd> additionalAddress - The additional addressing information.
    <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.ResourceUnavailableException.html#_top_">ResourceUnavailableException</a>
    <dd> An internal resource neccessary
for the successful invocation of this method is not available.
    <dt> <b>Throws:</b> <a href="java.telephony.PlatformException.html#_top_">PlatformException</a>
    <dd> A platform-specific exception occurred.
  </dl>
</dl>
<a name="park(java.lang.String)"><img src="images/red-ball.gif" width=12 height=12 alt=" o "></a>
<a name="park"><b>park</b></a>
<pre>
  public abstract <a href="#_top_">CallControlConnection</a> park(<a href="java.lang.String.html#_top_">String</a> destAddress) throws <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.InvalidPartyException.html#_top_">InvalidPartyException</a>, <a href="java.telephony.ResourceUnavailableException.html#_top_">ResourceUnavailableException</a>, <a href="java.telephony.PlatformException.html#_top_">PlatformException</a>
</pre>
<dl>
  <dd> Parks an active Connection to another Address. "Parking" a Connection
transfers that Connection to another address and drops it from the current
telephone call. The Call Parking feature is very much like transfering
a telephone call except the new address does not alert. The new Connection
is in a special QUEUED state. Applications may then use the pickup()
method to "unpark" this call. The telephone address provided must be
valid and complete.
<p>
This Connection must be in the ESTABLISHED state.
The destAddress parameter must be a complete, valid telephone number
which can be dialed. The Provider must also be IN_SERVICE. These pre-
conditions are given below:
<p>
<OL>
<LI>((this.getCall()).getProvider()).getState() == IN_SERVICE
<LI>this.getCallControlState() == ESTABLISHED
<LI>destAddress must be a valid and complete telephone number.
</OL>
<p>
This method moves the connection into the
DISCONNECTED state and creates a new connection attached to an Address
object which corresponds to the destAddress argument. This new connection
is in the CallControlConnection QUEUED state and is returned by this
method. ALl of the TerminalConnections which are part of this Connection
move to the DROPPED state.
The post conditions for this method are given below, where
'newconnection' is the Connection returned by this method.
<p>
<OL>
<LI>((this.getCall()).getProvider()).getState() == IN_SERVICE
<LI>newconnection.getCallControlState() == QUEUED
<LI>this.getCallControlState() == DISCONNECTED
<LI>For all termconn = this.getTerminalConnections(),
termconn.getState() == DROPPED
</OL>
<p>
  <dl>
    <dt> <b>Parameters:</b>
    <dd> destAddress - The address at which this connection is to be parked.
    <dt> <b>Returns:</b>
    <dd> The new Connection.
    <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.InvalidPartyException.html#_top_">InvalidPartyException</a>
    <dd> The party to which to party the
Connection is invalid.
    <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.ResourceUnavailableException.html#_top_">ResourceUnavailableException</a>
    <dd> An internal resource neccessary
for the successful invocation of this method is not available.
    <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.CallControlCallObserver.html#_top_">Previous</a>  <a href="java.telephony.callcontrol.CallControlTerminal.html#_top_">Next</a>  <a href="AllNames.html">Index</a></pre>
</body>
</html>