PhoneGap API帮助文档翻译—Storage（存储）

最新推荐文章于 2023-07-16 17:10:39 发布
最新推荐文章于 2023-07-16 17:10:39 发布
阅读量90 收藏
点赞数
分类专栏： HTML5 文章标签： html5 phonegap
版权声明：本文为博主原创文章，遵循 CC 4.0 BY-SA 版权协议，转载请附上原文出处链接和本声明。
本文链接：https://blog.csdn.net/weistar103/article/details/84426708
版权

文章源自:http://blog.csdn.net/phonegapcn/article/details/6702943

提供对设备的存储选项的访问。

此 API基于W3C WEB SQL Database Specification和W3C Web Storage API Specification。有些设备已经提供了对该规范的实现，对于这些设备采用内置实现而非使用PhoneGap的实现。对于没有存储支持的设 备，PhoneGap的实现应该是完全兼容W3C规范。

方法：

  • openDatabase

参数：

  • name
  • version
  • display_name
  • size

对象：

  • Database
  • SQLTransaction
  • SQLResultSet
  • SQLResultSetList
  • SQLError
  • localStorage

openDatabase

返回一个新的Database对象。

 

var dbShell = window.openDatabase(name, version, display_name, size);

 说明：window.openDatabase返回一个新的Database对象。

 

该方法将创建一个新的SQL Lite数据库，并返回该Database对象。可使用该Database对象操作数据。

支持的平台：

  • Android
  • BlackBerry WebWorks (OS 6.0或更高版本)
  • iPhone

简单的范例：

 

var db = window.openDatabase("test", "1.0", "Test DB", 1000000);

 完整的范例：

 

 

<!DOCTYPE html>
<html>
<head>	
<title>Contact Example</title>

<script type="text/javascript" charset="utf-8" src="phonegap.js"></script>
<script type="text/javascript" charset="utf-8">

// 等待加载PhoneGap
document.addEventListener("deviceready", onDeviceReady, false); 

// PhoneGap加载完毕
function onDeviceReady() {
	var db = window.openDatabase("test", "1.0", "Test DB", 1000000);
}

</script>
</head>
<body>
	<h1>Example</h1>
	<p>Open Database</p>
</body>
</html>

name:数据库的名称。

 

version:数据库的版本号。

display_name:数据库的显示名。

size:以字节为单位的数据库大小。

Database:包含允许用户操作数据库的方法。

方法：

  • transaction：运行一个数据库事务。
  • changeVersion：该方法允许脚本执行以下原子操作：校验数据库的版本号并更新版本号以完成架构更新。

详述：

调用window.openDatabase()将返回一个Database对象。

支持的平台：

  • Android
  • BlackBerry WebWorks (OS 6.0或更高版本)
  • iPhone

Transaction 的简单范例：

 

function populateDB(tx) {
	tx.executeSql('DROP TABLE DEMO IF EXISTS');
	tx.executeSql('CREATE TABLE IF NOT EXISTS DEMO (id unique, data)');
	tx.executeSql('INSERT INTO DEMO (id, data) VALUES (1, "First row")');
	tx.executeSql('INSERT INTO DEMO (id, data) VALUES (2, "Second row")');
}

function errorCB(err) {
   	alert("Error processing SQL: "+err.code);
}

function successCB() {
   	alert("success!");
}

var db = window.openDatabase("Database", "1.0", "PhoneGap Demo", 200000);
db.transaction(populateDB, errorCB, successCB);

 Change Version的简单范例：

 

 

var db = window.openDatabase("Database", "1.0", "PhoneGap Demo", 200000);
db.changeVersion("1.0", "1.1");

 完整的范例：

 

 

<!DOCTYPE html>
<html>
<head>	
<title>Contact Example</title>

