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.

Version:

03/03/99 1.6

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.