宜信同城网交流论坛技术专版技术专区SQLite模块用于操作本地数据库文件，可实现数据库文件的创建，执行SQL语句等功能 ...方法： openDatabase: 打开数据库isOpenDatabase: 判断数据库是否打开closeDatabase: 关闭数据库transac ...

admin 发表于 2023-2-16 18:54:47

SQLite模块用于操作本地数据库文件，可实现数据库文件的创建，执行SQL语句等功能 ...

<div id="article_content" class="article_content clearfix">
 <link rel="stylesheet" href="https://csdnimg.cn/release/blogv2/dist/mdeditor/css/editerView/kdoc_html_views-1a98987dfd.css">
 <link rel="stylesheet" href="https://csdnimg.cn/release/blogv2/dist/mdeditor/css/editerView/ck_htmledit_views-6e43165c0a.css">
 <div id="content_views" class="htmledit_views">
 <h2 style="margin-left:.8em;">方法：</h2>
<ul><li><ahref="https://blog.csdn.net/qq_40575646/article/details/122838235#plus.sqlite.openDatabase">openDatabase</a>: 打开数据库</li><li><ahref="https://blog.csdn.net/qq_40575646/article/details/122838235#plus.sqlite.isOpenDatabase">isOpenDatabase</a>: 判断数据库是否打开</li><li><ahref="https://blog.csdn.net/qq_40575646/article/details/122838235#plus.sqlite.closeDatabase">closeDatabase</a>: 关闭数据库</li><li><ahref="https://blog.csdn.net/qq_40575646/article/details/122838235#plus.sqlite.transaction">transaction</a>: 执行事务</li><li><ahref="https://blog.csdn.net/qq_40575646/article/details/122838235#plus.sqlite.executeSql">executeSql</a>: 执行增删改等操作的SQL语句</li><li><ahref="https://blog.csdn.net/qq_40575646/article/details/122838235#plus.sqlite.selectSql">selectSql</a>: 执行查询的SQL语句</li></ul>
<h2 style="margin-left:.8em;">回调方法：</h2>
<ul><li><ahref="https://www.html5plus.org/doc/zh_cn/sqlite.html#plus.sqlite.SQLiteSuccessCallback">SQLiteSuccessCallback</a>: SQLite操作成功回调函数</li><li><ahref="https://www.html5plus.org/doc/zh_cn/sqlite.html#plus.sqlite.SQLiteFailCallback">SQLiteFailCallback</a>: SQLite操作失败回调函数</li></ul>
<h2 style="margin-left:.8em;">权限：</h2>
5+功能模块（permissions）
<pre class="has" style="margin-left:0;"><code class="language-prettyprint"><code>
{
// ...
"permissions":{
// ...
"SQLite": {
"description": "SQLite数据库"
}
}
}
</code></code></pre>
<h1 style="margin-left:0;">openDatabase</h1>
打开数据库
<pre class="has" style="margin-left:0;"><code class="language-prettyprint"><code>
void plus.sqlite.openDatabase(options);
</code></code></pre>
<h2 style="margin-left:.8em;">说明：</h2>
如果数据库存在则打开，不存在则创建。
<h2 style="margin-left:.8em;">参数：</h2>
options参数为json类型，包含以下属性：
<ul><li>name: ( String ) 必选 数据库名称 </li><li>path: ( String ) 必选 数据库路径 必须为本地地址，支持以下类型路径： 5+ API路径(<ahref="https://www.html5plus.org/doc/zh_cn/io.html#plus.io.RelativeURL">RelativeURL</a>) - 以"_"开头的相对路径，如"_doc/a.db"（推荐使用"_doc/x.db"目录保存）； 相对路径 - 相对于当前页面的host位置，如"a.db"（不推荐使用，相对路径无法写入数据，只能读取数据）； 绝对路径 - 系统绝对路径，如Android平台"/sdcard/a.db"，此类路径通常通过其它5+ API获取的（不推荐使用，无法跨平台）； 本地路径URL - 以“file://”开头，后面跟随系统绝对路径。注意：写入数据需符合系统沙盒权限机制，应用资源目录（_www）目录通常不允许写操作，只能读取。 </li><li>success: ( <ahref="https://www.html5plus.org/doc/zh_cn/sqlite.html#plus.sqlite.SQLiteSuccessCallback">SQLiteSuccessCallback</a> ) 可选 打开数据库成功回调函数 回调函数无返回参数。 </li><li>fail: ( <ahref="https://www.html5plus.org/doc/zh_cn/sqlite.html#plus.sqlite.SQLiteFailCallback">SQLiteFailCallback</a> ) 可选 打开数据库失败回调函数 </li></ul>
<h2 style="margin-left:.8em;">返回值：</h2>
void : 无
<h2 style="margin-left:.8em;">示例：</h2>
<pre class="has" style="margin-left:0;"><code class="language-prettyprint"><code>
// 打开数据库
function openDB(){
plus.sqlite.openDatabase({
name: 'first',
path: '_doc/test.db',
success: function(e){
console.log('openDatabase success!');
},
fail: function(e){
console.log('openDatabase failed: '+JSON.stringify(e));
}
});
}
</code></code></pre>
<ahref="https://uniapp.dcloud.io/use-html5plus">uni-app使用plus注意事项</a>
<h1 style="margin-left:0;">isOpenDatabase</h1>
判断数据库是否打开
<pre class="has" style="margin-left:0;"><code class="language-prettyprint"><code>
Boolean plus.sqlite.isOpenDatabase(options);
</code></code></pre>
<h2 style="margin-left:.8em;">说明：</h2>
数据库已经打开则返回true，数据库没有打开则返回false。 HBuilderX1.9.0及以上版本支持。
<h2 style="margin-left:.8em;">参数：</h2>
options参数为json类型，包含以下属性：
<ul><li>name: ( String ) 必选 数据库名称 </li><li>path: ( String ) 必选 数据库路径 必须为本地地址，支持以下类型路径： 5+ API路径(<ahref="https://www.html5plus.org/doc/zh_cn/io.html#plus.io.RelativeURL">RelativeURL</a>) - 以"_"开头的相对路径，如"_doc/a.db"（推荐使用"_doc/x.db"目录保存）； 相对路径 - 相对于当前页面的host位置，如"a.db"（不推荐使用，相对路径无法写入数据，只能读取数据）； 绝对路径 - 系统绝对路径，如Android平台"/sdcard/a.db"，此类路径通常通过其它5+ API获取的（不推荐使用，无法跨平台）； 本地路径URL - 以“file://”开头，后面跟随系统绝对路径。注意：写入数据需符合系统沙盒权限机制，应用资源目录（_www）目录通常不允许写操作，只能读取。 </li></ul>
<h2 style="margin-left:.8em;">返回值：</h2>
Boolean : true表示数据库已打开，false表示数据库没有打开。
<h1 style="margin-left:0;">closeDatabase</h1>
关闭数据库
<pre class="has" style="margin-left:0;"><code class="language-prettyprint"><code>
void plus.sqlite.closeDatabase(options);
</code></code></pre>
<h2 style="margin-left:.8em;">说明：</h2>
完成数据库操作后，必须关闭数据库，否则可能会导致系统资源无法释放。
<h2 style="margin-left:.8em;">参数：</h2>
options参数为json类型，包含以下属性：
<ul><li>name: ( String ) 必选 数据库名称 </li><li>success: ( <ahref="https://www.html5plus.org/doc/zh_cn/sqlite.html#plus.sqlite.SQLiteSuccessCallback">SQLiteSuccessCallback</a> ) 可选 关闭数据库成功回调函数 回调函数无返回参数。 </li><li>fail: ( <ahref="https://www.html5plus.org/doc/zh_cn/sqlite.html#plus.sqlite.SQLiteFailCallback">SQLiteFailCallback</a> ) 可选 关闭数据库失败回调函数 </li></ul>
<h2 style="margin-left:.8em;">返回值：</h2>
void : 无
<h2 style="margin-left:.8em;">示例：</h2>
<pre class="has" style="margin-left:0;"><code class="language-prettyprint"><code>
// 关闭数据库
function closeDB(){
plus.sqlite.closeDatabase({
name: 'first',
success: function(e){
console.log('closeDatabase success!');
},
fail: function(e){
console.log('closeDatabase failed: '+JSON.stringify(e));
}
});
}
</code></code></pre>
<ahref="https://uniapp.dcloud.io/use-html5plus">uni-app使用plus注意事项</a>
<h1 style="margin-left:0;">transaction</h1>
执行事务
<pre class="has" style="margin-left:0;"><code class="language-prettyprint"><code>
void plus.sqlite.transaction(options);
</code></code></pre>
<h2 style="margin-left:.8em;">参数：</h2>
options参数为json类型，包含以下属性：
<ul><li>name: ( String ) 必选 数据库名称 </li><li>operation: ( String ) 必选 需要执行的事务操作 可选值：begin（开始事务）、commit（提交）、rollback（回滚）。 </li><li>success: ( <ahref="https://www.html5plus.org/doc/zh_cn/sqlite.html#plus.sqlite.SQLiteSuccessCallback">SQLiteSuccessCallback</a> ) 可选 执行事务成功回调函数 回调函数无返回参数。 </li><li>fail: ( <ahref="https://www.html5plus.org/doc/zh_cn/sqlite.html#plus.sqlite.SQLiteFailCallback">SQLiteFailCallback</a> ) 可选 执行事务失败回调函数 </li></ul>
<h2 style="margin-left:.8em;">返回值：</h2>
void : 无
<h2 style="margin-left:.8em;">示例：</h2>
<pre class="has" style="margin-left:0;"><code class="language-prettyprint"><code>
// 执行事务
function transactionDB(){
plus.sqlite.transaction({
name: 'first',
operation: 'begin',
success: function(e){
console.log('transaction success!');
},
fail: function(e){
console.log('transaction failed: '+JSON.stringify(e));
}
});
}
</code></code></pre>
<ahref="https://uniapp.dcloud.io/use-html5plus">uni-app使用plus注意事项</a>
<h1 style="margin-left:0;">executeSql</h1>
执行增删改等操作的SQL语句
<pre class="has" style="margin-left:0;"><code class="language-prettyprint"><code>
void plus.sqlite.executeSql(options);
</code></code></pre>
<h2 style="margin-left:.8em;">参数：</h2>
options参数为json类型，包含以下属性：
<ul><li>name: ( String ) 必选 数据库名称 </li><li>sql: ( Array | String ) 必选 需要执行的SQL语句 参数为字符串时，表示执行单条SQL语句； 参数为字符串数组时（HBuilderX2.5.5+支持），表示执行多条SQL语句，按数组顺序执行，某条SQL语句执行错误则终止。注意：Android平台不支持SQL语句中使用“;”分割多条命令，要运行多条命令请使用字符串数组参数。 </li><li>success: ( <ahref="https://www.html5plus.org/doc/zh_cn/sqlite.html#plus.sqlite.SQLiteSuccessCallback">SQLiteSuccessCallback</a> ) 可选 执行SQL语句成功回调函数 回调函数无返回参数。 </li><li>fail: ( <ahref="https://www.html5plus.org/doc/zh_cn/sqlite.html#plus.sqlite.SQLiteFailCallback">SQLiteFailCallback</a> ) 可选 执行SQL语句失败回调函数 </li></ul>
<h2 style="margin-left:.8em;">返回值：</h2>
void : 无
<h2 style="margin-left:.8em;">示例：</h2>
<pre class="has" style="margin-left:0;"><code class="language-prettyprint"><code>
// 执行SQL语句
function executeSQL(){
plus.sqlite.executeSql({
name: 'first',
sql: 'create table if not exists database("where" CHAR(110),"location" CHAR(100),"age" INT(11))',
success: function(e){
console.log('executeSql success!');
plus.sqlite.executeSql({
name: 'first',
sql: "insert into database values('北京','安乐林','11')",
success: function(e){
console.log('executeSql success!');
},
fail: function(e){
console.log('executeSql failed: '+JSON.stringify(e));
}
});
},
fail: function(e){
console.log('executeSql failed: '+JSON.stringify(e));
}
});
}
</code></code></pre>
<ahref="https://uniapp.dcloud.io/use-html5plus">uni-app使用plus注意事项</a>
<h1 style="margin-left:0;">selectSql</h1>
执行查询的SQL语句
<pre class="has" style="margin-left:0;"><code class="language-prettyprint"><code>
void plus.sqlite.selectSql(options);
</code></code></pre>
<h2 style="margin-left:.8em;">参数：</h2>
options参数为json类型，包含以下属性：
<ul><li>name: ( String ) 必选 数据库名称 </li><li>sql: ( String ) 必选 需要查询的SQL语句 </li><li>success: ( <ahref="https://blog.csdn.net/qq_40575646/article/details/122838235#plus.sqlite.SQLiteSuccessCallback">SQLiteSuccessCallback</a> ) 可选 执行SQL语句成功回调函数 回调函数返回参数为JSON对象数组，其中JSON对象为查询的结果。如果未查询到数据则返回参数为空数组。 </li><li>fail: ( <ahref="https://blog.csdn.net/qq_40575646/article/details/122838235#plus.sqlite.SQLiteFailCallback">SQLiteFailCallback</a> ) 可选 执行SQL语句失败回调函数 </li></ul>
<h2 style="margin-left:.8em;">返回值：</h2>
void : 无
<h2 style="margin-left:.8em;">示例：</h2>
<pre class="has" style="margin-left:0;"><code class="language-prettyprint"><code>
// 查询SQL语句
function selectSQL(){
plus.sqlite.selectSql({
name: 'first',
sql: 'select * from database',
success: function(data){
console.log('selectSql success: ');
for(var i in data){
console.log(data[i]);
}
},
fail: function(e){
console.log('selectSql failed: '+JSON.stringify(e));
}
});
}
</code></code></pre>
<ahref="https://uniapp.dcloud.io/use-html5plus">uni-app使用plus注意事项</a>
<h1 style="margin-left:0;">SQLiteSuccessCallback</h1>
SQLite操作成功回调函数
<pre class="has" style="margin-left:0;"><code class="language-prettyprint"><code>
void onSuccess(event){
}
</code></code></pre>
<h2 style="margin-left:.8em;">说明：</h2>
不同接口触发的成功回调参数event包含的属性存在差异，具体参考对应的接口描述说明。
<h2 style="margin-left:.8em;">参数：</h2>
<ul><li>event: ( Object ) 必选 回调参数 回调函数参数包含的属性由调用接口决定，具体参考对应的接口描述说明。 </li></ul>
<h2 style="margin-left:.8em;">返回值：</h2>
void : 无
<h1 style="margin-left:0;">SQLiteFailCallback</h1>
SQLite操作失败回调函数
<pre class="has" style="margin-left:0;"><code class="language-prettyprint"><code>
function void onFail(Exception error){
// Handle error
var code = error.code; // 错误编码
var message = error.message; // 错误描述信息
}
</code></code></pre>
<h2 style="margin-left:.8em;">参数：</h2>
<ul><li>error: ( Exception ) 必选 回调参数，错误信息 可通过error.code（Number类型）获取错误码； 可通过error.message（String类型）获取错误描述信息。完整错误码列表参考：<ahref="https://ask.dcloud.net.cn/article/282">5+API错误代码</a>中的“Sqlite模块错误”章节。 </li></ul>
<h2 style="margin-left:.8em;">返回值：</h2>
void : 无
 </div>
 </div>
 <div id="treeSkill"></div>

页: [1]

宜信同城网交流论坛's Archiver

SQLite模块用于操作本地数据库文件，可实现数据库文件的创建，执行SQL语句等功能 ...