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.
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 unterschiedlichen Satz von Methoden bereit, die für den Zugriff auf den Datenbankspeicher verwendet werden.
RIM-Objektspeicher Mit einem ConfigObjectStore-Objekt unterstützt.
Record-Stores Mit einem ConfigRecordStore-Objekt unterstützt.
Dateisystemspeicher Mit einem ConfigFile-Objekt unterstützt.
Nicht-beständige Speicher Mit einem ConfigNonPersistent-Objekt unterstützt.
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.
Tabellenvorgänge Der Zugriff auf und die Verwaltung von UltraLiteJ-Datenbanktabellen erfolgt mit Methoden der Connection-Schnittstelle.
Eine UltraLiteJ-Datenbank kann nur mit der API erstellt werden. Sie können eine neue Datenbank nicht mithilfe von Sybase Central oder UltraLite-Befehlszeilen-Dienstprogrammen erstellen.
Erstellen Sie ein neues Configuration-Objekt, das den Datenbanknamen referenziert.
Die korrekte Syntax hängt von der Java-Plattform und dem Client-Gerät ab. In den folgenden Beispielen ist "config" der Name des Configuration-Objekts und "DBname.ulj" der Name der neuen Datenbank.
Für J2ME BlackBerry-Geräte:
ConfigObjectStore config =
DatabaseManager.createConfigurationObjectStore("DBname.ulj"); |
Für alle anderen J2ME-Geräte:
ConfigRecordStore config =
DatabaseManager.createConfigurationRecordStore("DBname.ulj"); |
Für J2SE-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 schließt den Datenbank-Erstellungsprozess ab und stellt eine Verbindung zur Datenbank her. Nachdem diese Methode aufgerufen wurde, können Sie Schema- und Datenvorgänge durchführen, aber Sie können nicht mehr den Namen, das Kennwort oder die Seitengröße der Datenbank ändern.
Eine UltraLiteJ-Datenbank muss bereits auf dem Client-Gerät bestehen, bevor Sie eine Verbindung mit ihr herstellen können.
Erstellen Sie ein neues Configuration-Objekt, das den Namen der Datenbank referenziert.
Die korrekte Syntax hängt von der Java-Plattform und dem Client-Gerät ab. In den folgenden Beispielen ist "config" der Name des Configuration-Objekts und "DBname.ulj" der Name der Datenbank.
Für J2ME BlackBerry-Geräte:
ConfigObjectStore config =
DatabaseManager.createConfigurationObjectStore("DBname.ulj"); |
Für alle anderen J2ME-Geräte:
ConfigRecordStore config =
DatabaseManager.createConfigurationRecordStore("DBname.ulj"); |
Für J2SE-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.
Verwenden Sie die release-Methode der DatabaseManager-Klasse, um die Verbindung zur UltraLiteJ-Datenbank zu trennen. Die release-Methode schließt die Verbindung und alle ihr zugeordneten Eigenschaften.
| Kommentieren Sie diese Seite in DocCommentXchange. Senden Sie uns Feedback über diese Seite via E-Mail. |
Copyright © 2009, iAnywhere Solutions, Inc. - SQL Anywhere 11.0.1 |