Html5 Web SQLite Database Example

database = openDatabase(dbName, dbVersion, dbDesc, dbSize);

database.transaction(function(tx) < // select the record by username case insensetive. var selectSql = 'select * from ' + tableNameUserData + ' where name = \'' + userName +'\' COLLATE NOCASE'; console.log('selectSql = ' + selectSql); tx.executeSql(selectSql, [], function(tx, result)< console.log('result.rows.length = ' + result.rows.length); if(result.rows.length >0)< var message = 'The user name exist, please input another one.' alert(message); console.log(message); >else < // if not exist then insert the user data. insertFuncName(userName, userEmail, userNote); >>, function(tx, error)< alert(error); >); >);

      .block-class < display:block; margin-top:10px; >.label-class 
Html5 Web SQLite Database Example.
 
 
 
 
 
 
 
 
 

var outputListElement = null; var outputListID = 'outputList'; var dbName = 'UserDB'; var dbVersion = '1.0'; var dbDesc = 'User Info Database.'; var dbSize = 2 * 1024 * 1024; var database = null; var tableNameUserData = 'UserData'; function initApp() < outputListElement = document.getElementById(outputListID); database = openDatabase(dbName, dbVersion, dbDesc, dbSize); createUserDataTable(); searchAll(tableNameUserData); >function saveUserData(userNameId, userEmailId, userNoteId)< var userNameValue = ''; var userEmailValue = ''; var userNoteValue = ''; var userNameObject = document.getElementById(userNameId); if(userNameObject==null)< alert('The user name input text box does not exist.'); return; >else < userNameValue = userNameObject.value; if(userNameValue.trim().length == 0)< alert('The user name can not be empty.'); return; >> var userEmailObject = document.getElementById(userEmailId); if(userEmailObject==null)< alert('The user email input text box does not exist.'); return; >else < userEmailValue = userEmailObject.value; if(userEmailValue.trim().length == 0)< alert('The user email can not be empty.'); return; >> var userNoteObject = document.getElementById(userNoteId); if(userNoteObject==null)< alert('The user note input text area does not exist.'); return; >else < userNoteValue = userNoteObject.value; if(userNoteValue.trim().length == 0)< alert('The user note input text area can not be empty.'); return; >> isUserExist(userNameValue, userEmailValue, userNoteValue, insertUserData); > function insertUserData(userNameValue, userEmailValue, userNoteValue)< // execute insert sql to insert the user data to the UserData table. database.transaction(function(tx)< var insertSql = 'insert into UserData(id, name, email, note, time) values(?, ?, ?, ?, ?)'; * 10000); pubTime = Date.now(); valueArray = [id, userNameValue, userEmailValue, userNoteValue, pubTime]; console.log('insertSql = ' + insertSql); tx.executeSql(insertSql, valueArray, function(tx, result)< var message = 'Save user data to local SQLite database table successfully.'; alert(message); console.log('message = ' + message); searchAll(tableNameUserData) >, function(tx, error)< var message = 'Save user data to local SQLite database table fail, the error message is ' + error alert(message); console.log('message = ' + message); >); >); > // need to implement the below function later. function isUserExist(userName, userEmail, userNote, insertFuncName) < database.transaction(function(tx)< // select the record by username case insensetive. var selectSql = 'select * from ' + tableNameUserData + ' where name = \'' + userName +'\' COLLATE NOCASE'; console.log('selectSql = ' + selectSql); tx.executeSql(selectSql, [], function(tx, result)< console.log('result.rows.length = ' + result.rows.length); if(result.rows.length >0)< var message = 'The user name exist, please input another one.' alert(message); console.log(message); >else < // if not exist then insert the user data. insertFuncName(userName, userEmail, userNote); >>, function(tx, error)< alert(error); >); >); > function searchByName(searchByNameKeywordId) < var searchByNameKeywordObject = document.getElementById(searchByNameKeywordId); if(searchByNameKeywordObject==null)< alert('The search user by name keyword input text box does not exist.'); return; >var searchName = searchByNameKeywordObject.value; if(searchName.trim().length == 0)< searchAll(tableNameUserData); >else < database.transaction(function(tx)< // select all the data from the database table by the name condition. var selectByNameSql = 'select * from ' + tableNameUserData + ' where name like "%' + searchName + '%"'; tx.executeSql(selectByNameSql, [], function(tx, results)< var rowsNumber = results.rows.length; console.log('selectByNameSql = ' + selectByNameSql); console.log('rowsNumber = ' + rowsNumber); if(rowsNumber >0) < // remove all the child notes in the web page message list. outputListElement.innerHTML = ''; for(var i=0; i> >, function(tx, error)< >); >); > > function createUserDataTable()< database.transaction(function(tx)< // create the UserData table if not exist. var createTableSql = 'create table if not exists UserData(id unique, name TEXT, email TEXT, note TEXT, time INTEGER)'; tx.executeSql(createTableSql); >); > function searchAll(tableName) < database.transaction(function(tx)< // select all the data from the database table. var selectAllSql = 'select * from ' + tableName; tx.executeSql(selectAllSql, [], function(tx, results)< var rowsNumber = results.rows.length; console.log('selectAllSql = ' + selectAllSql); console.log('rowsNumber = ' + rowsNumber); // first empty all the user data list on the web page. outputListElement.innerHTML = ''; if(rowsNumber >0) < for(var i=0; i> >, function(tx, error)< >); >); > function addUserDataOnWebPage(rowData) < var labelUserId = document.createElement('label'); labelUserId.style.display = 'block'; var labelUserIdText = document.createTextNode('Id:' + rowData.id); labelUserId.append(labelUserIdText); outputListElement.append(labelUserId); var labelUserName = document.createElement('label'); labelUserName.style.display = 'block'; var labelUserNameText = document.createTextNode('Name:' + rowData.name); labelUserName.append(labelUserNameText); outputListElement.append(labelUserName); var labelUserEmail = document.createElement('label'); labelUserEmail.style.display = 'block'; var labelUserEmailText = document.createTextNode('Email:' + rowData.email); labelUserEmail.append(labelUserEmailText); outputListElement.append(labelUserEmail); var labelUserNote = document.createElement('label'); labelUserNote.style.display = 'block'; var labelUserNoteText = document.createTextNode('Note:' + rowData.note); labelUserNote.append(labelUserNoteText); outputListElement.append(labelUserNote); var labelPubTime = document.createElement('label'); labelPubTime.style.display = 'block'; var date = new Date(); date.setTime(rowData.time); var labelPubTimeText = document.createTextNode('Publish Time:' + date.toLocaleDateString() + ' ' + date.toLocaleTimeString()); labelPubTime.append(labelPubTimeText); outputListElement.append(labelPubTime); var hr = document.createElement('hr'); outputListElement.append(hr); >function clearUserDataTable()< database.transaction(function(tx)< var delSql = 'delete from ' + tableNameUserData; tx.executeSql(delSql, [], function(tx, result)< var message = 'Delete all data from UserData table successfully.'; alert(message); console.log(message); console.log(delSql); searchAll(tableNameUserData); >, function(tx, error)< >); >); >

Источник

HTML 5. Работа с Web SQL базой данных

В HTML 5 есть много новых возможностей, которые позволяют web разработчикам создавать более мощные и насыщенные приложения. К этим возможностям относятся и новые способы хранения данных на клиенте, такие как web storage(поддерживается в IE8) и web SQL database.

При этом если web storage ориентирован на хранение пар ключ-значение, то в случае с web SQL database у нас есть полноценный sqlite(во всех текущих реализациях применяется именно этот движок баз данных, что является проблемой при стандартизации).

Далее я расскажу, как работать с web SQL database. При этом примеры естественно будут на JavaScript. Кроме того, стоит отметить, что с поддержкой браузерами всего этого хозяйства дела обстоят, не очень хорошо, но всё постепенно меняется к лучшему и, скажем, в Opera 10.50 поддержка будет, а браузерах на движке WebKit она уже есть. Более подробно про то, какой браузер, что поддерживает можно узнать, пройдя по ссылке.

Соединение с базой данных.

Подсоединиться к базе данных очень просто:

db = openDatabase(«ToDo», «0.1», «A list of to do items.», 200000);

Данный код создаёт объект, представляющий БД, а если базы данных с таким именем не существует, то создаётся и она. При этом в аргументах указывается имя базы данных, версия, отображаемое имя и приблизительный размер. Кроме того важно отметить, что приблизительный размер не является ограничением. Реальный размер базы данных может изменяться.

Успешность подключения к БД можно оценить, проверив объект db на null:

Всегда предпринимайте данную проверку, даже если соединение с БД для данного пользователя уже производилось в прошлом, и было успешно. Могут измениться настройки безопасности, закончиться дисковое пространство (скажем, если пользователь использует смартфон) или фаза луны окажется неподходящей.

Выполнение запросов.

Для выполнения запросов к БД предварительно надо создать транзакцию, вызвав функцию database.transaction(). У неё один аргумент, а именно другая JavaScript функция, принимающая объект транзакции и предпринимающая запросы к базе данных.

• строка SQL запроса
• массив параметров запроса (параметры подставляются на место вопросительных знаков в SQL запросе)
• функция, вызываемая при успешном выполнении запроса
• функция, вызываемая в случае возникновения ошибки выполнения запроса

db.transaction(function(tx) tx.executeSql(«SELECT COUNT(*) FROM ToDo», [], function(result)<>, function(tx, error)<>);
>);

Давайте теперь изменим код так, чтобы при невозможности выборки из таблицы «ToDo»(которой пока не существует), данная таблица создавалась.

db.transaction(function(tx) tx.executeSql(«SELECT COUNT(*) FROM ToDo», [], function (result) < alert('dsfsdf') >, function (tx, error) tx.executeSql(«CREATE TABLE ToDo (id REAL UNIQUE, label TEXT, timestamp REAL)», [], null, null);
>)>);

Вставка данных.

Давайте вставим новую строку в таблицу «ToDo». Для знакомых с синтаксисом SQL пример, приведённый ниже, покажется очень знакомым:

db.transaction(function(tx) tx.executeSql(«INSERT INTO ToDo (label, timestamp) values(?, ?)», [«Купить iPad или HP Slate», new Date().getTime()], null, null);
>);

Первый знак вопроса в SQL запросе заменяется на «Купить iPad или HP Slate», а второй на метку времени. В итоге выполнен будет примерно такой запрос:
INSERT INTO ToDo (label, timestamp) values («Купить iPad или HP Slate», 1265925077487)

Работа с результатами запросов.

Результат выполнения запроса на выборку данных содержит набор строк, а каждая строка содержит значения столбцов таблицы для данной строки.

Вы можете получить доступ к какой-либо строке результата вызвав функцию result.rows.item(i), где i – индекс строки. Далее, для получения требуемого значения, нужно обратиться к конкретному столбцу по имени – result.rows.item(i)[ «label»].

Следующий пример выводит результат запроса к базе данных на страницу:

db.transaction(function(tx) tx.executeSql(«SELECT * FROM ToDo», [], function(tx, result) for(var i = 0; i < result.rows.length; i++) document.write('‘ + result.rows.item(i)[‘label’] + ‘
‘);
>>, null)>);

Заключение.

Использование web SQL database предоставляет мощные возможности, но не стоит увлекаться. Если задачу можно решить с помощью web storage, лучше использовать его.

Вы можете найти дополнительную информацию по данной теме в соответствующем разделе сайта консорциуме w3c.
Также для web SQL database уже начали разрабатывать ORM библиотеки. Пример такой библиотеки тут.

Источник

HTML5 — Web SQL Database

The Web SQL Database API isn’t actually part of the HTML5 specification but it is a separate specification which introduces a set of APIs to manipulate client-side databases using SQL.

I’m assuming you are a great web developer and if that is the case then no doubt, you would be well aware of SQL and RDBMS concepts. If you still want to have a session with SQL then, you can go through our SQL Tutorial.

Web SQL Database will work in latest version of Safari, Chrome and Opera.

The Core Methods

There are following three core methods defined in the spec that I am going to cover in this tutorial −

• openDatabase − This method creates the database object either using existing database or creating new one.
• transaction − This method gives us the ability to control a transaction and performing either commit or rollback based on the situation.
• executeSql − This method is used to execute actual SQL query.

Opening Database

The openDatabase method takes care of opening a database if it already exists, this method will create it if it already does not exist.

To create and open a database, use the following code −

var db = openDatabase('mydb', '1.0', 'Test DB', 2 * 1024 * 1024);

The above method took the following five parameters −

• Database name
• Version number
• Text description
• Size of database
• Creation callback

The last and 5th argument, creation callback will be called if the database is being created. Without this feature, however, the databases are still being created on the fly and correctly versioned.

Executing queries

To execute a query you use the database.transaction() function. This function needs a single argument, which is a function that takes care of actually executing the query as follows −

var db = openDatabase('mydb', '1.0', 'Test DB', 2 * 1024 * 1024); db.transaction(function (tx) < tx.executeSql('CREATE TABLE IF NOT EXISTS LOGS (id unique, log)'); >);

The above query will create a table called LOGS in ‘mydb’ database.

INSERT Operation

To create enteries into the table we add simple SQL query in the above example as follows −

var db = openDatabase('mydb', '1.0', 'Test DB', 2 * 1024 * 1024); db.transaction(function (tx) < tx.executeSql('CREATE TABLE IF NOT EXISTS LOGS (id unique, log)'); tx.executeSql('INSERT INTO LOGS (id, log) VALUES (1, "foobar")'); tx.executeSql('INSERT INTO LOGS (id, log) VALUES (2, "logmsg")'); >);

We can pass dynamic values while creating entering as follows −

var db = openDatabase('mydb', '1.0', 'Test DB', 2 * 1024 * 1024); db.transaction(function (tx) < tx.executeSql('CREATE TABLE IF NOT EXISTS LOGS (id unique, log)'); tx.executeSql('INSERT INTO LOGS (id,log) VALUES (?, ?'), [e_id, e_log]; >);

Here e_id and e_log are external variables, and executeSql maps each item in the array argument to the «?»s.

READ Operation

To read already existing records we use a callback to capture the results as follows −

var db = openDatabase('mydb', '1.0', 'Test DB', 2 * 1024 * 1024); db.transaction(function (tx) < tx.executeSql('CREATE TABLE IF NOT EXISTS LOGS (id unique, log)'); tx.executeSql('INSERT INTO LOGS (id, log) VALUES (1, "foobar")'); tx.executeSql('INSERT INTO LOGS (id, log) VALUES (2, "logmsg")'); >); db.transaction(function (tx) < tx.executeSql('SELECT * FROM LOGS', [], function (tx, results) < var len = results.rows.length, i; msg = "
Found rows: " + len + "
"; document.querySelector('#status').innerHTML += msg; for (i = 0; i < len; i++) < alert(results.rows.item(i).log ); >>, null); >);

Final Example

So finally, let us keep this example in a full-fledged HTML5 document as follows and try to run it with Safari browser.

      
Status Message
   

This will produce the following result −

Источник