Skip to content
体验新版
项目
组织
正在加载...
登录
切换导航
打开侧边栏
2301_76266857
unidocs-zh
提交
ea797a05
U
unidocs-zh
项目概览
2301_76266857
/
unidocs-zh
与 Fork 源项目一致
Fork自
DCloud / unidocs-zh
通知
1
Star
0
Fork
0
代码
文件
提交
分支
Tags
贡献者
分支图
Diff
Issue
0
列表
看板
标记
里程碑
合并请求
0
DevOps
流水线
流水线任务
计划
Wiki
0
Wiki
分析
仓库
DevOps
项目成员
Pages
U
unidocs-zh
项目概览
项目概览
详情
发布
仓库
仓库
文件
提交
分支
标签
贡献者
分支图
比较
Issue
0
Issue
0
列表
看板
标记
里程碑
合并请求
0
合并请求
0
Pages
DevOps
DevOps
流水线
流水线任务
计划
分析
分析
仓库分析
DevOps
Wiki
0
Wiki
成员
成员
收起侧边栏
关闭侧边栏
动态
分支图
创建新Issue
流水线任务
提交
Issue看板
体验新版 GitCode,发现更多精彩内容 >>
提交
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.
先完成此消息的编辑!
取消
想要评论请
注册
或
登录