Thinkjs的控制器

（摘抄官方文档：https://thinkjs.org/zh-cn/doc/2.2/controller.html）

控制器

控制器是一类操作的集合，用来响应用户同一类的请求。

创建文件 src/home/controller/article.js，表示 home 模块下有名为 article 控制器，文件内容类似如下：

ES6 方式
'use strict';
import Base from './base.js';

export default class extends Base {
  /**
   * index action
   * @return {Promise} []
   */
  indexAction(){
    //auto render template file index_index.html
    return this.display();
  }
}

init 方法

ES6 里的 class 有 contructor 方法，但动态创建的类就没有该方法了，为了统一初始化执行的方法，将该方法统一定义为 init。

该方法在类实例化的时候自动调用，无需手工调用。

ES6 方式
'use strict';
import Base from './base.js';

export default class extends Base {
  init(http){
    super.init(http); //调用父类的init方法  
    ...
  }
}

init 方法里需要调用父类的 init 方法，并将参数 http 传递进去。

前置操作 __before

ThinkJS 支持前置操作，方法名为 __before，该方法会在具体的 Action 调用之前自动调用。如果前置操作里阻止了后续代码继续执行，则不会调用具体的 Action，这样可以提前结束请求。

ES6 方式
'use strict';
import Base from './base.js';

export default class extends Base {
  /**
   * 前置方法
   * @return {Promise} []
   */
  __before(){
    ...
  }
}

Action

一个 Action 代表一个要执行的操作。如： url 为 /home/article/detail，解析后的模块为 /home，控制器为 article， Action 为 detail，那么执行的 Action 就是文件 src/home/controller/aritcle 里的 detailAction 方法。

'use strict';
import Base from './base.js';

export default class extends Base {
  /**
   * 获取详细信息
   * @return {Promise} []
   */
  detailAction(self){
    ...
  }
}

如果解析后的 Action 值里含有 _，会自动做转化，具体的转化策略见路由 -> 大小写转化。

后置操作 __after

ThinkJS 支持后置操作，方法名为 __after，该方法会在具体的 Action 调用之后执行。如果具体的 Action 里阻止了后续的代码继续执行，则后置操作不会调用。

空操作 __call

当解析后的 url 对应的控制器存在，但 Action 不存在时，会试图调用控制器下的魔术方法 __call。这里可以对不存在的方法进行统一处理。

'use strict';
import Base from './base.js';

export default class extends Base {
  /**
   * @return {Promise} []
   */
  __call(){
    ...
  }
}

数据校验

控制器里在使用用户提交的数据之前，需要对数据合法性进行校验。为了降低控制器里的逻辑复杂度，ThinkJS 提供了一层 Logic 专门用来处理数据校验和权限校验等相关操作。
详细信息请见扩展功能 -> Logic -> 数据校验。

http 对象

控制器在实例化时，会将 http 传递进去。该 http 对象是 ThinkJS 对 req 和 res 重新包装的一个对象，而非 Node.js 内置的 http 对象。

Action 里如果想获取该对象，可以通过 this.http 来获取。

'use strict';

import Base from './base.js';

export default class extends Base {
  indexAction(){
    let http = this.http;
  }
}

关于 http对象包含的属性和方法请见 API -> http。

this 作用域的问题

Node.js 里经常有很多异步操作，而异步操作常见的处理方式是使用回调函数或者 Promise。这些处理方式都会增加一层作用域，导致在回调函数内无法直接使用 this，简单的处理办法是在顶部定义一个变量，将 this 赋值给这个变量，然后在回调函数内使用这个变量。如：

module.exports = think.controller({
  indexAction: function(){
    var self = this; //这里将 this 赋值给变量 self，然后在后面的回调函数里都使用 self
    this.model('user').find().then(function(data){
      return self.model('article').where({user_id: data.id}).select();
    }).then(function(data){
      self.success(data);
    })
  }
})

如果每个 Action 里都要使用者手工写一个 var self = this，势必比较麻烦。为了解决这个问题，ThinkJS 在 Action 里直接提供了一个参数，这个参数等同于 var self = this，具体如下：

module.exports = think.controller({
  //参数 self 等同于 var self = this
  indexAction: function(self){
    this.model('user').find().then(function(data){
      return self.model('article').where({user_id: data.id}).select();
    }).then(function(data){
      self.success(data);
    })
  }
})

JSON 输出

项目中经常要提供一些接口，这些接口一般都是直接输出 JSON 格式的数据，并且会有标识表明当前接口是否正常。如果发生异常，需要将对应的错误信息随着接口一起输出。控制器里提供了 this.success 和 this.fail 方法来输出这样的接口数据。

1.输出正常的 JSON

可以通过 this.success 方法输出正常的接口数据，如：

export default class extends think.controller.base {
  indexAction(){
    let data = {name: "thinkjs"};
    this.success(data);
  }
}

输出结果为 {errno: 0, errmsg: "", data: {"name": "thinkjs"}}，客户端可以通过 errno 是否为 0 来判断当前接口是否有异常。

2.输出含有错误信息的 JSON

可以通过 this.fail 方法输出含有错误信息的接口数据，如：

export default class extends think.controller.base {
  indexAction(){
    this.fail(1000, 'connect error'); //指定错误号和错误信息
  }
}

输出结果为 {errno: 1000, errmsg: "connect error"}，客户端判断 errno 大于 0，就知道当前接口有异常，并且通过 errmsg 拿到具体的错误信息。

3.配置错误号和错误信息

如果每个地方输出错误的时候都要指定错误号和错误信息势必比较麻烦，比较好的方式是把错误号和错误信息在一个地方配置，然后输出的时候只要指定错误号，错误信息根据错误号自动读取。

错误信息支持国际化，所以配置放在 src/common/config/locale/[lang].js 文件中。如：

export default {
  10001: 'get data error'
}

通过上面的配置后，执行 this.fail(10001) 时会自动读取到对应的错误信息。

4.友好的错误号

在程序里执行 this.fail(10001) 虽然能输出正确的错误号和错误信息，但人不能直观的看出来错误号对应的错误信息是什么。

这时可以将 key 配置为大写字符串，值为错误号和错误信息。如:

export default {
  GET_DATA_ERROR: [1234, 'get data error'] //key 必须为大写字符或者下划线才有效
}

执行 this.fail('GET_DATA_ERROR') 时也会自动取到对应的错误号和错误信息。

常用功能

1.获取 GET 参数

可以通过 get 方法获取 GET 参数，如：

export default class extends think.controller.base {
  indexAction(){
    let name = this.get("name");
    let allParams = this.get(); //获取所有 GET 参数
  }
}

如果参数不存在，那么值为空字符串。

2.获取 POST 参数

可以通过 post 方法获取 POST 参数，如：

export default class extends think.controller.base {
  indexAction(){
    let name = this.post('name');
    let allParams = this.post(); //获取所有 POST 参数
  }
}