Package javax.microedition.cellular

[OPTIONAL] Provides classes to obtain information about cellular networks the device is registered on.

See: Description

Interface Summary

Interface	Description
CellularNetworkListener	Interface to receive cellular network related events, like network connection/disconnection, current cell change, etc.
SubscriberListener	Interface to receive subscribers related events, like subscriber hot swap.

Class Summary

Class	Description
CellularNetwork	CellularNetwork class represents a cellular network such as a 3GPP or CDMA network.
CellularPermission	CellularPermission is a BasicPermission for access to cellular information.
Subscriber	Subscriber class represents cellular network's subscriber identity, like SIM, R-UIM, CSIM.

Exception Summary

Exception	Description
NetworkDisconnectedException	Indicates that cellular network was disconnected.

Package javax.microedition.cellular Description

[OPTIONAL] Provides classes to obtain information about cellular networks the device is registered on.

The Subscriber class represents cellular network's subscriber identity, like SIM, R-UIM, CSIM. This class provides methods to obtain subscriber identifiers (e.g. phone number, IMSI, etc.) and subscriber's operator identifiers (e.g. operator name, MCC, MNC codes). The CellularNetwork class represents 3GPP or CDMA network the device is registered on. It provides information about network type, state, subscriber and identifiers which depends on the network type. User sensitive information in this package is protected by the CellularPermission class.

Some code examples are given below.

• Get primary subscriber:
  

  Subscriber subscriber = Subscriber.getBySlotNumber(1);

• Get 3GPP subscriber's operator codes:
  

  Map<String, String> properties = subscriber.getProperties(); int mcc = Integer.parseInt(properties.get("mcc")); int mnc = Integer.parseInt(properties.get("mnc"));

• Check roaming state of the primary cellular network:
  

  Subscriber subscriber = Subscriber.getBySlotNumber(1); // get primary subscriber CellularNetwork network = subscriber.getNetwork(); boolean roaming = network.isRoaming();

• Get current base station identifier for CDMA network:
  

  Map<String, String> cellProperties = network.getCellProperties(); int bid = Integer.parseInt(properties.get("bid"));

Unless otherwise noted, passing a null argument to a constructor or method in any class or interface in this package MUST cause a java.lang.NullPointerException to be thrown.

Since:

MEEP-8.0.0