<script type="text/javascript" charset="utf-8" src="phonegap.js"></script>
<script type="text/javascript" charset="utf-8">

	// 等待加载PhoneGap
	document.addEventListener("deviceready", onDeviceReady, false); 
	
	// PhoneGap加载完毕
	function onDeviceReady() {
		var db = window.openDatabase("Database", "1.0", "PhoneGap Demo", 200000);
		db.transaction(populateDB, errorCB, successCB);
	}
	
	// 填充数据库
	function populateDB(tx) {
		tx.executeSql('DROP TABLE DEMO IF EXISTS');
		tx.executeSql('CREATE TABLE IF NOT EXISTS DEMO (id unique, data)');
		tx.executeSql('INSERT INTO DEMO (id, data) VALUES (1, "First row")');
		tx.executeSql('INSERT INTO DEMO (id, data) VALUES (2, "Second row")');
	}
	
	// 事务执行出错后调用的回调函数
	function errorCB(tx, err) {
		alert("Error processing SQL: "+err);
	}
	
	// 事务执行成功后调用的回调函数
	function successCB() {
		alert("success!");
	}

</script>
</head>
<body>
	<h1>Example</h1>
	<p>Database</p>
</body>
</html>

 Android 1.X 的特异情况：

 

  • changeVersion：Android 1.X设备不支持此方法。

SQLTransaction

包含允许用户对Database对象执行SQL语句的方法。

方法：

  • executeSql：执行一条SQL语句。

详述：当你调用Database对象的transaction方法后，其回调函数将被调用并接收一个SQLTransaction对象。用户可以通过多次调用executeSql来建立一个数据库事务处理。

支持的平台：

  • Android
  • BlackBerry WebWorks (OS 6.0或更高版本)
  • iPhone

Execute SQL的简单范例：

 

function populateDB(tx) {
	tx.executeSql('DROP TABLE DEMO IF EXISTS');
	tx.executeSql('CREATE TABLE IF NOT EXISTS DEMO (id unique, data)');
	tx.executeSql('INSERT INTO DEMO (id, data) VALUES (1, "First row")');
	tx.executeSql('INSERT INTO DEMO (id, data) VALUES (2, "Second row")');
}

function errorCB(err) {
   	alert("Error processing SQL: "+err);
}

function successCB() {
   	alert("success!");
}

var db = window.openDatabase("Database", "1.0", "PhoneGap Demo", 200000);
db.transaction(populateDB, errorCB, successCB);

 完整的范例：

 

 

<!DOCTYPE html>
<html>
<head>	
<title>Contact Example</title>

<script type="text/javascript" charset="utf-8" src="phonegap.js"></script>
<script type="text/javascript" charset="utf-8">

// 等待加载PhoneGap
document.addEventListener("deviceready", onDeviceReady, false);

// PhoneGap加载完毕
function onDeviceReady() {
   	var db = window.openDatabase("Database", "1.0", "PhoneGap Demo", 200000);
   	db.transaction(populateDB, errorCB, successCB);
}

// 填充数据库
function populateDB(tx) {
	tx.executeSql('DROP TABLE DEMO IF EXISTS');
	tx.executeSql('CREATE TABLE IF NOT EXISTS DEMO (id unique, data)');
	tx.executeSql('INSERT INTO DEMO (id, data) VALUES (1, "First row")');
	tx.executeSql('INSERT INTO DEMO (id, data) VALUES (2, "Second row")');
}

// 事务执行出错后调用的回调函数
function errorCB(err) {
   	alert("Error processing SQL: "+err);
}

// 事务执行成功后调用的回调函数
function successCB() {
   	alert("success!");
}

</script>
</head>
<body>
	<h1>Example</h1>
	<p>SQLTransaction</p>
</body>
</html>

 SQLResultSet

 

当SQLTransaction对象的executeSql方法被调用，将会触发executeSql中设定的回调函数并返回一个SQLResultSet对象。

属性：

  • insertId：SQLResultSet对象通过SQL语句插入到数据库的行记录的行ID。[译注：如果插入多行的时候，返回最后一个行的ID]
  • rowAffected：被SQL语句改变的记录行数，如果语句没有影响任何行则设置为0。
  • rows：是一个SQLResultSetRowList对象，表示返回的多条记录。如果没有返回任何记录，则此对象为空。

详述：

