This is the optimized implementation for WMA 2.0, which provides classes that allow Java applications to access SMS functionality on a mobile device.

The classes in this package support the sending and receiving of SMS messages. The classes in this package, {@link com.sun.midp.io.j2me.sms.Protocol Protocol}, {@link com.sun.midp.io.j2me.sms.MessageObject MessageObject}, {@link com.sun.midp.io.j2me.sms.TextObject TextObject}, {@link com.sun.midp.io.j2me.sms.BinaryObject BinaryObject} and {@link com.sun.midp.io.j2me.sms.TextEncoder TextEncoder} define this implementation. MessageObject defines the implementation of the SMS message. TextObject and BinaryObject extend MessageObject and represent the two possible types of SMS messages. Text messages can be enocded as GSM 7-bit text or UCS2 characters. The TextEncoder class provides an encoder and decoder for these two types of encodings. Protocol defines the implementation of the SMS message connection. Protocol interfaces with the platform provided SMS services. It makes native calls to open, close and send messages. This connection is to a low-level transport mechanism which can be any of the following:

• a datagram short message peer-to-peer (SMPP) protocol to a service center to satisfy a network-based solution
• a comm connection to a mobile device that understands AT-commands
• a native SMS stack for proprietary implementations
• a loop back implementation; that is, anything that is sent will be automatically received. This implementation is provided for testing purposes.

Connection and Message Lifecycle

Connections can be made in server mode or in client mode. In server mode, messages can be sent or received. In client mode, messages can be sent only. Applications can treat sending and receiving independently.

To receive messages, the application can open the connection by passing a string containing a local port to the Connector.open method. A MessageConnection object is returned, on which the message can be received. If there are no messages in the queue, the receive() method will block until one arrives. When a message has been received, methods are available in the MessageObject class for retrieving its address and data parts. Calling the close() method closes the connection.

To send messages, the application will either obtain an existing Message object or use the newMessage factory method to create one. If the application creates a Message object, methods are available in the MessageObject class for setting its address and data parts. The application can open a connection by passing a string containing a fully-qualified SMS URL address (phone number and port number) to the Connector.open method. A MessageConnection object is returned, on which the message can be sent. Calling the close() method closes the connection.

Package Specification

The classes in this package need access to classes in the optional javax.microedition.io package, the CLDC implementation (com.sun.cldc.*), and the MIDP implementation (com.sun.midp.*).

This package is also dependent on javax.microedition.io for the definition of Connector.open (the CLDC-definition of the Generic Connection Framework).