HTML and CSS Reference
In-Depth Information
sie noch nicht existiert. Somit kann mit jedem Zugriff auf die HTML-Seite der gleiche
JavaScript-Code ausgeführt werden. In unserem Fall sieht die Erzeugung der
notes
-
Tabelle (in der
notes
-Datenbank) so aus:
var errorCallback function(error)
{
alert('errorCallBack: ' + error.code + ' / message: ' + error.message);
}
db.transaction(function(t){
t.executeSql('CREATE TABLE IF NOT EXISTS notes
(id INTEGER NOT NULL PRIMARY KEY AUTOINCREMENT,
note TEXT, date DATE NOT NULL DEFAULT CURRENT TIMESTAMP);');
}, errorCallback);
Um SQL im Rahmen einer Transaktion auszuführen, benutzen Sie die Methode
transaction
der Datenbankreferenz. Der erste Parameter stellt eine Callback-Funktion
dar, an die ein Transaktionsobjekt übergeben wird (hier
t
). Die Methode
executeSql()
kann nun dazu benutzt werden, beliebiges SQL auszuführen. In unse-
rem Fall erzeugen wir die
notes
-Tabelle, falls sie noch nicht existiert.
Wie Sie ebenfalls sehen können, haben wir einen zweiten Parameter angegeben, der
auch eine Callback-Funktion darstellt. Das
errorCallback
oben wird aufgerufen, so-
bald die Transaktion missglückt ist. In diesem Fall wird ein
SQLError
-Objekt an die
Funktion übergeben, das zwei wichtige Attribute hat:
code
und
message
.
message
stellt eine (englische) Beschreibung des Fehlers dar und sollte nur während der Ent-
wicklungszeit verwendet werden. Der folgenden Tabelle können Sie alle Fehlercodes
entnehmen:
Konstante
Code
Bedeutung
Ein unbekannter Fehler ist aufgetreten, der nicht weiter spezi-
fiziert werden kann.
UNKNOWN ERROR
0
Das SQL-Statement ist fehlgeschlagen, Grund kann ein feh-
lerhaftes Statement sein, das so von der Datenbank (SQLite)
nicht verstanden wird.
DATABASE ERR
1
Ein Fehler ist aufgetreten, weil die Version der Datenbank
nicht der Version entsprach, die erwartet wurde.
VERSION ERR
2
Die zurückgelieferte Datenmenge ist zu groß, es muss even-
tuell der Modifizierer
LIMIT
benutzt werden, um die Anzahl
der Zeilen zu beschränken.
TOO LARGE ERR
3
Das Statement schlug fehl, da die maximale Größe der
Datenbank überschritten wurde. Sofern der Benutzer nach
Zustimmung zur Erhöhung der Speichermenge gefragt wurde,
hat er abgelehnt.
QUOTA ERR
4
