📄 java.telephony.address.html
字号:
<!--NewPage--><html><head><!-- Generated by javadoc on Fri Feb 07 16:42:30 PST 1997 --><a name="_top_"></a><title> Interface java.telephony.Address</title></head><body><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="Package-java.telephony.html">Previous</a> <a href="java.telephony.AddressObserver.html#_top_">Next</a> <a href="AllNames.html">Index</a></pre><hr><h1> Interface java.telephony.Address</h1><dl> <dt> public interface <b>Address</b> <dt> extends <a href="java.lang.Object.html#_top_">Object</a></dl>An Address object represents what we commonly think of as a "telephonenumber." In more rare implementations where the underlying network is nota telephony network, this address may represent something else. For example,if the underlying network is IP, this address might represent an IPaddress (e.g. 18.203.0.49). An Address object has a "name" which correspondsto this telephony address which does not change throughout the lifetime ofthe object.<p>An Address can be associated with a Call via a Connection object. TheAddress object represents the logical endpoint of a telephone call. One themost simplistic view, an application can see a telephone call as being fromone Address to another. When the Connection object moves into theConnection.DISCONNECTED state, the Address object loses its reference to theConnection object. This implies that the Connection object is no longerreported via the <EM>Address.getConnection</EM> method.<p>Address objects are responsible for reporting information about telephonecalls which were created before the Provider. In other words, Addressobject must report on all Connection objects which are part of all telephonecalls in the Provider's domain--even if these telephone Calls were createdbefore the Provider was created.<P>Address objects may be associated with zero or many Terminal objects. AnAddress which is associated with more than one Terminal object reflects thefact that a telephone number may appear on more than one physical telephoneset.<p>All changes in an Address object are reported via the AddressObserverinterface. Applications instantiate an object which implements thisinterface and begins this delivery of events to this object using the<EM>Address.addObserver()</EM> method.<p><dl> <dt> <b>See Also:</b> <dd> <a href="java.telephony.AddressObserver.html#_top_">AddressObserver</a></dl><hr><a name="index"></a><h2> <img src="images/method-index.gif" width=207 height=38 alt="Method Index"></h2><dl> <dt> <img src="images/red-ball-small.gif" width=6 height=6 alt=" o "> <a href="#addCallObserver(java.telephony.CallObserver)"><b>addCallObserver</b></a>(CallObserver) <dd> Adds an observer to a Call object when this Address object first becomespart of that Call. <dt> <img src="images/red-ball-small.gif" width=6 height=6 alt=" o "> <a href="#addObserver(java.telephony.AddressObserver)"><b>addObserver</b></a>(AddressObserver) <dd> Adds an observer to the Address. <dt> <img src="images/red-ball-small.gif" width=6 height=6 alt=" o "> <a href="#getAddressCapabilities(java.telephony.Terminal)"><b>getAddressCapabilities</b></a>(Terminal) <dd> Gets the AddressCapabilities object with respect to a Terminal If null is passed as a Terminal parameter, the general/provider-wideAddress capabilities are returned. <dt> <img src="images/red-ball-small.gif" width=6 height=6 alt=" o "> <a href="#getCallObservers()"><b>getCallObservers</b></a>() <dd> Returns a list of all CallObservers associated with this Addressobject. <dt> <img src="images/red-ball-small.gif" width=6 height=6 alt=" o "> <a href="#getConnections()"><b>getConnections</b></a>() <dd> Returns an array of Connection object currently associated with thisAddress object. <dt> <img src="images/red-ball-small.gif" width=6 height=6 alt=" o "> <a href="#getName()"><b>getName</b></a>() <dd> Returns the name of the Address. <dt> <img src="images/red-ball-small.gif" width=6 height=6 alt=" o "> <a href="#getObservers()"><b>getObservers</b></a>() <dd> Returns a list of all AddressObservers associated with this Addressobject. <dt> <img src="images/red-ball-small.gif" width=6 height=6 alt=" o "> <a href="#getProvider()"><b>getProvider</b></a>() <dd> Returns the Provider associated with this Address. <dt> <img src="images/red-ball-small.gif" width=6 height=6 alt=" o "> <a href="#getTerminals()"><b>getTerminals</b></a>() <dd> Returns an array of Terminals associated with this Address object. <dt> <img src="images/red-ball-small.gif" width=6 height=6 alt=" o "> <a href="#removeCallObserver(java.telephony.CallObserver)"><b>removeCallObserver</b></a>(CallObserver) <dd> Removes the given CallObserver from the Address. <dt> <img src="images/red-ball-small.gif" width=6 height=6 alt=" o "> <a href="#removeObserver(java.telephony.AddressObserver)"><b>removeObserver</b></a>(AddressObserver) <dd> Removes the given observer from the Address.</dl><a name="methods"></a><h2> <img src="images/methods.gif" width=151 height=38 alt="Methods"></h2><a name="getName()"><img src="images/red-ball.gif" width=12 height=12 alt=" o "></a><a name="getName"><b>getName</b></a><pre> public abstract <a href="java.lang.String.html#_top_">String</a> getName() throws <a href="java.telephony.PlatformException.html#_top_">PlatformException</a></pre><dl> <dd> Returns the name of the Address. Each Address possesses a uniquename. This name corresponds to its telephone number address string.<p> <dl> <dt> <b>Returns:</b> <dd> The name of the Address. <dt> <b>Throws:</b> <a href="java.telephony.PlatformException.html#_top_">PlatformException</a> <dd> A platform-specific exception occurred. </dl></dl><a name="getProvider()"><img src="images/red-ball.gif" width=12 height=12 alt=" o "></a><a name="getProvider"><b>getProvider</b></a><pre> public abstract <a href="java.telephony.Provider.html#_top_">Provider</a> getProvider() throws <a href="java.telephony.PlatformException.html#_top_">PlatformException</a></pre><dl> <dd> Returns the Provider associated with this Address. This Provider objectis valid throughout the lifetime of the Address and does not changeonce the Address is created.<p> <dl> <dt> <b>Returns:</b> <dd> The Provider associated with this Address. <dt> <b>Throws:</b> <a href="java.telephony.PlatformException.html#_top_">PlatformException</a> <dd> A platform-specific exception occurred. </dl></dl><a name="getTerminals()"><img src="images/red-ball.gif" width=12 height=12 alt=" o "></a><a name="getTerminals"><b>getTerminals</b></a><pre> public abstract <a href="java.telephony.Terminal.html#_top_">Terminal</a>[] getTerminals() throws <a href="java.telephony.PlatformException.html#_top_">PlatformException</a></pre><dl> <dd> Returns an array of Terminals associated with this Address object.If no Terminals are associated with this Address <EM>getTerminals()</EM>returns NULL.<p> <dl> <dt> <b>Returns:</b> <dd> An array of Terminal objects associated with this Address. <dt> <b>Throws:</b> <a href="java.telephony.PlatformException.html#_top_">PlatformException</a> <dd> A platform-specific exception occurred. </dl></dl><a name="getConnections()"><img src="images/red-ball.gif" width=12 height=12 alt=" o "></a><a name="getConnections"><b>getConnections</b></a><pre> public abstract <a href="java.telephony.Connection.html#_top_">Connection</a>[] getConnections() 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 Connection object currently associated with thisAddress object. When a Connection moves into the Connection.DISCONNECTEDstate the Address object loses the reference. Therefore, all Connectionsreturned by this method will never be in the Connection.DISCONNECTED state.If the Address has no Connections associated with it, this methodreturns the null. The Provider must be in the Provider.IN_SERVICE statein order for this method to be valid.<p>The pre-conditions for this method are:<OL><LI>(this.getProvider()).getState() == Provider.IN_SERVICE</OL><p>The following post-conditions apply:<p><OL><LI>Let Connection c[] = this.getConnections()<LI>c == null or c.length >= 1<LI>For all i, c[i].getState != Connection.DISCONNECTED</OL><p> <dl> <dt> <b>Returns:</b> <dd> An array of Connection objects associated with this Address. <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="addObserver(java.telephony.AddressObserver)"><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.AddressObserver.html#_top_">AddressObserver</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 Address. The AddressObserver reports allAddress-related state changes as events. The Address object will reportevents to this AddressObserver object for the lifetime of the Addressobject or until the observer is removed with the<EM>Address.removeObserver()</EM> method.<p>⌨️ 快捷键说明
复制代码
Ctrl + C
搜索代码
Ctrl + F
全屏模式
F11
切换主题
Ctrl + Shift + D
显示快捷键
?
增大字号
Ctrl + =
减小字号
Ctrl + -