orql是Object Relational Query Language的缩写,是一种用于关系查询的dsl,结构与json类似,{}为object类型,[]为array类型。支持查询条件和排序等高级操作。
op root(exp order) : [column, object(exp): {}, array(exp): []]
- op 操作 支持query add update delete count
- root 根对象名,即需要操作的对象名
- exp 表达式,支持&& ||逻辑操作和列与列直接比较操作
- order 排序,支持声明多个排序,order id desc, name createAt asc, updateAt,默认为asc.
- object 关联的object对象,使用{...}来声明需要的属性.
- array 关联的array对象,使用[...]来声明需要的属性.
使用id查询用户并返回用户名
query user(id = $id) : {name}
查询全部用户返回用户名
query user : [name]
使用手机和密码或者邮箱和密码查询用户并返回用户id和用户名
query user(phone = $phone && password = $password || email = $email && password = $password) : {id, name}
exp支持比较column与column或者值或者参数和exp使用&&和||来进行比较。
array和object可以不查询数据,只使用表达式来进行筛选,在父对象中也可以使用外键直接查询,避免与子对象join关联.
外键查询
query user(roleId = $roldId)
bool false true
null null
string 'string' "string"
number 1 0.1
order by id asc
query user(order id)
order by id desc id name asc
query user(order id desc, id name)
查询后返回的字段,只要在schema中已经声明的关系,就可以一直获取下去.用{}表示一个object,用[]表示一个array.
获取用户的姓名、用户角色名、用户的文章标题和该文章的标签.
query user : {name, role : {name}, posts : [title, tags : [name]]}
items中可以使用*来表示获取全部的字段，不包括关联属性，使用!来表示排除掉某字段.
获取用户除密码外全部属性.
query user : {*, !password}
object在orql中表示一个对象,在筛选数据时关联schema不一定需要返回值,即object(exp)后面没有带相关的items.如无数据,返回为undefined对象.
array在orql中表示一个数组,如无数据返回为空数组.
count操作用于获取数量.
查询全部用户数量.
count user
查询帖子中有某个关键词的数量.
count post(title like $keyword)
查询角色名为admin的用户数量.
count user : [role(name = 'admin')]
add用于插入数据,关联关系中只能插入belongsTo的关系.关联schema插入时使用其包含id的对象.如主键设置为自增,插入后会返回自增的主键值.
// 插入用户姓名、手机和角色
// {name: 'name', phone: '123456', role : {id: 1}}
add user : {name, phone, role}
// 插入用户出id外其他属性
add user : {*, !id}
update用于修改数据,同add关联关系中也只能修改belongsTo的关系。
// 修改特定id的用户名
update user(id = $id) : {name}
// 修改特定id的用户角色
update user(id = $id) : {role}
delete用于删除数据,因为安全问题,在delete的orql中必须有exp,如果没有则报错.
// 删除特定id的用户
delete user(id = $id)