restql 学习三 查询语言简单说明

restql 中with 参数的内容在restql 中实际上就是http request 的请求内容。按照restql 的设计
method 分为 from (get) , to (post) ,into(put) ,update (patch), delete (delete), 实际开发中,好多
团队对于from (get) 的处理可能并不是按照 rest标准的处理,我们可能需要使用to 处理

to 格式说明

  • 格式
 
to users
  with
    id = "user.id"
    username = "user.name"
    password = "super.secret"

http post 格式

POST http://some.api/users/
BODY { "id": "user.id", "username": "user.name", "password": "super.secret"

wtih 参数的格式

with 支持简单数据类型以及复杂格式(json,数组扁平处理 )

  • 支持的数据类型
- 字符串,使用双引号
- 数字,可以是浮点类型 ,科学计数不支持
- 布尔类型,true,false
- 列表类型,使用中括号包含
- key/value 数据结构,类似json
- 从其他查询引用的值,使用引号以及`.`引用,类似json 字段引用

变量引用

我们可以方便的传递参数,

  • 格式如下
from superheroes
    with
        name = $heroName
        level = $heroLevel
        powers = $heroPowers
 

对应的http 请求为

localhost:9000/run-query?heroName="Superman"&heroLevel=99&heroPowers=["flight","heat vision","super strenght"]

展开以及扁平处理

使用展开以及扁平功能,我们我们方便的进行传递参数的处理

  • 参考扩展使用
from superheroes as party
    with
        id = [1, 2, 3]

http 请求格式

GET http://some.api/superhero?id=1
GET http://some.api/superhero?id=2
GET http://some.api/superhero?id=3
  • 参考扁平处理
    使用-> 会镜像进行转换
 
        from superheroes as fused
         with
          id = [1, 2, 3] -> flatten
 

http 格式

GET http://some.api/superhero?id=1&id=2&id=3

值编码

可以对于参数参数编码(比如base64,json)

  • 参考使用
from superheroes as hero
    with
        stats = {health: 100,
                 magic: 100} -> json // encode this value as a json string
from superheroes as hero
    with
        bag = {capacity: 10} -> base64
 
 

选择返回值

使用only 我们可能选择应用需要的数据

  • 参考格式
from superheroes as hero
    with
        id = 1
    only
        name
        items
        skills.id
        skills.name
        nicknames -> matches("^Super")

说明:
其中我们可以使用match 进行进一步的数据过滤

忽略错误

有时对于数据查询的错误我们可能不太感兴趣,我们可恶意使用忽略错误

  • 参考格式
 
from products as product
from ratings
  with
    productId = product.id
  ignore-errors

请求头处理

很多时候我们基于请求头进行api 的认证处理,restql 提供了请求头参数的处理

  • 参考格式
from superheroes as hero
headers
    Authorization = "Basic user:pass"
    Accept = "application/json"
with
    id = 1

超时控制

很多时候接口响应比较慢,我们可以通过设置超时时间

  • 参考格式
from superheroes as hero
headers
    Authorization = "Basic user:pass"
    Accept = "application/json"
timeout 200
with
    id = 1

cache 请求头控制

我们可以添加cache 请求头,方便proxy 对于请求资源的cache 处理

use max-age = 600
from products

请求头

 

 

参考资料

http://docs.restql.b2w.io/#/restql/query-language?id=expanding-and-flattening

posted on 2019-11-18 12:57  荣锋亮  阅读(339)  评论(0编辑  收藏  举报

导航