java.telephony.provider.html

JTAPI_html 用于JTAPI的HTML文档.

<LI>call.getState() == Call.IDLE.
<LI>call.getConnections() == null
<LI>call is an element of this.getCalls()
</OL>
<p>
  <dl>
    <dt> <b>Returns:</b>
    <dd> The new Call object.
    <dt> <b>Throws:</b> <a href="java.telephony.ResourceUnavailableException.html#_top_">ResourceUnavailableException</a>
    <dd> An internal resource neccessary
to create a new Call object is unavailable.
    <dt> <b>Throws:</b> <a href="java.telephony.InvalidStateException.html#_top_">InvalidStateException</a>
    <dd> The Provider is not in the
Provider.IN_SERVICE state.
    <dt> <b>Throws:</b> <a href="java.telephony.PrivilegeViolationException.html#_top_">PrivilegeViolationException</a>
    <dd> The application does not have
the proper authority to create a new telephone call object.
    <dt> <b>Throws:</b> <a href="java.telephony.MethodNotSupportedException.html#_top_">MethodNotSupportedException</a>
    <dd> The implementation does not support
creating new Call objects.
    <dt> <b>Throws:</b> <a href="java.telephony.PlatformException.html#_top_">PlatformException</a>
    <dd> A platform-specific exception occurred.
  </dl>
</dl>
<a name="addObserver(java.telephony.ProviderObserver)"><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.ProviderObserver.html#_top_">ProviderObserver</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 Provider. The ProviderObserver reports all
Provider-related state changes as events. The Provider bject will report
events to this ProviderObserver object for the lifetime
of the Provider object or until the observer is removed with the
<EM>Provider.removeObserver()</EM> method.
<p>
This method is valid anytime and has no pre-conditions. Application must
have the ability to add observers to Providers so they can monitor
the changes in state in the Provider.
<p>
If an application attempts to add an instance of an observer already
present on this Provider, 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>
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.ProviderObserver.html#_top_">ProviderObserver</a>[] getObservers() throws <a href="java.telephony.PlatformException.html#_top_">PlatformException</a>
</pre>
<dl>
  <dd> Returns a list of all ProviderObservers associated with this call object.
If no observers exist on this Provider, then this method returns null.
<p>
There are no preconditions for this method. The application must be
able to get the list of observers even when the Provider is not in
the IN_SERVICE state.
<p>
The post-conditions for this method are:
<OL>
<LI>Let ProviderObserver[] obs = this.getObservers()
<LI>obs == null or obs.length >= 1
</OL>
<p>
  <dl>
    <dt> <b>Returns:</b>
    <dd> An array of ProviderObserver objects associated with this
Provider.
    <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.ProviderObserver)"><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.ProviderObserver.html#_top_">ProviderObserver</a> observer) throws <a href="java.telephony.InvalidArgumentException.html#_top_">InvalidArgumentException</a>
</pre>
<dl>
  <dd> Removes the given observer from the Provider. If successful, the observer
will no longer receive events generated by this call object.
<p>
There are no pre-conditions for this method. Application should be able
to remove observers even if the Provider is not in the IN_SERVICE state.
<p>
Also, if an observer is not part of the Provider, then this method
fails silently, i.e. no observer is removed an no exception is thrown.
<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="getProviderCapabilities(java.telephony.Terminal)"><img src="images/red-ball.gif" width=12 height=12 alt=" o "></a>
<a name="getProviderCapabilities"><b>getProviderCapabilities</b></a>
<pre>
  public abstract <a href="java.telephony.capabilities.ProviderCapabilities.html#_top_">ProviderCapabilities</a> getProviderCapabilities(<a href="java.telephony.Terminal.html#_top_">Terminal</a> term) throws <a href="java.telephony.InvalidArgumentException.html#_top_">InvalidArgumentException</a>, <a href="java.telephony.PlatformException.html#_top_">PlatformException</a>
</pre>
<dl>
  <dd> Returns the ProviderCapabilities object with respect to a Terminal.
If null is passed as a Terminal parameter, the general/provider-wide 
Provider capabilities
are returned.
<p>
  <dl>
    <dt> <b>Throws:</b> <a href="java.telephony.InvalidArgumentException.html#_top_">InvalidArgumentException</a>
    <dd> invalid argument exception occurred
    <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.
