Express API 总结

一、 express.xxx

• express.json

var express = require("express");
var app = express();

app.use(express.json());
app.post("/xxx", function (req, res) {
  console.log(typeof req.body);
  res.send("成功了");
});

app.listen(4000, function () {
  console.log("Example app listening on port 4000!");
});

这是个中间件，用来将请求体进行JSON转换(如果可以进行JSON转换)，并内置了bordy-parse,这样在处理函数中可以用req.body获取请求体，输出为对象

curl localhost:4000/xxx -X POST -d '{"hello": "world"}' --header "Content-Type: application/json"

输出为

object
{ hello: 'world' }

• express.static -设置静态目录

express.static('public')

例如：

curl http://localhost:4000/test.html

访问test.html会自动寻找public目录下的test.html返回

二、app.xxx

• app.set-用于设置app属性值
  例如
  设置视图目录为lv文件夹

app.set('views','lv')

设置模板引擎为ejs

app.set('view engine','ejs')

自定义设置app内置属性

app.set('title', 'My Site')
app.get('title')//'My Site'

• app.get/app.post-匹配请求方式为get或post请求

app.get('/', function (req, res) {
  res.send('GET request to homepage')
})
app.post('/', function (req, res) {
  res.send('POST request to homepage')
})

• app.render
  通过回调函数返回视图呈现的HTML。它接受一个可选参数，该参数是一个包含视图局部变量的对象。它类似于res.render()，只是它不能自己将呈现的视图发送给客户端。

var express = require("express");
var app = express();
app.set("views", "lv");
app.set("view engine", "ejs");
app.render('email', function (err, html) {
  // ...
})

app.render('email', { name: 'Tobi' }, function (err, html) {
  // ...
})

app.listen(4000, function () {
  console.log("Example app listening on port 4000!");
});

• app.use(fn)使用中间件处理请求

三、request.xxx

• req.get('Content-Type')获取请求头信息

req.get('Content-Type')
// => "text/plain"

• req.param

// ?name=tobi
req.param('name')
// => "tobi"

// POST name=tobi
req.param('name')
// => "tobi"

// /user/tobi for /user/:name
req.param('name')
// => "tobi"

• req.ip

console.dir(req.ip)
// => '127.0.0.1'

• req.params

/user/:name
// GET /user/tj
console.dir(req.params.name)
// => 'tj'

四、response.xxx

• res.send发送消息

app.get("/test/:name", function (req, res) {
  res.send([1, 2, 3]);
});

• res.render呈现一个视图并将呈现的HTML字符串发送给客户端。

var express = require("express");
var app = express();
app.set("views", "lv");
app.set("view engine", "ejs");
app.use(express.json());
app.use(express.static("public"));
app.get("/test", function (req, res) {
  res.render("index");
});

app.listen(4000, function () {
  console.log("Example app listening on port 4000!");
});

• res.status设置返回状态码

res.status(403).end()
res.status(400).send('Bad Request')
res.status(404).sendFile('/absolute/path/to/404.png')

• res.set/res.get设置/获取响应头

res.set('Content-Type', 'text/plain')

res.set({
  'Content-Type': 'text/plain',
  'Content-Length': '123',
  'ETag': '12345'
})

res.get('Content-Type')
// => "text/plain"

• res.append插入请求头,不会覆盖现有相同key的请求头参数

res.append('Link', ['<http://localhost/>', '<http://localhost:3000/>'])
res.append('Set-Cookie', 'foo=bar; Path=/; HttpOnly')
res.append('Warning', '199 Miscellaneous warning')

• res.format
  当存在时，对请求对象的Accept HTTP头执行内容协商。它使用req.accept()根据质量值排序的可接受类型为请求选择处理程序。如果未指定头，则调用第一个回调。当没有找到匹配项时，服务器响应406不可接受，或调用默认回调

res.format({
  'text/plain': function () {
    res.send('hey')
  },

  'text/html': function () {
    res.send('<p>hey</p>')
  },

  'application/json': function () {
    res.send({ message: 'hey' })
  },

  'default': function () {
    // log the request and respond with 406
    res.status(406).send('Not Acceptable')
  }
})

五、router.xxx 阉割版app-直接上代码体会吧

• router.use

var express = require('express')
var app = express()
var router = express.Router()

// simple logger for this router's requests
// all requests to this router will first hit this middleware
router.use(function (req, res, next) {
  console.log('%s %s %s', req.method, req.url, req.path)
  next()
})

// this will only be invoked if the path starts with /bar from the mount point
router.use('/bar', function (req, res, next) {
  // ... maybe some additional /bar logging ...
  next()
})

// always invoked
router.use(function (req, res, next) {
  res.send('Hello World')
})

app.use('/foo', router)

app.listen(3000)

• router.all

router.all('*', requireAuthentication)
router.all('*', loadUser)

• router.METHOD

router.get('/', function (req, res) {
  res.send('hello world')
})