概述
db模塊封裝了(le)手機(jī)常用(yòng₩↑)數(shù)據庫sqlite的(de)增±π删改查語句，可(kě)實現(xiàn)數(shù)據的(de)本地(dì)®♥≤存儲，極大(dà)的(de)簡化(huà)了(l∞φ♦'e)數(shù)據持久化(huà)問(wèn)題
openDatabase
打開(kāi)數(shù)據庫，若數(shù)據庫不(bù)存在則創建 ≠✔數(shù)據庫。
數(shù)據庫打開(kāi)後即使當前頁面關閉了(le)，γ₽數(shù)據庫也(yě)不(bù)會(huì)關閉，除非手↑•動調用(yòng)closeDatabase()方法關閉，所以一€ ∑(yī)旦打開(kāi)在其它頁面就(jiù)可(kě)以直接使用☆¥¶(yòng)。
若數(shù)據庫放(fàng)在widget目錄下α≤δ•(xià)，那(nà)麽需要(yào)先把數( ÷λ₩shù)據庫拷貝到(dào)fs://對(duì)應目錄下(x↑ià)面再使用(yòng)
openDatabase({params}, callback(r×≤∑↓et, err))
params
name：
path：
- 類型：字符串
- 描述：（可(kě)選項）數(shù)據庫所在路(lù)徑，不(bù)傳時('¶shí)使用(yòng)默認創建的(de)路(lù)徑。支持fπ∏♦ s://、widget://等協議(yì)（如(rú±β)fs://user.db）
- 默認值：自(zì)動創建的(de)路(lù)<♠₩↔徑
callback(ret, err)
ret：
- 類型：JSON對(duì)象
- 內(nèi)部字段：
{ status:true //布爾類型；操作(zuò)成功狀态值，true|false }
err：
- 類型：JSON對(duì)象
- 內(nèi)部字段：
{ msg:"" //字符串類型；錯(cuò)誤描述 }
示例代碼
var db = api.require('db'); db.openDatabase({ name: 'test' }, function(ret, err){ if(ret.status){ api.aε<₩✘lert({msg:'數(shù)據庫打開(kāi)成功'}); }else{ api.alert({mε£sg:err.msg}); } });
可(kě)用(yòng)性
iOS系統，Android系統，PC模拟器(qì)
可(kě)提供的(de)1.0.0及更高(gāo)版本
closeDatabase
關閉數(shù)據庫
closeDatabase({params}, callbα♣ack(ret, err))
params
name：
callback(ret, err)
ret：
- 類型：JSON對(duì)象
- 內(nèi)部字段：
{ status:true //布爾類型；操作(zuò)成功狀态值，true|false }
err：
- 類型：JSON對(duì)象
- 內(nèi)部字段：
{ msg:"" //字符串類型；錯(cuò)誤描述 }
示例代碼
var db = api.require('db'); db.closeDatabase({ name:'test' }, function(ret, err){ if(ret.status){ api.alert({msg∏£:'關閉數(shù)據庫成功'}); }else{ api.alert({msg:'error'}); } });
可(kě)用(yòng)性
iOS系統，Android系統，PC模拟器(qì)
可(kě)提供的(de)1.0.0及更高(gāo)版本
transaction
執行(xíng)事(shì)務操作(zuò)語<∞句
transaction({params}, c₩™£allback(ret, err))
params
name：
operation：
- 類型：字符串
- 描述：事(shì)務操作(zuò)類型，取值範圍如(rú)下(xσ≈ià)：
- begin //開(kāi)始事(shì)務
- commit //提交事(shì)務
- rollback //回滾操作(zuò)
callback(ret, err)
ret：
- 類型：JSON對(duì)象
- 內(nèi)部字段：
{ status:true //布爾類型；操作(zuò)成功狀态值，true|false }
err：
- 類型：JSON對(duì)象
- 內(nèi)部字段：
{ msg:"" //字符串類型；錯(cuò)誤描述 }
示例代碼
var db = api.require('db'); db.transaction({ name: 'test', operation: 'begin' }, function(ret, err){ if(ret.status){ api.alert({®♠↔msg:'事(shì)務操作(zuò)成功'}); }else{ api.alert(σ≥{msg:err.msg}); } });
可(kě)用(yòng)性
iOS系統，Android系統，PC模拟器(qì)
可(kě)提供的(de)1.0.0及更高(gāo)≠♣版本
executeSql
執行(xíng)sql
executeSql({params}, callback(ret, err×£ ))
params
name：
sql：
callback(ret, err)
ret：
- 類型：JSON對(duì)象
- 內(nèi)部字段：
{ status:true //布爾類型；操作(zuò)成功狀态值，true|false }
err：
- 類型：JSON對(duì)象
- 內(nèi)部字段：
{ msg:"" //字符串類型；錯(cuò)誤描述 }
示例代碼
var db = api.require('db'); var sql = 'CREATE TABLE Persons(Id_P int, λδ₩£LastName varchar(255) ®, FirstName varchar(255), Add↔£ress varchar(255), City varchar(255₽↕β))'; db.executeSql({ name: 'test', sql: sql }, function(ret, err){ if(ret.status){ api.alert({msg<:'執行(xíng)SQL成功'}); }else{ api.alert({msg:err.msg})$←♥; } });
可(kě)用(yòng)性
iOS系統，Android系統，PC模拟器(qì)
可(kě)提供的(de)1.0.0及更高(gāo)版本
selectSql
查詢sql
selectSql({params}, callback(re§↕t, err))
params
name：
sql：
callback(ret, err)
ret：
- 類型：JSON對(duì)象
- 內(nèi)部字段：
{ status:true, //布爾類型；操作(zuò)成功狀态值，true|false data:[] //數(shù)組類型；查詢結果數(shù)據 }
err：
- 類型：JSON對(duì)象
- 內(nèi)部字段：
{ msg:"" //字符串類型；錯(cuò)誤描述 }
示例代碼
var db = api.require('db'); var sql = 'select * FROM Persons'; db.selectSql({ name:™§''test', sql: sql }, function(ret, err){ if(ret.status){ var data = ret.data; }else{ } });
可(kě)用(yòng)性
iOS系統，Android系統，PC模拟器(qì)
可(kě)提供的(de)1.0.0及更高(gāo)版本
