Express实现路由分发控制、RESTful API

标签（空格分隔）： Node.js

---

最近在用Express作为自己的WEB应用框架，其中最为迷惑的就是Express的路由控制和分发，在网上搜了很多资料，但是大部分的资料都是将Express的路由控制写在了app.js入口文件中，但是这样的写法写一些Demo是可以的，但是在实战项目中基本上不会这样来写，因为随着项目的庞大，在app.js入口文件中的路由控制将会越来越复杂。所以，我们实际项目中一般会将不同的业务逻辑交给不同的模块开负责。

以下是这几天摸索出来的一些简单实现

如果有大神有更好的实现方案或建议，欢迎给予指点

具体实现方式如下

本Demo的目录结构如下

- node-modules

- api

- user.js

- routes

- index.js

- app.js

- package.json

创建Node.js应用

首先通过cd进入到项目希望放置的目录，然后执行以下命令

npm init -y

执行完以后，会在目录中创建一个package.json配置文件，打开该文件，在配置文件中添加项目中所需要的所有依赖。(我个人的搭配是Express+redis数据库)，添加完以后的package.json文件如下

{

"name": "RestfulDocApi",

"version": "1.0.0",

"description": "",

"main": "app.js",

"scripts": {

"test": "echo \"Error: no test specified\" && exit 1"

},

"keywords": [],

"author": "",

"license": "ISC",

"dependencies":{

"express":"^4.13.4", // express框架

"redis":"^2.5.2", // redis数据库

"body-parser": "~1.0.1", // 用于解析提交的请求表单

"response-time": "^2.3.1" // 计算响应时间中间件

}

}

安装Express框架及其依赖

编辑完以后，进入到该目录，然后执行以下命令安装Express框架及其依赖

npm install

注意

由于国内被墙，这个过程如果依赖包过多或过大的时候，会非常慢，所以，建议使用淘宝的cnpm来安装(不安装也可以，只是会比较慢)

• 安装cnpm

npm install -g cnpm

• 然后通过cnpm安装Express框架及其依赖

cnpm install

创建入口文件app.js

在根目录创建app.js并添加以下代码

/**

* app.js

* @authors 袁俊亮 (1610712512@qq.com)

* @date 2016-12-09 16:57:54

* @webSite http://www.yuanjunliang.cc

*/

 

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

var responseTime = require('response-time');

var redis = require('redis');

 

// 创建数据库客户端

var client = redis.createClient();

client.on('error',function(err){

console.log('error'+err);

});

 

// 设置端口

app.set('port',(process.env.PORT || 3000));

 

// 使用请求计时模块

app.use(responseTime());

 

// 设置/routes/index文件为总的路由控制文件

// 在routes/index文件中再进行统一的路由分发，这样防止app.js中代码过于臃肿

var routes = require('./routes/index');

routes(app);

 

// 启动服务的时候监听端口号

app.listen(app.get('port'),function(){

console.log('Server listening on port:',app.get('port'));

});

实现路由分发控制文件/routes/index.js

创建路由分发控制文件/routes/index.js，在该文件中，实现将用户所有的请求逻辑处理分发到不同的业务模块进行处理。实现代码如下

module.exports = function(app){

// 分发user模块，比如用户的注册和登录请求业务逻辑将会在/api/user.js中实现

var user = require('../api/user');

app.use('/user',user);

};

处理具体的业务逻辑（与数据库相关的业务逻辑处理都在这里完成）

创建一个/api目录下的user.js文件，在其中实现user模块的业务逻辑处理，代码如下

/**

* 用户模块user.js

* @authors 袁俊亮 (1610712512@qq.com)

* @date 2016-12-09 17:06:42

* @webSite http://www.yuanjunliang.cc

*/

 

var express = require('express');

var router = express.Router();

 

// 处理get请求

router.get('/', function(req, res) {

res.send({

'username':'john',

'sex':'man',

'address':'上海'

});

});

 

// 处理POST请求

router.post('/',function(req,res){

console.log('接受到了post请求');

res.send({

'regist':{title:req.param('username')}

})

});

 

module.exports = router;

经过上诉的处理以后就完成了user模块的路由控制分发，每当用户发起与user相关的请求时，就可以在/api/user.js中接收到用户的相关请求，并做相关处理

业务逻辑扩展

其他的分发逻辑类似，比如在添加一个文章编辑和查看模块

• 在/api目录下创建一个post.js文件并在其中实现文章的业务逻辑处理

• 在/routes/index.js文件中添加一条路由规则如下

module.exports = function(app){

// 分发user模块，比如用户的注册和登录请求业务逻辑将会在/api/user.js中实现

var user = require('../api/user');

app.use('/user',user);

// 文章编辑及查看路由模块

var post = requier('../api/post');

app.use('/post',post);

};

最后给出上诉项目的Demo源码

源码地址为:

链接: https://pan.baidu.com/s/1c2kPYCS 密码: ni3r

源码使用方法

• 解压源码

解压完源码以后通过终端cd到本项目中，然后执行npm install安装所有的依赖。

• 启动服务

node app.js

如果终端中返回一下信息，说明启动成功

Server listening on port: 3000

• 在浏览器中访问

http://localhost:3000/user

如果返回一下json数据，说明请求成功

{

"username": "john",

"sex": "man",

"address": "上海"

}