adonis-rest - 基于AdonisJs的Restful API基础构件
发布于 7 年前 作者 wxs77577 3132 次浏览 来自 分享

adonis-rest

基于AdonisJs的Restful API基础构件， AdonisJs中文网： https://adonis-china.org

https://github.com/wxs77577/adonis-rest

file

安装

  1. cnpm install --save adonis-rest

准备

Tips: 请确保你的/app/Model/目录里有一些模型文件. 如果没有的话可以用 ./ace make:model News 来创建一个新闻模型

/app/Http/routes.js

Route.put('/api/:resource', 'RestController.update') //可选
Route.resource('/api/:resource', 'RestController')

Create /app/Http/Controllers/RestController.js

'use strict'

const BaseRestController = require('adonis-rest')

class RestController  extends BaseRestController{

}

module.exports = RestController

就这样，所有模型的Restful接口就可以访问了。

文档

Base uri: http://localhost:3333/api

请求方法 URL 描述
GET /news 获取新闻列表
POST /news 获取一条新闻
PUT/PATCH /news/:id 修改一条新闻
DELETE /news/:id 删除一条新闻

GET /news

获取所有新闻

URL查询参数

参数名 示例值 描述
pagination 1 获取包含分页信息的数据，否则获取扁平数组，不过你仍然可以通过headers来获取分页信息
query {“user_id”: 1} 查询条件，也可以用 filter 或 where
page 1 当前页
perPage 10 每页显示数量，也可以用 limit
offset 10 跳过数量，也可以用 skip
fields id,title,created_at select的字段
orderBy id 排序，可以用-id表示desc（降序）

Headers中的分页信息字段

  • X-Pagination-Total-Count
  • X-Pagination-Page-Count
  • X-Pagination-Current-Page
  • X-Pagination-Per-Page

query字段的格式

  • query={"created_at": "2017-07-07"}
  • query={"created_at": [">", "2017-07-07"]} 或 <,<> 等等
  • query={"created_at": ["between", ["2017-07-01", "2017-07-31"]]} 或 notBetween
  • query={"user_id": ["in", [1,2,3] ]} 或 notIn
  • query={"user_id": ["raw", 'user_id IS NULL' ]}

有问题?

在Issues里面告诉我

回到顶部