AIR: Lokale SQL-Datenbank verwenden

Im neunten Teil zu Adobe AIR 1.0 geht es um das Thema SQL. AIR bietet die Möglichkeit, mit lokalen SQL-Datenbanken zu arbeiten. Die AIR-Runtime hat eine SQL-Engine, die auf der Open Source Technologie SQLite basiert.

In der lokalen Datenbank können z.B. Programmdaten, Benutzereinstellungen, Dokumente oder andere Arten von Daten gespeichert werden. Die SQL-Datenbank ist nichts anderes als eine Datei auf der Festplatte, in der die Daten abgelegt werden. Sie kann über ActionScript erstellt, befüllt und ausgelesen werden. Als Syntax werden dazu gewöhnliche SQL-Statements verwendet.

Das folgende AIR-Beispiel erstellt zuerst eine neue Datenbank (Der Einfachheit wegen wird diese auf dem Desktop gespeichert). Anschließend wird ein erster Eintrag in die Datenbank-Tabelle geschrieben. Über die Benutzeroberfläche kann man weitere Einträge hinzufügen und die vorhanden anzeigen lassen.

[as]
import flash.events.*;
import flash.filesystem.File;
import flash.data.*;

/*
* :::::::::::: Neue Datenbank erstellen bzw. öffnen, falls vorhanden :::::::::::::::::::::
*/

// neue SQL Verbindung
var conn:SQLConnection = new SQLConnection();

// event listeners
conn.addEventListener(SQLEvent.OPEN, openHandler);
conn.addEventListener(SQLErrorEvent.ERROR, errorHandler);

// Wo wird SQL-Datenbank abgespeichert (->Desktop)
var dbFile:File = File.desktopDirectory.resolvePath(„DBSample.db“);

// DB/Datei öffnen; wenn nicht vorhanden, neue Datei
// (Default ist immer SQLMode.CREATE, könnte also auch weggelassen werden)
conn.openAsync(dbFile, SQLMode.CREATE);

function openHandler(event:SQLEvent):void {
trace(„Datenbank erfolgreich erstellt“);
}

function errorHandler(event:SQLErrorEvent):void {
trace(„Fehler:“, event.error.message);
trace(„Details:“, event.error.details);
}

/*
* :::::::::::: Tabelle anlegen, falls sie nicht existiert :::::::::::::::::::::
*/

// neues Statement
var createStatement:SQLStatement = new SQLStatement();

// Statement mit der Datenbank-Verbindung verknüpfen
createStatement.sqlConnection = conn;

// Inhalt des SQL-Statements
var sql:String =
„CREATE TABLE IF NOT EXISTS personen (“ +
“ id INTEGER PRIMARY KEY AUTOINCREMENT, “ +
“ vorname TEXT, “ +
“ nachname TEXT “ +
„)“;
createStatement.text = sql;

// event listeners
createStatement.addEventListener(SQLEvent.RESULT, createResult);
createStatement.addEventListener(SQLErrorEvent.ERROR, createError);

// Statement ausführen
createStatement.execute();

function createResult(event:SQLEvent):void {
trace(„Tabelle erstellt“);
}

function createError(event:SQLErrorEvent):void {
trace(„Fehler:“, event.error.message);
trace(„Details:“, event.error.details);
}

/*
* :::::::::::: Initialer Eintrag :::::::::::::::::::::
*/

// Ersten Eintrag in die DB schreiben
writeIntoDatabase(„Max Mustermann“);

/*
* :::::::::::: Daten nach Buttonklick einfüllen :::::::::::::::::::::
*/

function writeIntoDatabase(str:String):void {

// create the SQL statement
var insertStatement:SQLStatement = new SQLStatement();
insertStatement.sqlConnection = conn;

// define the SQL text
var insertSql:String =
„INSERT INTO personen (vorname) “ +
„VALUES (‚“ + str + „‚)“;
insertStatement.text = insertSql;

// event listener
insertStatement.addEventListener(SQLEvent.RESULT, insertResult);
insertStatement.addEventListener(SQLErrorEvent.ERROR, insertError);

// statement ausführen
insertStatement.execute();
}

function insertResult(event:SQLEvent):void {
trace(„INSERT statement succeeded“);
myTextArea.text = „Eintrag erfolgreich hinzugefügt.“;
}

function insertError(event:SQLErrorEvent):void
{
myTextArea.text = „Fehler: “ + event.error.message;
myTextArea.text += „\nDetails: “ + event.error.details;
}

mySubmitButton.addEventListener(MouseEvent.CLICK, mySubmitButton_CLICK);

function mySubmitButton_CLICK(e:MouseEvent):void {
writeIntoDatabase(myTextInput.text);
}

/* ::::::::::::::: Werte auslesen :::::::::::
*
*/

myReadButton.addEventListener(MouseEvent.CLICK, myReadButton_CLICK);

var selectStmt:SQLStatement

function myReadButton_CLICK(e:MouseEvent):void {

// neues select statement
selectStmt = new SQLStatement();

// dem statement die verbindung zuweisen
selectStmt.sqlConnection = conn;

// statement festlegen
selectStmt.text = „SELECT vorname FROM personen“;

// event listeners
selectStmt.addEventListener(SQLEvent.RESULT, resultHandler);
selectStmt.addEventListener(SQLErrorEvent.ERROR, errorHandler);

// statement ausführen
selectStmt.execute();

}

function resultHandler(event:SQLEvent):void {

// ergebnis ablegen
var result:SQLResult = selectStmt.getResult();

// anzahl der einträge
var numResults:int = result.data.length;

// Textfeld leeren
myTextArea.text = „“;

// schleife
for (var i:int = 0; i < numResults; i++) { var n:Object = result.data[i]; myTextArea.text += n.vorname + "\n"; } } [/as]

Link: Working with local SQL databases
Quelldatei (.fla)

[ad]