通过express快速搭建一个node服务

Node.js 是一个基于Chrome JavaScript 运行时建立的一个平台。可以理解为是运行在服务端的 JavaScript。如果你是一个前端程序员，不太擅长像PHP、Python或Ruby等动态编程语言，想创建自己的服务，那么Node.js是一个非常好的选择。本文将通过几个简要步骤，运用express框架，搭建一个node服务。

一、安装、搭建环境

1、新建一个文件夹，这里暂时叫做“node-service”。

2、进入文件夹，cmd执行npm init，可根据自己需要填写一些信息，不需要定制的话，前面一路回车即可，只需要在最后，即下图中红色圈起部分输入yes或者y。此时在文件夹内会生成一个package.json文件。红色划线部分是我示例填写，不是必需。

3、安装express

命令：cnpm install express --save

此时文件夹中会生成node-modules文件夹，以上命令会将express框架安装在node-modules目录中。以下几个重要模块，是可以与express一起安装的，大家根据自己需要进行安装即可。

body-parser - node.js 中间件，用于处理 JSON, Raw, Text 和 URL 编码的数据。

cookie-parser - 一个解析Cookie的工具。通过req.cookies可以取到传过来的cookie，并把它们转成对象。

multer - node.js 中间件，用于处理 enctype="multipart/form-data"（设置表单的MIME编码）的表单数据。

二、创建一个简单实例

在我们创建 Node.js 第一个 "Hello, World!" 应用前，让我们先了解下 Node.js 应用是由哪几部分组成的：

引入 required 模块：我们可以使用 require 指令来载入 Node.js 模块。

创建服务器：服务器可以监听客户端的请求，类似于 Apache 、Nginx 等 HTTP 服务器。

接收请求与响应请求 服务器很容易创建，客户端可以使用浏览器或终端发送 HTTP 请求，服务器接收请求后返回响应数据。

此时我们求创建一个服务：在客户端发起请求时，响应"hello world"字符串。

2.1、创建app.js文件，示例代码如下：

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

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

let port = 8082;
app.listen(port, () => {
    console.log(`Server listening on http://localhost::${port}, Ctrl+C to stop`)
});

2.2、启动服务：根目录下执行命令 node app.js

2.3、在浏览器中访问http://localhost:8082/ 或http://127.0.0.1:8082/，效果如下：

此时有文本输出，说明服务搭建成功。

三、路由匹配

上文我们是在客户端发起请求时，直接响应一段指定文本。但有时需要根据不同请求路径或请求方式，返回不同数据。所以我们新建一个文件app1.js，代码如下：

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

// 默认请求，输出 "Hello World"
app.get('/', function (req, res) {
   res.send('Hello GET');
})
// 用户删除接口
app.get('/user_del', function (req, res) {
   res.send('用户删除接口');
})
// 用户信息查询接口 GET 请求
app.get('/user_list_query', function (req, res) {
   res.send('用户列表数据');
})

let port = 8082;
app.listen(port, () => {
    console.log(`Server listening on http://localhost::${port}, Ctrl+C to stop`)
});

文件中通过三个不同路径暴露了三个接口，接下来我们可以访问不同路径，看验证是否返回不同信息。

可以看到，我们已经拿到了不同返回体。但也许有人会问，如果此时我有很多请求，难道都堆在app1.js里嘛，能不能把请求归类一下，让app1.js整洁一些，只作为入口呢？当然可以。

假定现有两类接口，每类各有三个接口
一、用户管理
1、用户列表查询：user/user_list_query
2、用户信息删除：user/user_del
3、用户信息修改：user/user_update
二、部门管理
1、部门列表查询：dept/dept_list_query
2、部门删除：dept/dept_del
3、部门修改：dept/dept_update 

此时我们在app1.js同级建立api文件夹，文件夹下新建文件user.js和dept.js。

// dept.js
let express = require('express');
let router = express.Router();

//  部门修改接口
router.get('/dept_update', function (req, res) {
  res.send('部门修改接口');
});

// 部门删除接口
router.get('/dept_del', function (req, res) {
  res.send('部门删除接口');
});

// 部门信息查询接口
router.get('/dept_list_query', function (req, res) {
  res.send('部门列表数据');
});

module.exports = router;

user.js 与此类似，不再赘述。文件中通过使用express.Router()注册接口，通过module.exports抛出整个模块，然后在app1.js中引入并使用该模块：

//app1.js
var express = require('express');
var app = express();
let dept = require('./api/dept');

//  匹配请求，以dept开头的映射到dept文件中去
app.use('/dept', dept);

let port = 8082;
app.listen(port, () => {
  console.log(`Server listening on http://localhost::${port}, Ctrl+C to stop`)
});

重新启动8082服务。浏览器直接访问http://localhost:8082/dept/dept_update，可以成功拿到返回体。

上面通过2种方式，实现了匹配接口路径，给出不同返回体。做的更全一点，就可以模拟接口增删改查逻辑了。提到逻辑处理，就会和请求参数挂钩，所以我们向下看。

四、请求和响应处理

function中的req和res，分别是 request 和 response 对象。

request 对象 - 表示 HTTP 请求，包含了请求查询字符串，参数，内容，HTTP 头部等属性。

response 对象 - 表示 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类型

res.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类型

五、静态文件服务器

有时，我们的一些静态文件，例如图片、CSS文件、js文件等，想放在一个服务器上，此时node可以作为静态文件服务器。

express 提供了内置的中间件 express.static 来设置静态文件路径。

app.use('/public', express.static('public'));

我们在app.js同级，新建一个public目录，存放静态文件。向里面放一个css文件和一张图片。

5.1、按路径读取文件：

新建app2.js文件：

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

app.use('/public', express.static('public'));

app.get('/', function(req, res){
  res.send('hello world');
});
let port = 8082;
app.listen(port, () => {
    console.log(`Server listening on http://localhost::${port}, Ctrl+C to stop`)
});

将之前占用8082端口的服务停掉，通过node app2.js 启动服务。可以看到默认输出"hello world"。此时我们尝试输入文件路径去读静态文件。

5.2、接口返回静态文件

上面示例是需要自己输入文件路径拿到文件，有人说输路径太麻烦了，能不能通过一个接口返回指定静态文件呢？res.sendFile来了，新建app3.js ：

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

app.use('/public', express.static('public'));

app.get('/', function(req, res){
   console.log(__dirname);  // 打印结果：/node-service
   res.sendFile(__dirname+'/public/avatar.jpg');
});

let port = 8082;
app.listen(port, () => {
    console.log(`Server listening on http://localhost::${port}, Ctrl+C to stop`)
});

此时执行node app3.js 启动服务，不用输入文件路径，直接就可以看到图片。

此时代码与5.1基本相同，差异是用了res.sendFile。

__dirname 是当前模块的目录名。 相当于 __filename 的 path.dirname()。

console.log(__dirname);
// 打印: /node-service
console.log(path.dirname(__filename));
// 打印: /node-service，前提是引入了path模块，没有引入的话，打印会报错

Tips：

    1、app.js文件，每次改动都要重新启动服务才能生效。 

    2、如果两个js文件用了同一个端口，同时启动会报端口占用，可每次只起一个，或者用两个端口。

    3、启动命令是node js 文件名，app.js只是示例 

如果有需要，点击此处链接获取文章实例源码（点我！点我！），或者关注公众号可更早获取文章~