5分钟构建一个Restful后端

原材料

express
mongoose
seven-express
express-session

Start

使用npm安装 express 和 脚手架

$ npm install -g --save express express-generator

初始化项目

默认是使用Jade模版，可以使用–view== 来指明其他的模版.

$ express seven-test
$ cd seven-test
$ npm install
$ npm install mongoose seven-express express-session

Configure

进行 `app.js` 配置

默认的配置比较繁琐，我们先来精简一下配置文件，只留下我们需要的部分，如果还需要其他的中间件可以后面自行配置。

var express = require('express');
var path = require('path');
var cookieParser = require('cookie-parser');
var bodyParser = require('body-parser');
    
var app = express();
    
// view engine setup
app.set('views', path.join(__dirname, 'views'));
app.set('view engine', 'jade');
    
// uncomment after placing your favicon in /public
//app.use(favicon(path.join(__dirname, 'public', 'favicon.ico')));
app.use(bodyParser.json());
app.use(bodyParser.urlencoded({ extended: false }));
app.use(cookieParser());
app.use(express.static(path.join(__dirname, 'public')));
    
module.exports = app;

下面我们来进行进一步的配置，将我们需要的中间件引入进来，并配置。

var express = require('express');
var path = require('path');
var cookieParser = require('cookie-parser');
var bodyParser = require('body-parser');
var session = require('express-session');
var mongoose = require('mongoose');
var seven = require('seven-express');
var router = express.Router();
var app = express();
    
// 连接数据库
mongoose.connect('mongodb://localhost:27017/Test');
    
// view engine setup
app.set('views', path.join(__dirname, 'views'));
app.set('view engine', 'jade');
    
// uncomment after placing your favicon in /public
//app.use(favicon(path.join(__dirname, 'public', 'favicon.ico')));
app.use(bodyParser.json());
app.use(bodyParser.urlencoded({ extended: false }));
app.use(cookieParser());
app.use(express.static(path.join(__dirname, 'public')));
    
// 添加session中间件
app.use(session({
 secret: '12345',
 name: 'seven-test',
 cookie: {maxAge: 80000 },
 resave: false,
 saveUninitialized: true
}));
    
// 添加seven中间件
seven.creator(app, router, path.join(__dirname, 'schema'));
    
    
module.exports = app;

添加 `schema`

在项目目录下添加 schema 文件夹，然后在里面添加各种mongoose的schema文件。如果需要seven的权限管理功能，则默认需要添加 user 表，并添加 username , password , role 属性。

const mongoose = require('mongoose');
    
let User = new mongoose.Schema({
 // 用户名
 username: String,
 // 密码
 password: String,
 // 用户身份
 role: String,
});
    
module.exports = User;

添加 `seven` 的配置文件

自定义配置可以参照后面的seven中间件的介绍，这里给出样例。

{
  "rule": {
    "user" : {
      "Create": {
        "key": "username",
        "bodyList": ["username", "role"]
      },
      "Update": {
        "bodyList": ["username"]
      }
    }
  },
  "authority": {
    "role": ["admin", "user", "superadmin"],
    "filter": {
      "user": {
        "Create": false,
        "Retrieve": ["admin"],
        "Update": ["user", "admin", "superadmin"]
      }
    }
  }
}

Run

现在就能把整个项目run起来。

$ npm start

如果正常，会出现

users
    Pagination get /user/page/:page
    Create post /user
    Delete delete /user/:id
    Update put /user/:id
    Login post /login
    Retrieve get /user/:id

这些就是对于 schema 自动映射得到的 Restful API，具有可配置的参数检查功能，具有可配置的权限管理功能。

到现在我们没有写一行代码，就实现了整个 Restful API 的后端功能。