The push registry allows MIDlets to be launched in response to an incoming
network connection. When a MIDlet registers for push notifications, the device
software is instructed to listen for incoming network connections and launch
the MIDlet, if appropriate.
Push registry configuration is only available for
projects whose profile version is set to MDP 2.0. For information on setting
the project profile version, see Customizing
Platform Properties.
To open the Push Registry Properties page:
Choose File > "active
project name" properties.
This opens the Project Properties dialog.
Select Push Registry from the left pane.
To register a MIDlet in the push registry:
Open the Push Registry properties page.
Click Add to add a new MIDlet, and provide the following information
in the Add Push Registry Entries dialog:
Class Name. The MIDlet's class name.
Sender IP. A valid sender that can launch
the associated MIDlet. If the value is the wildcard (*), connections
from any source are accepted. If datagram or socket connections are used,
the value of Allowed Sender can be a numeric IP address.
Connection String. A connection string that identifies
the connection protocol and port number.
A push registration key is automatically generated and shown as an attribute
in the MIDlet suite's Java Application Descriptor (JAD) file. To view the JAD
file, choose the Application Descriptor Property settings from the left pane.
To make use of the Push Registry, you
must also have permission to access the Push Registry API, javax.microedition.io.PushRegistry.
API permissions are handled in the API
Permissions page of the Project Properties.
Each key designation is unique and of the form MIDlet-Push-<n>,
where <n> begins at 1 and is incrementally increased with
each registration. A MIDlet suite can have multiple push registrations.
To edit a push registry entry:
Open the Push Registry properties page.
Click the Edit button.
In the Edit Push Registry dialog, edit the fields as described above.
To remove a push registry entry:
Open the Push Registry properties page.
Select the Push Registry entry from the table and click the Remove button.
To change the order push registry entries are displayed:
Open the Push Registry properties page.
Select a Push Registry entry from the list.
Click the Move Up or Move Down buttons.
For more information about using the push registry, see