# 使用 Express 搭建一个简单的服务器

# Express 框架

# Web 应用程序

Express 是一个保持最小规模的灵活的 Node.js Web 应用程序开发框架,为 Web 和移动应用程序提供一组强大的功能。

# API

使用您所选择的各种 HTTP 实用工具和中间件,快速方便地创建强大的 API。

# 性能

Express 提供精简的基本 Web 应用程序功能,而不会隐藏您了解和青睐的 Node.js 功能。

# Express-路由基本使用

下载:npm install express --save

# Hello world

新建一个server.js文件,然后输入:

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

app.get("/", (req, res) => {
  req.send("Hello world");
});
app.listen(8083, () => {
  console.log("Server is running at http://localhost:8083");
});

然后运行:node server.js 打开:http://localhost:8083/ 就出现: express-1

# 请求和响应

Express 应用使用回调函数的参数: request 和 response 对象来处理请求和响应的数据。

app.get("/", function(request, response) {
  // --
});

request 和 response 对象的具体介绍:

# Request 对象

request 对象表示 HTTP 请求,包含了请求查询字符串,参数,内容,HTTP 头部等属性。常见属性有:

  • req.app:当 callback 为外部文件时,用 req.app 访问 express 的实例
  • req.baseUrl:获取路由当前安装的 URL 路径
  • req.body / req.cookies:获得「请求主体」/ Cookies
  • req.fresh / req.stale:判断请求是否还「新鲜」
  • req.hostname / req.ip:获取主机名和 IP 地址
  • req.originalUrl:获取原始请求 URL
  • req.params:获取路由的 parameters
  • req.path:获取请求路径
  • req.protocol:获取协议类型
  • req.query:获取 URL 的查询参数串
  • req.route:获取当前匹配的路由
  • req.subdomains:获取子域名
  • req.accepts():检查可接受的请求的文档类型
  • req.acceptsCharsets / req.acceptsEncodings / req.acceptsLanguages:返回指定字符集的第一个可接受字符编码
  • req.get():获取指定的 HTTP 请求头
  • req.is():判断请求头 Content-Type 的 MIME 类型

# Response 对象

response 对象表示 HTTP 响应,即在接收到请求时向客户端发送的 HTTP 响应数据。常见属性有:

  • es.app:同 req.app 一样
  • res.append():追加指定 HTTP 头
  • res.set()在 res.append()后将重置之前设置的头
  • res.cookie(name,value [,option]):设置 Cookie
  • opition: domain / expires / httpOnly / maxAge / - path / secure / signed
  • res.clearCookie():清除 Cookie
  • res.download():传送指定路径的文件
  • res.get():返回指定的 HTTP 头
  • res.json():传送 JSON 响应
  • res.jsonp():传送 JSONP 响应
  • res.location():只设置响应的 Location HTTP 头,不设置状态码或者 close response
  • res.redirect():设置响应的 Location HTTP 头,并且设置状态码 302
  • res.render(view,[locals],callback):渲染一个 view,同时向 callback 传递渲染后的字符串,如果在渲染过程中有错误发生 next(err)将会被自动调用。callback 将会被传入一个可能发生的错误以及渲染后的页面,这样就不会自动输出了。
  • res.send():传送 HTTP 响应
  • res.sendFile(path [,options][,fn]):传送指定路径的文件 -会自动根据文件 extension 设定 Content-Type
  • res.set():设置 HTTP 头,传入 object 可以一次设置多个头
  • res.status():设置 HTTP 状态码
  • res.type():设置 Content-Type 的 MIME 类型

# Express-路由

我们已经了解了 HTTP 请求的基本应用,而路由决定了由谁(指定脚本)去响应客户端请求。 在 HTTP 请求中,我们可以通过路由提取出请求的 URL 以及 GET/POST 参数。

路由的基本形式: app.METHOD(PATH, HANDLER)

  1. app 表示的是一个 Express 的实例
  2. METHOD 是 http 请求的方法(get, psot..)
  3. PATH 服务器上的路径
  4. HANDLER请求之后的执行函数

下面的示例说明了如何定义路由:

