Auf einen UltraLiteJ-Datenbankspeicher zugreifen

Anwendungen müssen zu einer UltraLiteJ-Datenbank eine Verbindung herstellen, bevor auf den Daten Vorgänge durchgeführt werden können. Dieser Abschnitt beschreibt, wie Sie eine Datenbank erstellen oder mit ihr unter Verwendung eines angegebenen Kennworts verbinden.

Implementierungen des Configuration-Objekts

Ein Configuration-Objekt wird verwendet, um eine Datenbank zu erstellen und mit ihr zu verbinden. Es gibt mehrere verschiedene Implementierungen eines Configuration-Objekts, die in der API bereitgestellt werden. Es gibt eine spezielle Implementierung für jeden Datenbankspeicher-Typ, der von UltraLiteJ unterstützt wird. Jede Implementierung stellt einen Satz von Methoden bereit, die zum Konfigurieren des Datenbankspeichers verwendet werden.

RIM-Objektspeicher Mit einem ConfigObjectStore-Objekt unterstützt. Siehe ConfigObjectStore-Schnittstelle (nur Java ME-BlackBerry).
Record Stores Mit einem ConfigRecordStore-Objekt unterstützt. Siehe ConfigRecordStore-Schnittstelle (nur Java ME).
Dateisystemspeicher Mit einem ConfigFile-Objekt unterstützt. Siehe ConfigFile-Schnittstelle.
Nicht-beständige Speicher Mit einem ConfigNonPersistent-Objekt unterstützt. Siehe ConfigNonPersistent-Schnittstelle.
Interne Flash-Speicher und SD-Speicherkarten Mit einem ConfigFileME-Objekt unterstützt. Siehe ConfigFileME Schnittstelle (nur BlackBerry).

Eigenschaften des Connection-Objekts

Transaktionen Transaktionen müssen mit der commit-Methode der Verbindung in der Datenbank festgeschrieben werden. Sie können mit der rollback-Methode zurückgesetzt werden.
Vorbereitete SQL-Anweisungen Die Methoden werden durch die PreparedStatement-Schnittstelle für die Verarbeitung von SQL-Anweisungen bereitgestellt. Eine PreparedStatement-Anweisung kann mit der prepareStatement-Methode der Verbindung erstellt werden.
Synchronisation Eine Gruppe von Objekten, die die MobiLink-Synchronisation steuern und auf die vom Connection-Objekt aus zugegriffen wird.

Eine neue UltraLiteJ-Datenbank erstellen

Sie können eine neue UltraLiteJ-Datenbank nicht mithilfe von Sybase Central oder UltraLite-Befehlszeilen-Dienstprogrammen erstellen. Eine UltraLite-Datenbank kann mithilfe der Dienstprogramme ulunload und uljload in eine UltraLiteJ-Datenbank konvertiert werden. Eine UltraLiteJ-Datenbank, die mit uljload oder einer Java SE-Anwendung erstellt wurde, kann auf einem BlackBerry-Gerät bereitgestellt werden, indem die Datenbank auf eine SD-Karte kopiert oder aus MobiLink mithilfe des Dateiübertragungsmechanismus übertragen wird.

♦ So erstellen Sie eine Datenbank

Erstellen Sie ein neues Configuration-Objekt, das den Datenbanknamen referenziert und für Ihre Plattform geeignet ist.

In den folgenden Beispielen ist "config" der Name des Configuration-Objekts und "DBname.ulj" der Name der neuen Datenbank.

Für Java ME-BlackBerry-Geräte:

ConfigObjectStore config = 
    DatabaseManager.createConfigurationObjectStore("DBname.ulj");

ConfigFileME config =
DatabaseManager.createConfigFileME( "file:///store/home/user/DBname.ulj" );

ConfigFileME config =
DatabaseManager.createConfigFileME( "file:///SDCard/DBname.ulj" );

Für alle anderen Java ME-Geräte:

ConfigRecordStore config = 
    DatabaseManager.createConfigurationRecordStore("DBname.ulj");

Für Java SE-Geräte:

ConfigFile config = 
    DatabaseManager.createConfigurationFile("DBname.ulj");

Alternativ dazu können Sie eine nicht beständige Datenbankkonfiguration erstellen, die von allen Plattformen unterstützt wird:

ConfigNonPersistent config = 
    DatabaseManager.createConfigurationNonPersistent("DBname.ulj");

Legen Sie ein neues Datenbank-Kennwort mit der setPassword-Methode fest:
config.setPassword("my_password");
Erstellen Sie eine neue Verbindung:
Connection conn = DatabaseManager.createDatabase(config);
Die createDatabase-Methode erstellt die Datenbank und gibt eine Verbindung zu ihr zurück. Nachdem diese Methode aufgerufen wurde, können Sie SQL-Anweisungen ausführen und damit Tabellen und Indizes für Ihre Anwendung erstellen, jedoch können Sie nicht den Namen, das Kennwort oder die Seitengröße der Datenbank ändern.

Eine Verbindung zu einer vorhandenen Datenbank herstellen

Eine UltraLiteJ-Datenbank muss bereits auf dem Client-Gerät bestehen, bevor Sie eine Verbindung mit ihr herstellen können.

♦ So stellen Sie eine Verbindung zu einer vorhandenen Datenbank her

Erstellen Sie ein neues Configuration-Objekt, das den Namen der Datenbank referenziert und für Ihre Plattform geeignet ist.

In den folgenden Beispielen ist "config" der Name des Configuration-Objekts und "DBname.ulj" der Name der Datenbank.

Für Java ME-BlackBerry-Geräte:

ConfigObjectStore config = 
    DatabaseManager.createConfigurationObjectStore("DBname.ulj");

ConfigFileME config =
DatabaseManager.createConfigFileME( "file:///store/home/user/DBname.ulj" );

ConfigFileME config =
DatabaseManager.createConfigFileME( "file:///SDCard/DBname.ulj" );

Für alle anderen Java ME-Geräte:

ConfigRecordStore config = 
    DatabaseManager.createConfigurationRecordStore("DBname.ulj");

Für Java SE-Geräte:

ConfigFile config = 
    DatabaseManager.createConfigurationFile("DBname.ulj");

Alternativ dazu können Sie eine Verbindung mit einer nicht beständigen Datenbankkonfiguration herstellen, die von allen Plattformen unterstützt wird:

ConfigNonPersistent config = 
    DatabaseManager.createConfigurationNonPersistent("DBname.ulj");

Geben Sie das Datenbank-Kennwort unter Verwendung der setPassword-Methode an:
config.setPassword("my_password");
Erstellen Sie eine neue Verbindung:
Connection conn = DatabaseManager.connect(config);
Die connect-Methode schließt den Prozess der Datenbank-Verbindungsherstellung ab. Wenn die Datenbank nicht existiert, wird ein Fehler ausgegeben.

Verbindung mit einer Datenbank trennen

Siehe auch

Kommentieren Sie diese Seite in DocCommentXchange.