SQLite-Beispielanwendung
Übersicht
Die Beispielanwendung der SQLite-Datenbank stellt dar, wie eine beständige relationale Datenbank, die auf dem BlackBerry-Gerät gespeichert wird, erstellt wird und wie die Einträge in der Datenbank geändert werden können.
Die Datenbank enthält zwei Tabellen, die Category und DirectoryItems genannt werden. Die DirectoryItems-Tabelle enthält Elemente, die Einträge in einer Branchenverzeichnisliste simulieren. Jeder DirectoryItem-Eintrag enthält auch ein CategoryID-Feld, das einem category_id-Eintrag in der Category-Tabelle entsprechen muss (z. B. Category.category_id ist ein Fremdschlüssel für DirectoryItem.categoryID).
Die Beispielanwendung zeigt die Einträge in den Tabellen als eine minimierbare Baumstruktur mit Category-Einträgen als übergeordnete Knoten und DirectoryItem-Einträgen als untergeordnete Knoten der Category-Knoten, denen sie zugewiesen sind. Die Beispielanwendung stellt Menüeinträge für das Hinzufügen einer neuen Kategorie oder eines Verzeichniselements und für das Ändern oder Löschen des Verzeichniselements bereit.
Diese Beispielanwendung verwendet sichere APIS. Die Anwendung muss signiert werden, bevor sie ausgeführt werden kann. Weitere Informationen zur Codesignatur finden Sie im Administratorhandbuch für BlackBerry Signing Authority Tool.
Dateien in der Beispielanwendung
Vorgestellte Schnittstellen
net.rim.device.api.Database
Die Database-Schnittstelle stellt die Datenbank dar. Diese Schnittstelle stellt Methoden zur Änderung einer Datenbank auf dem BlackBerry-Gerät, einschließlich Methoden für das Erstellen von SQL-Anweisungen, um Datensätze in der Datenbank hinzuzufügen, zu löschen oder zu aktualisieren, und Methoden für das Übernehmen und Abbrechen von Transaktionen in der Datenbank bereit. Diese Schnittstelle stellt auch Methoden für die Einstellung und das Abrufen der Metadaten der Datenbank bereit.
Um die Datenbank zu erstellen, können Sie eine der Methoden der DatabaseFactory-Klasse verwenden.
Die Beispielanwendung verwendet diese Schnittstelle für die Erstellung von Anweisungen, um Datensätze in der Datenbank einzufügen, zu löschen und zu aktualisieren.
net.rim.device.api.Statement
Die Statement-Schnittstelle stellt eine SQL-Anweisung dar. Sie können die Statement-Schnittstelle verwenden, um Einträge in der Datenbank abzurufen, hinzuzufügen, zu löschen oder zu ändern.
net.rim.device.api.Cursor
Die Cursor-Schnittstelle stellt Methoden für die Traversierung eines Ergebnissatzes bereit, der mithilfe des Statement-Objekts abgerufen wird. Ein Statement-Objekt erstellt das Cursor-Objekt mithilfe der Statement.getCursor()-Methode als Bestandteil des Abfrageprozesses. Deshalb ist ein Cursor immer mit einer bestimmten Abfrage verknüpft.
Vorgestellte Klassen
net.rim.device.api.database.Row
Die Row-Klasse stellt eine Zeile in einem Ergebnissatz dar, den eine AUSWÄHLEN-Abfrage auswirft.
Diese Klasse stellt Methoden für das Abrufen von Spalten-Indizes im Row-Objekt und für die in den Spalten des Row-Objekts gespeicherten Werte bereit.
Sie erstellen diese Klasse mithilfe der Cursor.getRow()-Methode.
net.rim.device.api.database.DatabaseFactory
Die DatabaseFactory-Klasse stellt Methoden für das Erstellen, Öffnen, Konfigurieren und Löschen einer neuen oder vorhandenen Database bereit. Die Konfigurationsoptionen umfassen permanente und flüchtige Speicher sowie Verschlüsselung.
Um eine neue Datenbank zu erstellen, müssen Sie die DatabaseFactory.openOrCreate()-Methode oder die DatabaseFactory.create() -Methode verwenden. Wenn Sie bereits die Datenbank erstellt haben, gibt die DatabaseFactory.openOrCreate()-Methode einen Hinweis an die Datenbank zurück.
Erstellen Sie die Datenbank auf einer Medienkarte anstatt im Gerätespeicher. Nur bestimmte BlackBerry-Geräte unterstützen das Speichern einer SQLite-Datenbank im Gerätespeicher.
Installieren der Beispielanwendung
- Klicken Sie in Eclipse im File-Menü auf Import. .
- Erweitern Sie im Import-Dialogfeld den BlackBerry-Ordner.
- Klicken Sie auf Import BlackBerry Samples.
- Klicken Sie auf Next.
- Führen Sie eine der folgenden Aktionen aus:
- Klicken Sie im BlackBerry Projects-Abschnitt auf Deselect All.
- Aktivieren Sie das Kontrollkästchen neben dem Projekt SQLiteDemo.
- Klicken Sie auf Finish.
Ausführen der Beispielanwendung
- Klicken Sie in Eclipse im Fensterbereich Navigator mit der rechten Maustaste auf den Ordner SQLiteDemo.
- Klicken Sie auf Run As > BlackBerry Simulator.
- Wenn der BlackBerry Smartphone Simulator nicht die Nachricht ""Media card inserted"" anzeigt, müssen Sie eine Medienkarte simulieren.
- Klicken Sie, falls notwendig auf der Startseite des BlackBerry Smartphone Simulator auf den Ordner Downloads.
- Klicken Sie auf das Symbol SQLite Demo.
Waren diese Informationen hilfreich? Senden Sie uns Ihren Kommentar.