If null is passed as a Terminal parameter, the general/provider-wide 
Call capabilities
are returned.
<p>
  <dl>
    <dt> <b>Parameters:</b>
    <dd> terminal - the terminal whose call capabilities are being queried
    <dt> <b>Throws:</b> <a href="java.telephony.InvalidArgumentException.html#_top_">InvalidArgumentException</a>
    <dd> invalid argument exception occurred
    <dt> <b>Throws:</b> <a href="java.telephony.PlatformException.html#_top_">PlatformException</a>
    <dd> A platform-specific exception occurred.
  </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.
If null is passed as a Terminal parameter, the general/provider-wide 
Connection capabilities
are returned.
<p>
  <dl>
    <dt> <b>Parameters:</b>
    <dd> terminal - the terminal whose connection capabilities are being 
queried
    <dt> <b>Throws:</b> <a href="java.telephony.InvalidArgumentException.html#_top_">InvalidArgumentException</a>
    <dd> invalid argument exception occurred
    <dt> <b>Throws:</b> <a href="java.telephony.PlatformException.html#_top_">PlatformException</a>
    <dd> A platform-specific exception occurred.
  </dl>
</dl>
<a name="getAddressCapabilities(java.telephony.Terminal)"><img src="images/red-ball.gif" width=12 height=12 alt=" o "></a>
<a name="getAddressCapabilities"><b>getAddressCapabilities</b></a>
<pre>
  public abstract <a href="java.telephony.capabilities.AddressCapabilities.html#_top_">AddressCapabilities</a> getAddressCapabilities(<a href="java.telephony.Terminal.html#_top_">Terminal</a> terminal) throws <a href="java.telephony.InvalidArgumentException.html#_top_">InvalidArgumentException</a>, <a href="java.telephony.PlatformException.html#_top_">PlatformException</a>
</pre>
<dl>
  <dd> Gets the AddressCapabilities object with respect to a Terminal.
If null is passed as a Terminal parameter, the general/provider-wide 
Address capabilities
are returned.
<p>
  <dl>
    <dt> <b>Parameters:</b>
    <dd> terminal - the terminal whose address capabilities are being 
queried
    <dt> <b>Throws:</b> <a href="java.telephony.InvalidArgumentException.html#_top_">InvalidArgumentException</a>
    <dd> invalid argument exception occurred
    <dt> <b>Throws:</b> <a href="java.telephony.PlatformException.html#_top_">PlatformException</a>
    <dd> A platform-specific exception occurred.
  </dl>
</dl>
<a name="getTerminalConnectionCapabilities(java.telephony.Terminal)"><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) 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 of a Terminal.
If null is passed as a Terminal parameter, the general/provider-wide 
TerminalConnection capabilities
are returned.
<p>
  <dl>
    <dt> <b>Parameters:</b>
    <dd> terminal - the terminal whose terminal connection capabilities 
are being queried
    <dt> <b>Throws:</b> <a href="java.telephony.InvalidArgumentException.html#_top_">InvalidArgumentException</a>
    <dd> invalid argument exception occurred
    <dt> <b>Throws:</b> <a href="java.telephony.PlatformException.html#_top_">PlatformException</a>
    <dd> A platform-specific exception occurred.
  </dl>
</dl>
<a name="getTerminalCapabilities(java.telephony.Terminal)"><img src="images/red-ball.gif" width=12 height=12 alt=" o "></a>
<a name="getTerminalCapabilities"><b>getTerminalCapabilities</b></a>
<pre>
  public abstract <a href="java.telephony.capabilities.TerminalCapabilities.html#_top_">TerminalCapabilities</a> getTerminalCapabilities(<a href="java.telephony.Terminal.html#_top_">Terminal</a> terminal) throws <a href="java.telephony.InvalidArgumentException.html#_top_">InvalidArgumentException</a>, <a href="java.telephony.PlatformException.html#_top_">PlatformException</a>
</pre>
<dl>
  <dd> Gets the TerminalCapabilities object with respect to a Terminal.
If null is passed as a Terminal parameter, the general/provider-wide 
Terminal capabilities
are returned.
<p>
  <dl>
    <dt> <b>Parameters:</b>
    <dd> terminal - the terminal whose capabilities are being queried
    <dt> <b>Throws:</b> <a href="java.telephony.InvalidArgumentException.html#_top_">InvalidArgumentException</a>
    <dd> invalid argument exception occurred
    <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.JtapiPeer.html#_top_">Previous</a>  <a href="java.telephony.ProviderObserver.html#_top_">Next</a>  <a href="AllNames.html">Index</a></pre>
</body>
</html>