// 对/news 页面进行get请求
app.get("news", (req, res) => {
  res.send("Hello news");
});
// 对/about 页面进行post请求
app.post("about", (req, res) => {
  res.send("Hello about");
});
// 对/list* 可匹配 /list+任意字符
app.get("/list*", (req, res) => {
  res.send("Hello list pages");
});

然后运行:node server.js 打开:http://localhost:8083/ (opens new window) express-2 express-3 express-4

# Express-搭建静态资源库

Express 提供了内置的中间件 express.static 来设置静态文件如:图片, CSS, JavaScript 等。

你可以使用 express.static 中间件来设置静态文件路径。例如,如果你将图片, CSS, JavaScript 文件放在 public 目录下,你可以这么写: app.use(express.static('public'));

现在,你就可以访问 public 目录中的所有文件了:

public/index.html
public/images
public/images/bg.jpeg
public/css
...

如果要使用多个静态资源目录,请多次调用 express.static 中间件函数:

app.use(express.static("public"));
app.use(express.static("files"));

Express 在静态目录查找文件,因此,存放静态文件的目录名不会出现在 URL 中。 但是您可以给静态目录添加一个路由: app.use('/static', express.static(path.join(__dirname, 'public'))) 设置/static/public目录的路由。 现在,你就可以通过带有 /static 前缀地址来访问 public 目录中的文件了。

http://localhost:8083/static/css
http://localhost:8083/static/css/index.css
http://localhost:8083/static/image
http://localhost:8083/static/images/bg.jpeg
http://localhost:8083/static/index.html

为了安全,最好使用绝对路由: app.use('/static', express.static(path.join(__dirname, 'public'))) 然后运行:node server.js 打开:http://localhost:8083/static (opens new window) 就可以访问 public 下的所有文件,如图: express-5

# Express-模板引擎之 EJS

EJS 是一套简单的模板语言,帮你利用普通的 JavaScript 代码生成 HTML 页面。

下载 Ejs: npm install ejs --save 同目录下新建myejs.js:

const express = require("express");
const app = express();
//设置模板文件的目录,并且新建一个viwes的目录
app.set("views", "./views");
//注册模板引擎
app.set("view engine", "ejs");
//使用res.render()来渲染一个视图并将呈现的HTML字符串发送给客户端;
app.get("/", function(req, res) {
  res.render("index", { title: "测试" });
});
//监听8083端口
app.listen(8083, () => {
  console.log("Server is running at http://localhost:8083");
});

在新建 views 目录中新建 index.ejs:

<h1><%= title %></h1>

然后运行:node myejs.js 打开:http://localhost:8083 (opens new window) 即可看到: express-6

当然,也可以返回一个 json 文件来渲染视图: 在同目录下新建一个 data.json:

{
    "list": [
    { "name":"小明" , "age":"6", "sex": "男"},
    { "name":"小红" , "age":"4" ,"sex": "女"},
    { "name":"小亮" , "age":"5" ,"sex": "男"}
    ],
    "source":"神奇二班"
}

然后更改 myejs.js:

const express = require("express");
const fs = require("fs");
const app = express();

//设置模板文件的目录,并且新建一个viwes的目录
app.set("views", "./views");
//注册模板引擎
app.set("view engine", "ejs");
//使用res.render()来渲染一个视图并将呈现的HTML字符串发送给客户端;
app.get("/", function(req, res) {
  getDataJson((dataJson) => {
    console.log(dataJson);
    res.render("index", dataJson);
  });
});
//访问data.json 拿到数据解析并返回
const getDataJson = (callBack) => {
  fs.readFile("./data.json", (err, data) => {
    if (!err) {
      let jsonData = JSON.parse(data);
      callBack(jsonData);
    } else {
      throw err;
    }
  });
};
//监听8083端口
app.listen(8083, () => {
  console.log("Server is running at http://localhost:8083");
});

然后更改 index.ejs:

<h4><%=source %></h4>
<ul>
    <% for(var i=0; i<list.length; i++){ %>
        <li><%= list[i].name %> | <%= list[i].age %> | <%= list[i].sex %></li>
    <% } %>
</ul>

然后在运行:
然后运行:node myejs.js
打开:http://localhost:8083 (opens new window)

express-7

参考:
GitHub 源码 (opens new window)
Express 官方文档 (opens new window)
EJS 模板引擎 (opens new window)