AppCan文档中心-uexDataBaseMgr
 
下载文档

uexDataBaseMgr
更新时间:2016-04-15

1、简介

数据库插件

1.1、说明

该对象主要封装了数据库的打开关闭,创建表,插入数据,查询数据,执行事务的接口

1.2、开源源码

插件测试用例与源码下载:点击 插件中心至插件详情页 (插件测试用例与插件源码已经提供)

2、API概览

2.1、方法

openDataBase 打开数据库

uexDataBaseMgr.openDataBase(dbName,id)

说明:

开数据库并得到数据库对象,同一id的数据库对象只能被打开一次。回调方法cbOpenDataBase

参数:

参数名称 参数类型 是否必选 说明
dbName String 数据库名称
id Number 唯一标识符

平台支持:

Android2.2+
iOS6.0+

版本支持:

3.0.0+

示例:

  1. uexDataBaseMgr.openDataBase("uexDB",1);

executeSql Sql语句的执行

uexDataBaseMgr.executeSql(dbName,id,sql)

说明:

Sql语句的执行,对数据库数据的增删改。回调方法cbExecuteSql

参数:

参数名称 参数类型 是否必选 说明
dbName String 数据库名称
id Number 唯一标识符
sql String 要执行的sql语句

平台支持:

Android2.2+
iOS6.0+

版本支持:

3.0.0+

示例:

  1. var sql = "CREATE TABLE testTable (_id INTEGER PRIMARY KEY,name TEXT)";
  2. uexDataBaseMgr.executeSql("uexDB",1,sql);

selectSql Sql语句的查询

uexDataBaseMgr.selectSql(dbName,id,sql)

说明:

Sql语句的查询,对数据库中数据的查询。回调方法cbSelectSql

参数:

参数名称 参数类型 是否必选 说明
dbName String 数据库名称
id Number 唯一标识符
sql String 要查询的sql语句

平台支持:

Android2.2+
iOS6.0+

版本支持:
3.0.0+

示例:

  1. var sql = "SELECT * FROM testTable";
  2. uexDataBaseMgr.selectSql("uexDB",1,sql);

transaction 事务的执行

uexDataBaseMgr.transaction(dbName,id,func)

说明:

事务的执行,回调方法cbTransaction

参数:

参数名称 参数类型 是否必选 说明
dbName String 数据库名称
id Number 唯一标识符
func Function 可选在事务中执行的函数

平台支持:

Android2.2+
iOS6.0+

版本支持:
3.0.0+

示例:

  1. uexDataBaseMgr.transaction("uexDB",1,inFunc);
  2. function inFunc(){
  3. var sql = "DELETE FROM testTable WHERE _id = 1";
  4. uexDataBaseMgr.executeSql(dbName,1,sql);
  5. }

closeDataBase 关闭数据库

uexDataBaseMgr.closeDataBase(dbName,id)

说明:
关闭数据库,回调方法cbCloseDataBase

参数:

参数名称 参数类型 是否必选 说明
dbName String 数据库名称
id Number 唯一标识符

平台支持:

Android2.2+
iOS6.0+

版本支持:

3.0.0+

示例:

  1. uexDataBaseMgr.closeDataBase("uexDB",1);

2.2、回调方法

cbOpenDataBase 打开数据库后的回调方法

uexDataBaseMgr.cbOpenDataBase(opId,dataType,data)

参数:

参数名称 参数类型 是否必选 说明
opId Number 数据库对象的唯一标识符
dataType Number 参数类型详见CONSTANT中Callback方法数据类型
data Number 返回uex.cSuccess或者uex.cFailed,详见CONSTANT中Callbackint类型数据

平台支持:

Android2.2+
iOS6.0+

版本支持:

3.0.0+

示例:

  1. uexDataBaseMgr.cbOpenDataBase = function(opId,dataType,data){
  2. if(data == 0){
  3. alert("数据库打开成功!");
  4. }else{
  5. alert("数据库打开失败!");
  6. }
  7. };

cbExecuteSql 执行Sql语句的回调方法

uexDataBaseMgr.cbExecuteSql(opId,dataType,data)

参数:

参数名称 参数类型 是否必选 说明
opId Number 数据库对象的唯一标识符
dataType Number 参数类型详见CONSTANT中Callback方法数据类型
data Number 返回uex.cSuccess或者uex.cFailed,详见CONSTANT中Callbackint类型数据

平台支持:

Android2.2+
iOS6.0+

版本支持:

3.0.0+

示例:

  1. uexDataBaseMgr.cbExecuteSql = function(opId,dataType,data){
  2. if(data == 0){
  3. alert("执行成功!");
  4. }else{
  5. alert("执行失败!");
  6. }
  7. };

cbSelectSql 查询Sql语句的回调方法

uexDataBaseMgr.cbSelectSql(opId,dataType,data)

参数:

参数名称 参数类型 是否必选 说明
opId Number 数据库对象的唯一标识符
dataType Number 参数类型详见CONSTANT中Callback方法数据类型
data Number 返回查询到的数据,json数据格式

平台支持:

Android2.2+
iOS6.0+

版本支持:

3.0.0+

示例:

  1. uexDataBaseMgr.cbSelectSql = function(opId,dataType,data){
  2. var jsonList=eval("("+data+")");
  3. if(jsonList.length == 0){
  4. alert("无数据");
  5. }
  6. for(var i=0;i<jsonList.length;i++){
  7.     for(var key in jsonList[i]){
  8.   alert("key:"+key+",value:"+jsonList[i][key]);
  9. }
  10. }
  11. };

cbTransaction 执行事务的回调方法

uexDataBaseMgr.cbTransaction(opId,dataType,data)

参数:

参数名称 参数类型 是否必选 说明
opId Number 数据库对象的唯一标识符
dataType Number 参数类型详见CONSTANT中Callback方法数据类型
data Number 返回uex.cSuccess或者uex.cFailed,详见CONSTANT中Callbackint类型数据

平台支持:

Android2.2+
iOS6.0+

版本支持:

3.0.0+

示例:

  1. uexDataBaseMgr.cbTransaction = function(opId,dataType,data){
  2. if(data == 0){
  3. alert("事务提交成功!");
  4. }else{
  5. alert("事务提交失败!");
  6. }
  7. };

cbCloseDataBase 关闭数据库后的回调方法

uexDataBaseMgr.cbCloseDataBase(opId,dataType,data)

参数:

参数名称 参数类型 是否必选 说明
opId Number 数据库对象的唯一标识符
dataType Number 参数类型详见CONSTANT中Callback方法数据类型
data Number 返回uex.cSuccess或者uex.cFailed,详见CONSTANT中Callbackint类型数据

平台支持:

Android2.2+
iOS6.0+

版本支持:

3.0.0+

示例:

  1. uexDataBaseMgr.cbCloseDataBase = function(opId,dataType,data){
  2. if(data == 0){
  3. alert("数据库关闭成功!");
  4. }else{
  5. alert("数据库关闭失败!");
  6. }
  7. };

3、更新历史

iOS

API版本:uexDataBaseMgr-3.0.4

最近更新时间:2015-12-26

历史发布版本 更新内容
3.0.4 添加IDE支持
3.0.3 重新解决uexDataBaseMgr插件IDE包创建表格失败的问题
3.0.2 解决uexDataBaseMgr插件IDE包创建表格失败的问题
3.0.1 使用新版Xcode重新编译,支持arm64
3.0.0 数据库功能插件

Android

API版本:uexDataBaseMgr-3.0.0

最近更新时间:2015-06-19

历史发布版本 更新内容
3.0.0 数据库功能插件