当 你调用SQLTransaction对象的executeSql方法，将会触发executeSql中设定的回调函数并返回一个SQLResultSet 对象。该结果对象包含三个属性：第一个是insertID返回成功的SQL插入语句所插入行的ID，如果SQL语句不是插入语句则insertID将不被 设定；第二个是rowAffected，在SQL查询操作时此属性总是0，当插入或更新操作时此属性返回受到影响的行数；最后一个属性是 SQLResultSetList类型，返回SQL查询语句的返回数据。

支持的平台：

  • Android
  • BlackBerry WebWorks (OS 6.0或更高版本)
  • iPhone

Execute SQL的简单范例：

 

function queryDB(tx) {
	tx.executeSql('SELECT * FROM DEMO', [], querySuccess, errorCB);
}

function querySuccess(tx, results) {
	// 因为没有插入记录，所以返回值为空
	console.log("Insert ID = " + results.insertId);
	// 因为这是一条查询语句所以返回值为0
	console.log("Rows Affected = " + results.rowAffected);
	// 返回查询到的记录行数量
	console.log("Insert ID = " + results.rows.length);
}

function errorCB(err) {
	alert("Error processing SQL: "+err.code);
}

var db = window.openDatabase("Database", "1.0", "PhoneGap Demo", 200000);
db.transaction(queryDB, errorCB);

 完整的范例：

 

 

<!DOCTYPE html>
<html>
<head>	
<title>Contact Example</title>

<script type="text/javascript" charset="utf-8" src="phonegap.js"></script>
<script type="text/javascript" charset="utf-8">

	// 等待加载PhoneGap
	document.addEventListener("deviceready", onDeviceReady, false);
	
	// 填充数据库
	function populateDB(tx) {
		tx.executeSql('DROP TABLE DEMO IF EXISTS');
		tx.executeSql('CREATE TABLE IF NOT EXISTS DEMO (id unique, data)');
		tx.executeSql('INSERT INTO DEMO (id, data) VALUES (1, "First row")');
		tx.executeSql('INSERT INTO DEMO (id, data) VALUES (2, "Second row")');
	}
	
	// 查询数据库
	function queryDB(tx) {
		tx.executeSql('SELECT * FROM DEMO', [], querySuccess, errorCB);
	}
	
	// 查询成功后调用的回调函数
	function querySuccess(tx, results) {
		// 因为没有插入记录，所以返回值为空
		console.log("Insert ID = " + results.insertId);
		// 因为这是一条查询语句所以返回值为0
		console.log("Rows Affected = " + results.rowAffected);
		// 返回查询到的记录行数量
		console.log("Insert ID = " + results.rows.length);
	}
	
	// 事务执行出错后调用的回调函数
	function errorCB(err) {
		console.log("Error processing SQL: "+err.code);
	}
	
	// 事务执行成功后调用的回调函数
	function successCB() {
		var db = window.openDatabase("Database", "1.0", "PhoneGap Demo", 200000);
		db.transaction(queryDB, errorCB);
	}
	
	// PhoneGap加载完毕
	function onDeviceReady() {
		var db = window.openDatabase("Database", "1.0", "PhoneGap Demo", 200000);
		db.transaction(populateDB, errorCB, successCB);
	}

</script>
</head>
<body>
	<h1>Example</h1>
	<p>Database</p>
</body>
</html>

 SQLResultSetList

 

SQLResultSet对象的一个属性，包含SQL查询所返回的所有行数据。

属性：length： SQL查询所返回的记录行数。

方法：item：根据指定索引返回一个行记录的JavaScript对象。

详述：

SQlResultSetList 包含一个SQL查询语句所返回的数据。该对象包含一个长度属性告知用户有多少符合查询条件的行记录数被返回。通过传递指定的索引给该对象的item方法获 取指定的行记录数据，此item方法返回一个JavaScript对象，其属性包含前述查询语句所针对的数据库的所有列。

