The Web SQL Storage (based on SQLite) API in HTML 5 is ideal for Mobile Web applications that require a complex data storage support and that work mostly offline. The Web storage remains locally on the device, and it is persisted even after the application or browser is closed. The implementation of the data access is all done using JavaScript and the SQL script format is compliant with the SQLite specifications.
To create or open a database, the following script can be used:
var data=null; var Tables= ['CREATE TABLE IF NOT EXISTS mynotes
(id INTEGER NOT NULL PRIMARY KEY AUTOINCREMENT,notes TEXT, date TEXT)'];
if (typeof (window.openDatabase) != 'undefined' && window.openDatabase) {
var maxSize = 5 * 1024 * 1024; data = window.openDatabase('appName', '1.0', 'appName_db', maxSize);
if (data) { data.transaction(function (tx) { $(tables).each(function ()
{ tx.executeSql(this); }); });
}
}
The script above checks the openDatabase
property from the windows
object. If the value is true
, there is Web Storage support, and we can move forward with the API calls to open the database. The openDatabase
call opens the connection to the database. If the database does not currently exists, the database gets automatically created, but with no tables. The parameters to open the database uniquely identify the database and its size. Once we have a valid handle to the database, we can use a transaction object to run a SQL statement and build our tables using the executeSql
method. This method is also used to execute other SQL statements on the database. The SQL statement to build the tables checks to see if the table does not exist before creating.
CRUD Method
To insert
, update
, and delete
a record, we just need to use the following scripts:
Execute: function (sql, params, dataHandler, errHandler) {
if (data) { data.transaction(function (tx)
{tx.executeSql(sql, params, dataHandler, errHandler);});
}
},
ErrorHandler: function (tx, err) {
alert('DbError: ' + err.message + ' (Code ' + err.code + ')');
return false;
},
DataHandler: function (tx, data) {
if (typeof (data) != 'undefined') {
if (data.rows.length == 0) {
}
else if (data.rows.length > 0) { for (i = 0; i < data.rows.length; i++) {
var row = data.rows.item(i);
var data = [row['id'] ,row['notes'], row['date']] }
}
}
}
The execute
function executes a SQL statement by calling the transaction executeSql
method. This method takes the SQL statement, a parameters array and handlers for successful or failed responses. The DataHandler
manages the return recordset
(data parameter) or rows affected from an update
, delete
and insert
statement. The data.rows
collection is populated when a select
statement is executed. For an insert
on a table with an identity column, the data.insertedId
property is set to the new identity id. The DataHandler
method is where the recordset can be iterated to populate the UI with the data.
The CRUD statements look as follows:
sqlIns: 'INSERT INTO mynotes(notes,date) values(?,?)',
sqlUpd: 'UPDATE mynotes SET notes=?,date=? WHERE id=?',
sqlDel: 'DELETE mynotes WHERE id=?',
sqlSel: 'SELECT * FROM mynotes WHERE id=?'
You should note the question marks. These are the parameter variables that are matched to the values in the params
array of the Execute
function. For example, to insert a new record, use the following:
var params = [‘my notes here’,’02/20/2011’];
Execute(sqlIns, params,DataHandler,ErrorHandler);
With the ability to open a database and execute SQL statements against the database, simple data providers could be implemented to provide data support for your mobile applications. This can be handy for disconnected mode support in mobile applications.
I hope this is helpful.
CodeProject
og-bit.com