中国领先的IT技术网站
|
|

HTML 5 Web SQL Database初探

HTML 5标准不只局限于传统的标记语言,它还拥有很多让人期待的API接口;今天,我们来一起了解HTML 5的Web SQL Database功能。

作者:司马牵牛来源:51CTO.com|2010-03-03 08:36

Tech Neo技术沙龙 | 11月25号,九州云/ZStack与您一起探讨云时代网络边界管理实践


【51CTO译文】在《从零开始构建HTML 5页面》一文中,我们了解到HTML 5的一些新增特性并通过实例打造了一个完整的HTML 5页面。但HTML 5标准不只局限于传统的标记语言,它还拥有很多让人期待的API接口,利用这些接口,开发者可以创建更加丰富、更加引人注目的应用程序。之前我们介绍过支持文件拖放上传功能的HTML 5 File API,今天,我们一起来了解HTML 5的Web SQL Database API,使用本地和会话存储实现简单的对象持久化。

对于HTML 5,也许最为有用的就是它新推出的“Web Storage”(Web 存储)API。对简单的关键值对(比如应用程序设置)或简单对象(如应用程序状态)进行存储,使用本地和会话存储能够很好地完成,但是在对琐碎的关系数据进行处理之外,它就力所不及了。而这正是 HTML 5 的“Web SQL Database”API 接口的应用所在。

先提个醒,该文下面的内容需要读者对 JavaScript 和面对对象编程(尤其是匿名内的内部函数)以及SQL具有很好的理解。

打开链接

为了打开一个连接,我们执行以下代码:

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

以上代码创建了一个数据库对象 db,名称是 Todo,版本编号为0.1。db 还带有描述信息和大概的大小值。用户代理(user agent)可使用这个描述与用户进行交流,说明数据库是用来做什么的。利用代码中提供的大小值,用户代理可以为内容留出足够的存储。如果需要,这个大小是可以改变的,所以没有必要预先假设允许用户使用多少空间。

为了检测之前创建的连接是否成功,你可以检查那个数据库对象是否为null:

  1. if(!db)  
  2.      alert("Failed to connect to database."); 

绝不可以假设该连接已经成功建立,即使过去对于某个用户它是成功的。为什么一个连接会失败,存在多个原因。也许用户代理出于安全原因拒绝你的访问,也许设备存储有限。面对活跃而快速进化的潜在用户代理,对用户的机器、软件及其能力作出假设是非常不明智的行为。比如,当用户使用手持设备时,他们可自由处置的数据可能只有几兆字节。

执行查询

执行一个查询,你可以使用database.transaction()函数。该函数具有单一参数,负责查询实际执行的函数。

该函数(通常是匿名的)具有一个类型事务的参数。

  1. db.transactionfunction(tx) { 

该事务具有一个函数:executeSql。这个函数使用四个参数:表示查询的字符串,插入到查询中问号所在处的字符串数据(很像 Java 的预先准备好的语句),一个成功时执行的函数和一个失败时执行的函数。

  1. tx.executeSql("SELECT COUNT(*) FROM ToDo", [], function(result){}, function(tx, error){}); 




查询成功时

当查询成功执行时,应用程序跳转至一个具有一对参数的查询,一个是 transaction,另一个是它搜集的 results。对于实际上将你的数据传递至用户,这是非常完美的,比如显示 ToDo 列表。有关这个话题后面再讲。

查询失败失败时

当查询没能执行时执行。由于你将 transaction  对象作为函数的第一个参数进行传递,当出现错误时你可以继续执行查询。例如,如果是因为缺少表格(table)而查询无法运行,这是创建一个表格并在此执行该语句的绝佳时机。从该函数的第二个参数,你可以获得有关该错误的信息(包括描述)。

示例

假设我们想要使用上面的例子,想要查询数据库中的某个表格,如果该表格不存在,我们就创建一个表格。

在这个示例中,我们将调用具有一个函数参数的 db.transaction()。这个参数中,我们调用 tx.executeSql()。如果这个步骤成功,我们不做任何操作(因此是一个null参数)。或者我们将该事务和执行失败的函数一起传递,并再次调用 tx.executeSql()。这一次使用创建查询。

  1. db.transactionfunction(tx) { tx.executeSql("SELECT COUNT(*) FROM ToDo",
     [], 
    nullfunction(tx, error) { tx.executeSql("CREATE TABLE ToDo (id REAL UNIQUE, label TEXT, timestamp REAL)",
     [], 
    nullnull); } ); } ); 
  2.  

使用所有这些内部方法,可能有点麻烦,所以你也许想在外部创建一个调用 db.transaction() 的函数。比如,我们可以让错误函数是自包含的,并将其命名为“createToDoTable()”。

插入

为了让代码更加简洁和安全,Web SQL Database API 允许你为  transaction.executeSql() 函数提供字符串数据,用以表示调用的 SQL 语句中的变量。我们使用以下的代码进行演示:

  1. db.transactionfunction(tx) { tx.executeSql("INSERT INTO ToDo (label, timestamp) values(?, ?)"
    [label, new 
    Date().getTime()], nullnull); } ); 
  2.  

在这个示例中,第一个参数中的两个问号将被后面数组中对应的项替代。第一个是为该任务设置的标签(也许是我们之前在代码中定义的一个变量),以及调用函数生成的时间戳。

执行该查询,其结果与下面语句类似:

  1. INSERT INTO ToDo (label, timestampvalues ("Test", 1265925077487) 

对结果进行处理

成功执行的函数对结果对象包含集合或行。每一列表示一个结果。该结果包含分配给它的一组值,表示该特定结果的数据库中的每一列的值。通过调用 result.rows.item(i) 可以访问一个行,其中 i 是你想要查询的行的指针。想要从一行中选择一个值,你可以传递给该行一个数组格式的字符串指针,它表示你需要查询的列。例如,如果想要标签(label)列,我们可以调用  row['label']。

以下代码使用结果对象来输出一个查询的结果:

  1. db.transactionfunction(tx) { tx.executeSql("SELECT * FROM ToDo", [],  
  2.  function(tx, result) { for(var i = 0; i < result.rows.length; i++)   
  3. { document.write('<b>' + result.rows.item(i)['label'] + '</b><br />'); } }, null); } ); 
  4.  

结论

需要注意的是,如果不是绝对需要的情况,不要使用 Web SQL Database。这不是因为它们的技术高高在上,而是因为它们会让你的代码更加复杂。对于大多数情况,本地存储或会话存储就能够完成相应的任务,尤其是你能够保持对象状态持久化的情况。

正如前面所说,通过这些HTML 5 Web SQL Database API 接口,你可以获取许多功能。我相信,几年以后会出现一些非常优秀的、建立在这些 API 之上的应用程序。

【编辑推荐】

  1. HTML 5中将被舍弃以及将被强化的元素
  2. HTML5 File API初探 支持文件拖放上传功能
  3. HTML 5来临 Flash死亡倒计时?
  4. 从零开始构建HTML 5 Web页面
  5. HTML 5指引下一代网络应用开发标准
【责任编辑:red7 TEL:(010)68476606】

点赞 0
分享:
大家都在看
猜你喜欢

读 书 +更多

PHP程序开发范例宝典

本书全面介绍了应用PHP进行网站开发的各种技术和技巧。全书分为20章,内容包括PHP的运行环境配置、表单及表单元素的应用、CSS与JavaScript...

订阅51CTO邮刊

点击这里查看样刊

订阅51CTO邮刊
× CTO训练营(深圳站)