Application APIs

The SUPApplication class, in the com.sybase.mobile Java package, manages mobile application registrations, connections and context.

• getInstance
  Retrieves the Application instance for the current mobile application.
• setApplicationIdentifier
  Sets the identifier for the current application.
• registrationStatus
  Retrieves the current status of the mobile application registration.
• registerApplication
  Creates the registration for this application and starts the connection. This method is equivalent to calling registerApplication(0), but is a non-blocking call which returns immediately.
• registerApplication (int timeout)
  Creates the registration for this application and starts the connection. An ApplicationTimeoutException is thrown if the method does not succeed within the number of seconds specified by the timeout.
• setApplicationCallback
  Sets the callback for the current application. It is optional, but recommended, to register a callback so the application can respond to changes in connection status, registration status, and application settings.
• startConnection (int timeout)
  Starts the connection for this application. If the connection was previously started, then this operation has no effect. You must set the appropriate connectionProperties before calling this operation. An ApplicationTimeoutException is thrown if the method does not succeed within the number of seconds specified by the timeout.
• connectionStatus
  Return current status of the mobile application connection.
• stopConnection:timeout
  Stop the connection for this application. An ApplicationTimeoutException is thrown if the method does not succeed within the number of seconds specified by the timeout.
• unregisterApplication
  Delete the registration for this application, and stop the connection. If no registration was previously created, or a previous registration was already deleted, then this operation has no effect. This method is equivalent to calling unregisterApplication(0), but is a non-blocking call which returns immediately. You can set the applicationCallback before calling this operation to receive asynchronous notification of registration status changes.
• unregisterApplication:timeout
  Delete the registration for this application, and stop the connection. If no registration was previously created, or a previous registration was already deleted, then this operation has no effect. You can set the applicationCallback before calling this operation to receive asynchronous notification of registration status changes.