diff --git a/docs/uniCloud/uni-clientDB.md b/docs/uniCloud/uni-clientDB.md index 132b178c72b2abea51906d86da3d7107d01a81bd..1707c3be6f4e8ff80f08ed7d6a8f3ee89537127c 100644 --- a/docs/uniCloud/uni-clientDB.md +++ b/docs/uniCloud/uni-clientDB.md @@ -146,6 +146,55 @@ clientDB目前内置了3个变量可以供客户端使用,客户端并非直 使用这些变量,将可以避免过去在服务端代码中写代码获取用户uid、时间和客户端ip的麻烦。 +### 查询条件扩展@jsquery + +自uni-clientDB 2.0.5版本起,支持使用类js语法进行查询条件的编写。具体看以下示例 + +```js +import db from '@/js_sdk/uni-clientDB/index.js' +const dbCmd = db.command + +// 上面的示例中的where条件可以使用以下写法 +db.action('get-info') // 不使用action时可以不调用action方法 + .collection('list') + .where('/龚/g.test(name) && time > 1105885393581') + .field({ + name: true, + time: true, + content: true + }).get() + .then((res)=>{ + // res 为数据库查询结果 + }).catch((err)=>{ + + }) +``` + +**条件内可以使用的变量** + +|变量名 |说明 | +|:-: |:-: | +|auth.uid |用户id | +|auth.role |用户角色数组,参考[uni-id 角色权限](/uniCloud/uni-id?id=rbac),注意`admin`为clientDB内置的角色,如果用户角色列表里包含`admin`则认为此用户有完全数据访问权限| +|auth.permission|用户权限数组,参考[uni-id 角色权限](/uniCloud/uni-id?id=rbac) | +|now |当前时间戳(单位:毫秒),时间戳可以进行额外运算,如publish\_date > now - 60000表示publish\_date在最近一分钟 | + + +**条件语句内可以使用的运算符** + +|运算符 |说明 |示例 |示例解释(集合查询) | +|:-: |:-: |:-: |:-: | +|== |等于 |name == 'abc' |查询name属性为abc的记录 | +|!= |不等于 |name != 'abc' |查询name属性不为abc的记录 | +|> |大于 |age>10 |查询条件的 age 属性大于 10 | +|>= |大于等于 |age>=10 |查询条件的 age 属性大于等于 10 | +|< |小于 |age<10 |查询条件的 age 属性小于 10 | +|<= |小于等于 |age<=10 |查询条件的 age 属性小于等于 10 | +|in |存在在数组中 |status in ['a','b'] |查询条件的 status 是['a','b']中的一个,数组中所有元素类型需一致 | +|! |非 |!(status in ['a','b']) |查询条件的 status 不是['a','b']中的任何一个,数组中所有元素类型需一致| +|&& |与 |uid == auth.uid && age > 10 |查询记录uid属性 为 当前用户uid 并且查询条件的 age 属性大于 10 | +||| |或 |uid == auth.uid||age>10|查询记录uid属性 为 当前用户uid 或者查询条件的 age 属性大于 10 | + ### 刷新token 透传uni-id自动刷新的token给客户端 @@ -328,18 +377,18 @@ db-permission为对数据的操作权限,如果要封装业务权限,可以 **权限规则内可以使用的运算符** -|运算符 |说明 |示例 |示例解释(集合查询) | -|:-: |:-: |:-: |:-: | -|== |等于 |auth.uid == 'abc' |用户id为abc | -|!= |不等于 |auth.uid != 'abc' |用户id不为abc | -|> |大于 |doc.age>10 |查询条件的 age 属性大于 10 | -|>= |大于等于 |doc.age>=10 |查询条件的 age 属性大于等于 10 | -|< |小于 |doc.age<10 |查询条件的 age 属性小于 10 | -|<= |小于等于 |doc.age<=10 |查询条件的 age 属性小于等于 10 | -|in |存在在数组中 |doc.status in ['a','b'] |查询条件的 status 是['a','b']中的一个,数组中所有元素类型需一致 | -|nin |不存在在数组中 |doc.status nin ['a','b'] |查询条件的 status 不是['a','b']中的任何一个,数组中所有元素类型需一致 | -|&& |与 |auth.uid == 'abc' && doc.age>10 |用户id 为 abc 并且查询条件的 age 属性大于 10| -||||或 |auth.uid == 'abc'||doc.age>10 |用户Id为abc或者查询条件的 age 属性大于 10| +|运算符 |说明 |示例 |示例解释(集合查询) | +|:-: |:-: |:-: |:-: | +|== |等于 |auth.uid == 'abc' |用户id为abc | +|!= |不等于 |auth.uid != 'abc' |用户id不为abc | +|> |大于 |doc.age>10 |查询条件的 age 属性大于 10 | +|>= |大于等于 |doc.age>=10 |查询条件的 age 属性大于等于 10 | +|< |小于 |doc.age<10 |查询条件的 age 属性小于 10 | +|<= |小于等于 |doc.age<=10 |查询条件的 age 属性小于等于 10 | +|in |存在在数组中 |doc.status in ['a','b'] |查询条件的 status 是['a','b']中的一个,数组中所有元素类型需一致 | +|! |非 `2.0.5+` |!(doc.status in ['a','b']) |查询条件的 status 不是['a','b']中的任何一个,数组中所有元素类型需一致| +|&& |与 |auth.uid == 'abc' && doc.age>10 |用户id 为 abc 并且查询条件的 age 属性大于 10 | +||| |或 |auth.uid == 'abc'||doc.age>10|用户Id为abc或者查询条件的 age 属性大于 10 | **权限规则内可以使用的方法**