JSR-043: JTAPI-1.4

javax.telephony.mobile
Interface MobileAddress

All Superinterfaces:
Address

public interface MobileAddress
extends Address

A MobileAddress interface represents what we commonly think of as a "telephone number." In the mobile world, the telephone number depends of the subscription and so often of the SIM card.

Address and Call Objects

Address objects represent the logical endpoints of a telephone call. A logical view of a telephone call views the call as originating from one Address endpoint and terminates at another Address endpoint.

Address and Events

In the core package, the Address is described as static. In the mobile world, a subscription (and so the phone number) may appear or disappear with the insertion or extraction of the support (subscription included in the SIM card), but the MobileAddress object life is the same as the MobileProvider object life (as in the core). If the subscription changes, it will generate an event (through the MobileProviderListener).

See Also:
Address, MobileProvider

Method Summary
 boolean getCallWaiting()
          Returns the state of call 'knocking' feature.
 java.lang.String getSubscriptionId()
          Returns the Subscription Identification String associated with this address.
 void setCallWaiting(boolean state)
          Sets the state of call 'knocking' feature.
 
Methods inherited from interface javax.telephony.Address
addAddressListener, addCallListener, addCallObserver, addObserver, getAddressCapabilities, getAddressListeners, getCallListeners, getCallObservers, getCapabilities, getConnections, getName, getObservers, getProvider, getTerminals, removeAddressListener, removeCallListener, removeCallObserver, removeObserver
 

Method Detail

getCallWaiting

public boolean getCallWaiting()
                       throws MethodNotSupportedException
Returns the state of call 'knocking' feature.

In the mobile world the user can turn call waiting indication on and off, as a do not disturb. getCallWaiting does an inquiry to the network to get the setting on or off.

Returns:
True, if call waiting is enabled.
Throws:
MethodNotSupportedException - Indicates this method is not supported by the implementation.

setCallWaiting

public void setCallWaiting(boolean state)
                    throws MethodNotSupportedException
Sets the state of call 'knocking' feature.
Parameters:
state - true, if call waiting is enabled.
Throws:
MethodNotSupportedException - Indicates this method is not supported by the implementation.

getSubscriptionId

public java.lang.String getSubscriptionId()
Returns the Subscription Identification String associated with this address. This methods returns the subscription ID string such as IMSI. (International Mobile Subscriber Identification)
Returns:
the subscriber ID String, NULL if no such ID is implemented.

JSR-043: JTAPI-1.4

Send comments to: JSR-43@ectf.org