Skip to content
体验新版
项目
组织
正在加载...
登录
切换导航
打开侧边栏
DCloud
unidocs-zh
提交
ea797a05
unidocs-zh
项目概览
DCloud
/
unidocs-zh
通知
3172
Star
105
Fork
804
代码
文件
提交
分支
Tags
贡献者
分支图
Diff
Issue
93
列表
看板
标记
里程碑
合并请求
67
DevOps
流水线
流水线任务
计划
Wiki
0
Wiki
分析
仓库
DevOps
项目成员
Pages
unidocs-zh
项目概览
项目概览
详情
发布
仓库
仓库
文件
提交
分支
标签
贡献者
分支图
比较
Issue
93
Issue
93
列表
看板
标记
里程碑
合并请求
67
合并请求
67
Pages
DevOps
DevOps
流水线
流水线任务
计划
分析
分析
仓库分析
DevOps
Wiki
0
Wiki
成员
成员
收起侧边栏
关闭侧边栏
动态
分支图
创建新Issue
流水线任务
提交
Issue看板
提交
ea797a05
编写于
12月 29, 2021
作者:
雪洛
浏览文件
操作
浏览文件
下载
电子邮件补丁
差异文件
docs: uniCloud clientDB
上级
fcb165d6
变更
2
展开全部
显示空白变更内容
内联
并排
Showing
2 changed file
with
48 addition
and
633 deletion
+48
-633
docs/uniCloud/clientdb.md
docs/uniCloud/clientdb.md
+48
-2
docs/uniCloud/uni-clientDB.md
docs/uniCloud/uni-clientDB.md
+0
-631
未找到文件。
docs/uniCloud/clientdb.md
浏览文件 @
ea797a05
...
...
@@ -16,7 +16,7 @@ JQL语法相关文档已移至:[JQL语法](uniCloud/jql.md)
在
`DB Schema`
中,配置数据操作的权限和字段值域校验规则,阻止前端不恰当的数据读写。详见:
[
DB Schema
](
https://uniapp.dcloud.net.cn/uniCloud/schema
)
如果想在数据库操作之前或之后需要在云端执行额外的动作(比如获取文章详情之后阅读量+1),
`clientDB`
提供了action云函数机制。在HBuilderX项目的
`cloudfunctions/uni-clientDB-actions`
目录编写上传js,参考:
[
action
](
uniCloud/
database
?id=action
)
如果想在数据库操作之前或之后需要在云端执行额外的动作(比如获取文章详情之后阅读量+1),
`clientDB`
提供了action云函数机制。在HBuilderX项目的
`cloudfunctions/uni-clientDB-actions`
目录编写上传js,参考:
[
action
](
uniCloud/
jql
?id=action
)
**注意**
...
...
@@ -59,7 +59,6 @@ JQL语法相关文档已移至:[JQL语法](uniCloud/jql.md)
js API可以执行所有数据库操作。
`<unicloud-db>`
组件是js API的再封装,进一步简化查询等常用数据库操作的代码量。
-
在HBuilderX 3.0+,
`<unicloud-db>`
组件已经内置,可以直接使用。文档另见:
[
`<unicloud-db>`组件
](
/uniCloud/unicloud-db
)
-
在HBuilderX 3.0以前的版本,使用该组件需要在插件市场单独引用
`<uni-clientDB>插件`
,另见:
[
https://ext.dcloud.net.cn/plugin?id=3256
](
https://ext.dcloud.net.cn/plugin?id=3256
)
以下文章重点介绍
`clientDB`
的js API。至于组件的用法,另见
[
文档
](
uniCloud/unicloud-db.md
)
。
...
...
@@ -116,6 +115,53 @@ db.collection('list')
-
更新数据时键值不可使用
`{'a.b.c': 1}`
的形式,需要写成
`{a:{b:{c:1}}}`
形式
## 客户端事件@event
### 刷新token@refreshtoken
透传uni-id自动刷新的token给客户端
> HBuilderX 3.2.11及以上版本,clientDB会自动将刷新的token及过期时间保存在storage内。
**用法**
```
js
const
db
=
uniCloud
.
database
()
function
refreshToken
({
token
,
tokenExpired
})
{
uni
.
setStorageSync
(
'
uni_id_token
'
,
token
)
uni
.
setStorageSync
(
'
uni_id_token_expired
'
,
tokenExpired
)
}
// 绑定刷新token事件
db
.
on
(
'
refreshToken
'
,
refreshToken
)
// 解绑刷新token事件
db
.
off
(
'
refreshToken
'
,
refreshToken
)
```
### 错误处理@error
全局clientDB错误事件,HBuilderX 3.0.0起支持。
**用法**
```
js
const
db
=
uniCloud
.
database
()
function
onDBError
({
code
,
// 错误码详见https://uniapp.dcloud.net.cn/uniCloud/clientdb?id=returnvalue
message
})
{
// 处理错误
}
// 绑定clientDB错误事件
db
.
on
(
'
error
'
,
onDBError
)
// 解绑clientDB错误事件
db
.
off
(
'
error
'
,
onDBError
)
```
## JQL语法@jql
clientDB使用JQL在客户端编写查询语句,关于JQL语法请参考:
[
JQL语法
](
uniCloud/jql.md
)
docs/uniCloud/uni-clientDB.md
已删除
100644 → 0
浏览文件 @
fcb165d6
此差异已折叠。
点击以展开。
编辑
预览
Markdown
is supported
0%
请重试
或
添加新附件
.
添加附件
取消
You are about to add
0
people
to the discussion. Proceed with caution.
先完成此消息的编辑!
取消
想要评论请
注册
或
登录