| java.lang.Object
 com.sun.midp.jump.push.executive.PushController
| PushController | | final class PushController (Code) | | Push controller.
Manages both connections and alarms.
|
| Method Summary | |
| public void | dispose()
Disposes the controller. | | public synchronized String | getFilter(int midletSuiteID, String connectionName)
Fetches the filter by the connection. | | public synchronized String | getMIDlet(int midletSuiteID, String connectionName)
Fetches the MIDlet by the connection. | | public String[] | listConnections(int midletSuiteID, boolean available)
Returns a list of registered connections for MIDlet suite. | | public long | registerAlarm(int midletSuiteID, String midlet, long time)
Registers an alarm.
NOTE: midletSuiteID parameter should refer to a valid
MIDlet suite and midlet should refer to
valid MIDlet from the given suite. | | public void | registerConnection(int midletSuiteID, String midlet, ReservationDescriptor reservationDescriptor)
Registers the connection. | | public void | removeSuiteInfo(int midletSuiteID)
Removes Push-related information for the suite being uninstalled;
NOTE: midletSuiteID must refer to valid installed
MIDlet suite. | | public boolean | unregisterConnection(int midletSuiteID, String connectionName)
Unregisters the connection. |
| PushController | | public PushController(Store store, LifecycleAdapter lifecycleAdapter, ReservationDescriptorFactory reservationDescriptorFactory)(Code) | | Creates an implementation.
Parameters:
store - Store to use(cannot be null)
Parameters:
lifecycleAdapter - lifecycle adapter to use(cannot be null)
Parameters:
reservationDescriptorFactory - reservation descriptor factory(cannot be null) |
| dispose | | public void dispose()(Code) | | Disposes the controller.
This method needs to be called when closing the system.
|
| getFilter | | public synchronized String getFilter(int midletSuiteID, String connectionName)(Code) | | Fetches the filter by the connection.
Parameters:
midletSuiteID - MIDlet suite ID to query for
Parameters:
connectionName - connectionName as passed intoPushController.registerConnection(cannot be null) filter associated with connectionName ornull if there is no appropriate association |
| getMIDlet | | public synchronized String getMIDlet(int midletSuiteID, String connectionName)(Code) | | Fetches the MIDlet by the connection.
Parameters:
midletSuiteID - MIDlet suite ID to query for
Parameters:
connectionName - connectionName as passed intoPushController.registerConnection(cannot be null) MIDlet associated with connectionNameor null if there is no appropriate association |
| listConnections | | public String[] listConnections(int midletSuiteID, boolean available)(Code) | | Returns a list of registered connections for MIDlet suite.
Parameters:
midletSuiteID - MIDlet suite ID
Parameters:
available - if true, only returnthe list of connections with input available, otherwisereturn the complete list of registered connections forMIDlet suite array of registered connection strings, where each connectionis represented by the generic connection protocol,host and port number identification |
| registerAlarm | | public long registerAlarm(int midletSuiteID, String midlet, long time) throws ConnectionNotFoundException(Code) | | Registers an alarm.
NOTE: midletSuiteID parameter should refer to a valid
MIDlet suite and midlet should refer to
valid MIDlet from the given suite. timer
parameters is the same as for corresponding Date
constructor. No checks are performed and no guarantees are
given if parameters are invalid.
Parameters:
midletSuiteID - MIDlet suite ID
Parameters:
midlet - MIDlet class name(cannot be null)
Parameters:
time - alarm time
throws:
ConnectionNotFoundException - if for any reason alarm cannot beregistered previous alarm time or 0 if none |
| registerConnection | | public void registerConnection(int midletSuiteID, String midlet, ReservationDescriptor reservationDescriptor) throws IOException(Code) | | Registers the connection.
Saves the connection into persistent store and reserves it
for MIDlet.
The connection should be already preverified (see
reservationDescriptor parameter) and all the security
checks should be performed.
Parameters:
midletSuiteID - MIDlet suite ID
Parameters:
midlet - MIDlet class name(cannot be null)
Parameters:
reservationDescriptor - reservation descriptor(cannot be null)
throws:
IOException - if the connection is already registered orif there are insufficient resources to handle the registration request |
| removeSuiteInfo | | public void removeSuiteInfo(int midletSuiteID)(Code) | | Removes Push-related information for the suite being uninstalled;
NOTE: midletSuiteID must refer to valid installed
MIDlet suite. However, it might refer to the
suite without alarms.
Parameters:
midletSuiteID - ID of the suite to remove Push info for |
| unregisterConnection | | public boolean unregisterConnection(int midletSuiteID, String connectionName) throws SecurityException(Code) | | Unregisters the connection.
Removes the connection from persistent store and cancels connection
reservation.
Parameters:
midletSuiteID - MIDlet suite ID
Parameters:
connectionName - connection to unregister(cannot be null) true if the unregistration was successful,false if the connection was not registered
throws:
SecurityException - if the connection was registered byanother MIDlet suite |
|
|