http

这里的 http 对象并不是 Node.js 里的 http 模块,而是对 request 和 response 对象包装后一个新的对象。

var http = require('http');

http.createServer(function (request, response) {
  response.writeHead(200, {'Content-Type': 'text/plain'});
  response.end('Hello World\n');
}).listen(8124);

如上面的代码所示,Node.js 创建服务时,会传递 request 和 response 2个对象给回调函数。为了后续调用方便, ThinkJS 对这2个对象进行了包装,包装成了 http 对象,并且提供很多有用的方法。

http 对象会在 middleware, logic, controller, view 中传递。

:http 对象是 EventEmitter 的一个实例,所以可以对其进行事件监听和执行。

属性

http.req

系统原生的 request 对象

http.res

系统原生的 response 对象

http.startTime

请求的开始时间,是个unix时间戳。

http.url

当前请求的 url 。

http.version

当前请求的 http 版本。

http.method

当前请求的类型。

http.headers

当前请求的所有头信息。

http.pathname

当前请求的 pathname,路由识别会依赖该值,会在后续的处理中对其进行改变。所以在 action 拿到值可能跟初始解析出来的值不一致。

http.query

当前请求的所有 query 数据。

http.host

当前请求的 host, 包含端口。

http.hostname

当前请求的 hostname,不包含端口。

http.payload

当前请求的 payload 数据,提交型的请求才含有该值。

:该属性后续会废弃,建议使用 http.getPayload 方法。

http._get

存放 GET 参数值。

http._post

存放 POST 参数值

http._file

存放上传的文件数据

http._cookie

存放 cookie 数据。

http.module

当前请求解析后对应的模块名。

http.controller

当前请求解析后对应的控制器名。

http.action

当前请求解析后对应的操作名。

方法

http.getPayload()

  • return {Promise} payload 内容

获取 payload。

http.config(name)

  • name {String} 参数名
  • return {Mixed} 返回对应的参数值

获取当前请求下对应的参数值。

http.referrer()

  • return {String} 请求的 referrer

返回当前请求的 referrer。

http.userAgent()

  • return {String} 请求的 userAgent

返回当前请求的 userAgent。

http.isGet()

  • return {Boolean}

返回当前请求是否是 GET 请求。

http.isPost()

  • return {Boolean}

返回当前请求是否是 POST 请求。

http.isAjax(method)

  • method {String} 请求类型
  • return {Boolean}

返回当前请求是否是 Ajax 请求。

http.isAjax(); //判断是否是Ajax请求
http.isAjax('GET'); //判断是否是Ajax请求,且请求类型是GET

http.isJsonp(name)

  • name {String} callback 参数名称,默认为 callback
  • return {Boolean}

返回当前请求是否是 jsonp 请求。

//url is  /index/test?callback=testxxx
http.isJsonp(); //true
http.isJsonp('cb'); //false

http.get(name, value)

  • name {String} 参数名称
  • value {Mixed} 参数值

获取或者设置 GET 参数值。可以通过该方法设置 GET 参数值,方便后续的逻辑里获取。

// url is /index/test?name=thinkjs
http.get('name'); // returns 'thinkjs'
http.get('name', 'other value');
http.get('name'); // returns 'other value'

http.post(name, value)

  • name {String} 参数名称
  • value {Mixed} 参数值

获取或者设置 POST 值。可以通过该方法设置 POST 值,方便后续的逻辑里获取。

http.post('email'); //获取提交的email

http.param(name)

  • name {String} 参数名称
  • return {Mixed}

获取参数值,优先从 POST 里获取,如果值为空,则从 URL 参数里获取。

http.file(name)

  • name {String} 文件对应的字段名称
  • return {Object}

获取上传的文件。

http.file('image');
//returns 
{
  fieldName: 'image', //表单里的字段名
  originalFilename: filename, //原始文件名
  path: filepath, //文件临时存放的路径
  size: size //文件大小
}