支持的平台：

  • Android
  • BlackBerry WebWorks (OS BlackBerry WebWorks (OS 6.0或更高版本)
  • iPhone

Execute SQL的简单范例：

 

function queryDB(tx) {
   	tx.executeSql('SELECT * FROM DEMO', [], querySuccess, errorCB);
}

function querySuccess(tx, results) {
   	var len = results.rows.length;
   	console.log("DEMO table: " + len + " rows found.");
   	for (var i=0; i<len; i++){
	   	console.log("Row = " + i + " ID = " + results.rows.item(i).id + " Data =  " + results.rows.item(i).data);
   	}
}

function errorCB(err) {
   	alert("Error processing SQL: "+err.code);
}

var db = window.openDatabase("Database", "1.0", "PhoneGap Demo", 200000);
db.transaction(queryDB, errorCB);

 完整的范例：

 

 

<!DOCTYPE html>
<html>
<head>	
<title>Contact Example</title>

<script type="text/javascript" charset="utf-8" src="phonegap.js"></script>
<script type="text/javascript" charset="utf-8">

	// 等待加载PhoneGap
	document.addEventListener("deviceready", onDeviceReady, false); 
	
	// 填充数据库
	function populateDB(tx) {
		tx.executeSql('DROP TABLE DEMO IF EXISTS');
		tx.executeSql('CREATE TABLE IF NOT EXISTS DEMO (id unique, data)');
		tx.executeSql('INSERT INTO DEMO (id, data) VALUES (1, "First row")');
		tx.executeSql('INSERT INTO DEMO (id, data) VALUES (2, "Second row")');
	}
	
	// 查询数据库
	function queryDB(tx) {
		tx.executeSql('SELECT * FROM DEMO', [], querySuccess, errorCB);
	}
	
	// 查询成功后调用的回调函数
	function querySuccess(tx, results) {
		var len = results.rows.length;
		console.log("DEMO table: " + len + " rows found.");
		for (var i=0; i<len; i++){
			console.log("Row = " + i + " ID = " + results.rows.item(i).id + " Data =  " + results.rows.item(i).data);
		}
	}
	
	// 事务执行出错后调用的回调函数
	function errorCB(err) {
		console.log("Error processing SQL: "+err.code);
	}
	
	// 事务执行成功后调用的回调函数
	function successCB() {
		var db = window.openDatabase("Database", "1.0", "PhoneGap Demo", 200000);
		db.transaction(queryDB, errorCB);
	}
	
	// PhoneGap加载完毕
	function onDeviceReady() {
		var db = window.openDatabase("Database", "1.0", "PhoneGap Demo", 200000);
		db.transaction(populateDB, errorCB, successCB);
	}

</script>
</head>
<body>
	<h1>Example</h1>
	<p>Database</p>
</body>
</html>

 SQLError

 

出现错误时，将抛出一个SQLError对象。

属性：

  • code： 一个在下面常量列表中定义好的错误代码c。
  • message：关于此错误的说明。

常量：

  • SQLError.UNKNOWN_ERR：未知错误
  • SQLError.DATABASE_ERR：数据库错误
  • SQLError.VERSION_ERR：版本错误
  • SQLError.TOO_LARGE_ERR：数据集过大错误
  • SQLError.QUOTA_ERR：超过数据库配额错误
  • SQLError.SYNTAX_ERR：语法错误
  • SQLError.CONSTRAINT_ERR：约束错误
  • SQLError.TIMEOUT_ERR：超时错误

说明：操作数据库出现错误时，将抛出一个SQLError对象。

localStorage

提供对W3C Storage接口(http://dev.w3.org/html5/webstorage/#the-localstorage-attribute)的访问。

 

var storage = window.localStorage;

 方法：

 

  • key：返回指定位置的键的名称。
  • getItem： 返回指定键所对应的记录。
  • setItem：存储一个键值对。
  • removeItem：删除指定键对应的记录。
  • clear：删除所有的键值对。

详述：localStorage提供对W3C Storage接口的访问，可以使用键值对的方式存储数据。

支持的平台：

  • Android
  • BlackBerry WebWorks(OS 6.0或更高版本)
  • iPhone

Key 的简单范例：

var keyName = window.localStorage.key(0);

 Set Item的简单范例：

window.localStorage.setItem("key", "value");

 Get Item的简单范例：

    var value = window.localStorage.getItem("key");  
    // value的值现在是"value"

 Remove Item的简单范例：

window.localStorage.removeItem("key");

 Clear的简单范例：

window.localStorage.clear();

 完整的范例：

<!DOCTYPE html>
<html>
<head>	
<title>Contact Example</title>

<script type="text/javascript" charset="utf-8" src="phonegap.js"></script>
<script type="text/javascript" charset="utf-8">

// 等待加载PhoneGap
document.addEventListener("deviceready", onDeviceReady, false); 

// PhoneGap加载完毕
function onDeviceReady() {
   	window.localStorage.setItem("key", "value");
   	var keyname = window.localStorage.key(i);
   	[译注:应当是var keyname = window.localStorage.key(0);]
   	// keyname的值现在是“key”
   	var value = window.localStorage.getItem("key");
   	// value的值现在是“value”
   	window.localStorage.removeItem("key");
   	window.localStorage.setItem("key2", "value2");
   	window.localStorage.clear();
   	// localStorage现在是空的
}

</script>
</head>
<body>
	<h1>Example</h1>
	<p>localStorage</p>
</body>
</html>

 

 

weistar103
关注
  • 0
    点赞
  • 踩
  • 0
    收藏
    觉得还不错? 一键收藏
  • 0
    评论
专栏目录
(学习笔记)WebSQL版本管理
qq_44858021的博客
05-10 507
每个本地的SQL数据库都仅能存在唯一的数据库名,并且都有唯一的版本号,不可能存在一个数据库多个版本 使用Database.version属性,可以返回数据库的版本号,使用Database.changeVersion()方法可以改变数据库的版本号,该方法的语法格式如下 Database.changeVersion(oldVersion,newVersion[,callback[,errorCallb...
前端开发创新实践
GitChat
04-12 5000
内容简介 近年来，前端技术领域迅猛发展，各种新技术、框架、工具，层出不穷。业内众多优秀企业保持积极探索精神，对现有工具、技术进行了深入探索，甚至缘于研发工作需求进行了升级研发与深度定制。本期我们集合多位前端技术专家撰文分享各自在前端领域的创新探索实践。每篇文中都饱含了作者对诸多技术细节的改进思考，而一次次的改进也体现了他们追求完美的研发精神。...
Web SQL Database
xpjcoo的专栏
11-06 1857
http://www.w3.org/TR/webdatabase/ Web SQL Database W3C Working Group Note 18 November 2010 This Version:http://www.w3.org/TR/2010/NOTE-webdatabase-20101118/Latest Published Version:ht
PhoneGap API帮助文档翻译—Storage（存储） PhoneGap API帮助文档翻译—Storage（存储）...
samwong
02-01 108
PhoneGap API帮助文档翻译—Storage（存储） “ 提供对设备的存储选项的访问。 此API基于W3C WEB SQL Database Specification和W3C Web Storage API Specification。有些设备已经提供了对该规范的实现，对于这些设备采用内置实现而非使用PhoneG...
有了phonegap你还android吗？
12-21 157
第一章 phonegap介绍 1.1 什么是phonegap PhoneGap是一个自由开放源码的开发工具和框架，允许利用HTML + JavaScript + CSS的强大功能在多个手机平台上开发程序,开发出来的程序经过在各自的平台上编译形成独立的安装程序。使程序看起来和native的程序一样。 1.2 PhoneGap的优势和劣势 优势： l 跨平台：一次开发，多个平台共...
【转】有了phonegap你还android吗？
weixin_30902675的博客
12-21 66
【http://www.cnblogs.com/skyme/archive/2011/12/21/2295699.html】第一章 phonegap介绍1.1 什么是phonegapPhoneGap是一个自由开放源码的开发工具和框架，允许利用HTML + JavaScript + CSS的强大功能在多个手机平台上开发程序,开发出来的程序经过在各自的平台上编译形成独立的安装程序。使程序看起来和nat...
Android Web应用高级编程
清图出版
05-14 6330
基本信息 原书名： Pro Android Web Apps: Develop for Android using HTML5, CSS3 & JavaScript 原出版社： Apress 作者： (美)Damon Oehlman    Sébastien Blanc    [作译者介绍] 译者： 张龙 丛书名： 移动与嵌入式开发技术 出版社：清华大学出版社 ISBN：
6.3 Android 打包_使用Buildozer打包成apk
最新发布
lstef的博客
07-16 3101
使用 Buildozer 可以自动构建整个打包的过程，该软件会自动下载并设置 python-for-android的必备组件，包括 Android SDK 和 NDK，然后构建一个可自动推送到设备的 apk，这也是官方首推新使用的一种方式。在 Linux 环境下通过 Buildozer、 Python-for-Android 和 Kivy Launcher 等方面绍如写好的程序打包为在 Android 环境下可执行的文件。【由于使用文字翻译的照片，可能有符号是中文输入法的情况，仅供参考】
PhoneGap,API帮助文档.zip
04-06
这个"PhoneGap API帮助文档.zip"压缩包显然包含了关于如何使用PhoneGap API的详细指南，对于开发者来说是非常宝贵的资源。下面我们将深入探讨PhoneGap API中的关键组件及其功能。 1. **加速度计（Accelerometer）**...
PhoneGap中文API帮助文档
07-29
网上的phonegap中文帮助文档尚少，翻译也不太好，在此收集了一些翻译优秀的文章，并制作成chm的帮助文档，以帮助各位学习,此文档包含了phonegap的主要使用功能，并提供了完整示例
PhoneGap,API帮助文档翻译整理6-Contacts(通讯录).pdf
09-30
PhoneGap,API帮助文档翻译整理6-Contacts(通讯录).pdf
PhoneGap,API帮助文档翻译整理4-Compass(指南针)
04-28
标题：PhoneGap,API帮助文档翻译整理4-Compass(指南针) 描述：本文档将深入探讨PhoneGap中Compass API的功能与应用，包括如何获取设备的指南针方向、监听指南针变化以及如何处理相关事件。 ### 一、Compass API...
CSS中!important的作用--浏览器兼容性
weistar103的专栏
12-25 1386
{*rule !important}这个css规则当今在网页制作的时候的普及已经非常流行了，以前我对它的理解就停留在‘浏览器是否识别阶段’ 而没有真正去研究过，可是现在发生了变化。众所周知，!important这个规则对Ie6.0,Ie7.0和Firefox能写hack，现在就来讲解 这是什么原理： 　　*对于Ie系列浏览器都能够识别， firefox 浏览器则不能识别; 　　!import...
PhoneGap API帮助文档翻译—Contacts（通讯录）
weistar103的专栏
05-03 889
文章源自:http://blog.csdn.net/phonegapcn/article/details/6695642 contacts对象提供对设备通讯录数据库的访问。 方法： contacts.create contacts.find 参数： contactFields contactSuccess contactError contactFindO...
操纵浏览器的历史记录
weistar103的专栏
04-27 600
文章来自:https://developer.mozilla.org/zh-CN/docs/DOM/Manipulating_the_browser_history  window 对象通过history对象提供对览器历史记录的访问能力。它暴露了一些非常有用的方法和属性，让你在历史记录中自由前进和后退，而在HTML5中，更可以操纵历史记录中的数据。   历史记录概览  可以通过back...
html5 input的type属性启动数字输入法
weistar103的专栏
03-18 312
当文本框只能输入数字是一个很常见的需求，比如电话号码，身份证号，卡号， 数量....等等只允许数字输入，为了更好的用户体验性，直接写出 启动数字键盘的需求，我和大多数人一样用   this.style.imeMode='disabled';  imeMode有四种形式，分别是： active 代表输入法为中文inactive 代表输入法为英文auto 代表打开输入法 (默认)disable ...
PhoneGap API中文手册：设备功能详解
"PhoneGap API中文手册提供了对PhoneGap框架各种功能的详细说明，包括设备的运动传感器、摄像头、媒体采集、方向、网络连接、联系人管理、设备信息、事件处理、文件系统、地理位置、音频处理、通知以及本地存储等。...
评论
添加红包

请填写红包祝福语或标题

个

红包个数最小为10个

元

红包金额最低5元

当前余额3.43元 前往充值 >
需支付：10.00元
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付元
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明：

1.余额是钱包充值的虚拟货币，按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载，可以购买VIP、付费专栏及课程。

余额充值