Restful

ThinkJS 可以非常方便的支持 Restful 类的接口,假如现在有个名为 article 的 Resource 想提供 Restful 接口,可以通过下面的方式进行。

关于 Restful 的介绍可以见这里 http://www.ruanyifeng.com/blog/2011/09/restful.html

配置路由

Restful 类的接口需要借助自定义路由来使用,可以在路由配置文件中 Conf/route.js 配置如下的规则:

module.exports = [
  [/(article)(?:\/(\d*))?/, 'restful']
]

这个规则表示:

  • /article/article/10 类的接口标记为 Restful 接口
  • 需要对资源 articleid 使用正则分组功能,方便后续能够取到对应的值

建立对应的资源数据表

在数据库中添加对应的资源数据表 think_article,其中 think_ 为数据表前缀,需要改为实际项目中的数据表前缀。

添加相关的字段和添加数据。

访问 Restful 接口

有对应的资源数据表后,无需添加任何的 Controller 文件,即可通过下面的地址访问:

  • GET /article 获取所有的 article 列表
  • GET /article/10 获取 id 为 10 的 article 详细信息
  • POST /article 添加一个 article
  • PUT /article/10 更新 id 为 10 的 article 数据
  • DELETE /article/10 删除 id 为 10 的 article 数据

定制 Restful 接口

上面的方式虽然无需写任何 Controller 文件即可访问 article 资源,但有时候我们希望加一些限制,如:有些字段不输出,权限控制等功能,那么可以通过自定义 Controller 来进行。

Controller 文件

创建 App/Lib/Controller/Restful/ArticleController.js 文件,并使用如下的内容:

module.exports = Controller('RestController', {})
  • Restful 默认的分组是 Restful,可以通过配置 C('restful_group') 来修改
  • Restful 类的 Controller 需要继承自 RestController

限制部分字段

如果有些字段不想输出,那么可以通过下面的方式来隐藏:

module.exports = Controller('RestController', {
  __before: function(){
    this.model.field('content', true);
  }
})

这里表示不输出 content 字段。

实际上这里的 this.model 即为 D('article'),这样不仅可以限制字段,也可以限制条数,还可以分页。

权限控制

如果需要进行权限校验,那么也可以在 __before 里进行,如:

module.exports = Controller('RestController', {
  __before: function(){
      if(!this.hasPermission()){
        return this.error('no permission');
      }
    }
})

接口对应

请求类型 GET, POST, PUT, DELETE 对应的 Action 为 getAction, postAction, putAction, deleteAction。如果还需要进行更强的定制,可以重写这几个方法。

getAction 的实现为:

getAction: function(){
  var self = this;
  if (this.id) {
    return getPromise(this.model.getPk()).then(function(pk){
      return self.model.where(getObject(pk, self.id)).find();
    }).then(function(data){
      return self.success(data);
    }).catch(function(err){
      return self.error(err.message);
    })
  }
  return this.model.select().then(function(data){
    return self.success(data);
  }).catch(function(err){
    return self.error(err.message);
  });
},
如发现文档中的错误,请点击这里修改本文档,修改完成后请 pull request,我们会尽快合并、更新。