JSR-043: JTAPI-1.4

javax.telephony.mobile
Interface MobileNetwork


public interface MobileNetwork

A MobileNetwork interface represents an actual cellular network. The MobileNetwork object contains all available information about the wireless network.

See Also:
MobileProvider, MobileProviderEvent, MobileProviderListener

Method Summary
 java.lang.String getCode()
          Returns the network code in a String format.
 java.lang.String[] getNames()
          Returns the all available network name synonyms.
 boolean isAvailable()
          Returns true if the network is currently available.
 boolean isCurrent()
          Returns true if the network is current network in use.
 boolean isRestricted()
          Returns true if the network is currently restricted.
 

Method Detail

isAvailable

public boolean isAvailable()
Returns true if the network is currently available.
Returns:
true if mobile network is available

isCurrent

public boolean isCurrent()
Returns true if the network is current network in use. (convenience method equivalent to MobileProvider.getCurrentNetwork() )
Returns:
true if mobile network is current

isRestricted

public boolean isRestricted()
Returns true if the network is currently restricted.
Returns:
true if mobile network is restricted

getNames

public java.lang.String[] getNames()
Returns the all available network name synonyms. This usually means one short and long name (per network). The shortest name or the only name available must be the FIRST (=[0]) in the array. The other names must be sorted by character length, also. For example, [0] = "tl", [1] = "tele", [2] = "telecom"

Returns:
All available names of a network, null, if none available.

getCode

public java.lang.String getCode()
Returns the network code in a String format.
Example: MCC-MNC, SID-NID
where : MCC = Mobile Country Code, MNC = Mobile Network Code
SID = Subscriber ID, NID = Network ID

Returns:
The network code.

JSR-043: JTAPI-1.4

Send comments to: JSR-43@ectf.org