http.header(name, value)

  • name {String} header 名称
  • value {String} header 值

获取或者设置 header 信息。

http.header('accept'); //获取accept
http.header('X-NAME', 'thinkjs'); //设置header

http.expires(time)

  • time {Number} 过期时间,单位为秒

强缓存,设置 Cache-ControlExpires 头信息。

http.header(86400); //设置过期时间为 1 天。

http.status(status)

设置状态码。如果头信息已经发送,则无法设置状态码。

http.status(400); //设置状态码为400

http.ip()

获取用户的 ip 。如果使用了代理,获取的值可能不准。

http.lang(lang, asViewPath)

  • lang {String} 要设置的语言
  • asViewPath {Boolean} 是否添加一层模版语言目录

获取或者设置国际化的语言,可以支持模版路径要多一层语言的目录。

获取语言
let lang = http.lang();

获取语言的循序为 http._lang -> 从 cookie 中获取 -> 从 header 中获取,如果需要从 url 中解析语言,可以获取后通过 http.lang(lang) 方法设置到属性 http._lang 中。

设置语言
let lang = getFromUrl();
http.lang(lang, true); //设置语言,并指定模版路径中添加一层语言目录

http.theme(theme)

获取或者设置主题,设置后模版路径要多一层主题的目录。

http.cookie(name, value)

  • name {String} cookie 名称
  • value {String} cookie 值

读取或者设置 cookie 值。

http.cookie('think_test'); //获取名为 think_test 的 cookie
http.cookie('name', 'value'); //设置 cookie,如果头信息已经发送则设置无效
http.cookie('name', null); //删除 cookie

http.session(name, value)

  • name {String} session 名
  • value {Mixed} session 值
  • return {Promise}

读取、设置和清除 session。

读取 Session
let value = await http.session('userInfo');
设置 Session
await http.session('userInfo', data);
清除 Session
await http.session();

http.redirect(url, status)

  • url {String} 要跳转的 url
  • status {Number} 状态码, 301 或者 302,默认为302

页面跳转。

http.redirect('/login'); //跳转到登录页面

http.type(contentType, encoding)

  • contentType {String} 要设置的 contentType
  • encoding {String} 要设置的编码

获取或者设置 Content-Type。

http.type(); //获取Content-Type
http.type('text/html'); //设置Content-Type,会自动加上charset
http.type('audio/mpeg', false); //设置Content-Type,不追加charset

http.write(content, encoding)

  • content {Mixed} 要输出的内容
  • encoding {String} 编码

输出内容,要调用 http.end 才能结束当前请求。

http.end(content, encoding)

  • content {Mixed} 要输出的内容
  • encoding {String} 编码

输出内容并结束当前请求。

http.success(data, message)

  • data {Mixed} 要输出的数据
  • message {String} 追加的message

格式化输出一个正常的数据,一般是操作成功后输出。

http.success({name: 'thinkjs'});
//writes
{
  errno: 0,
  errmsg: '',
  data: {
    name: 'thinkjs'
  }
}

这样客户端就可以根据 errno 是否为 0 为判断当前请求是否正常。

http.fail(errno, errmsg, data)

  • errno {Number} 错误号
  • errmsg {String} 错误信息
  • data {Mixed} 额外的数据

格式化输出一个异常的数据,一般是操作失败后输出。

:字段名 errnoerrmsg 可以在配置里进行修改。

http.fail(100, 'fail')
//writes
{
  errno: 100,
  errmsg: 'fail',
  data: ''
}

这样客户端就可以拿到具体的错误号和错误信息,然后根据需要显示了。

:字段名 errnoerrmsg 可以在配置里进行修改。

http.json(data)

  • data {Object}

json 方式输出数据,会设置 Content-Type 为 application/json,该值对应的配置为json_content_type

如发现文档中的错误,请点击这里修改本文档,修改完成后请 pull request,我们会尽快合并、更新。