DatabaseManager class

Provides static methods to obtain basic configurations, create a new database, and connect to an existing database.

Syntax

public class DatabaseManager

Members

All members of the DatabaseManager class, including all inherited members.

Name	Description
connect method	Connects to an existing database based on a configuration set.
createConfigurationNonPersistent method [BlackBerry]	Creates a Configuration object for a non-persistent database store, and returns a ConfigNonPersist object.
createConfigurationObjectStore method [BlackBerry]	Creates a Configuration object for a RIM object store, and returns a ConfigObjectStore object.
createDatabase method	Creates a new database based on a set of configurations, and connects to the database.
createFileTransfer method	Creates a FileTransfer object for transferring files to or from MobiLink.
createFileTransferAndroid method [Android]	Creates a FileTransfer object for transferring files to or from MobiLink.
createObjectStoreTransfer method [BlackBerry]	Creates a FileTransfer object for transferring UltraLite Java edition databases to or from MobiLink, and storing them into a RIM object store.
createSISHTTPListener method [BlackBerry]	Creates an SISListener object for server-initiated synchronizations.
release method	Closes this DatabaseManager object to release all connections and to shutdown all databases.
setErrorLanguage method	Sets the language to use for error messages.

Remarks

The following example demonstrates how to open an existing database or create a new one if it does not exist on the J2SE platform:

Connection conn;
ConfigFile config = DatabaseManager.createConfigurationFile(
        "test.ulj"
    );
try {
    conn = DatabaseManager.connect(config);
} catch(ULjException ex) {
    conn = DatabaseManager.createDatabase(config);
    // Create the schema here.
}

The following example demonstrates how to open an existing database or create a new one if it does not exist on a BlackBerry device:

Connection conn;
ConfigObjectStore config = DatabaseManager.createConfigurationObjectStore(
        "test.ulj"
    );
try {
    conn = DatabaseManager.connect(config);
} catch(ULjException ex) {
    conn = DatabaseManager.createDatabase(config);
    // Create the schema here.
}

The following example demonstrates how to open an existing database or create a new one if it does not exist on an Android device:

Connection conn = null;
ConfigFileAndroid config = null;

try {
    config = DatabaseManager.createConfigurationFileAndroid(
         "test.udb", getApplicationContext()
    );
    conn = DatabaseManager.connect(config);
} catch(ULjException ex) {
    if (config != null) {
        try {
            conn = DatabaseManager.createDatabase(config);
            // Create the schema here.
        } catch(ULjException exception) {
            // An error has occurred.
        }
    }
}