摘要：接下來就是要做一些的操作了數(shù)據(jù)庫的創(chuàng)建為了保持代碼的清析和可理解，所以為測試代碼創(chuàng)建的數(shù)據(jù)庫很簡單就一個自增型主鍵字段和一個的字段，方便編碼。

最近想重寫一下網(wǎng)站的Restful API，原來是用PHP寫的，看到現(xiàn)在nodejs這么火也想試一下，雖然了解過nodejs但真正動手寫還是頭一次，找了好多教程來看然后試著敲下一代碼，這篇文件主要參考了

Build a RESTful API Using Node and Express 4
https://scotch.io/tutorials/build-a-restful-api-using-node-and-express-4

原文里用的是MongoDB,考慮到我用的數(shù)據(jù)庫是Mysql,所以我把CRUD部分的操作改成了MySql的，

nodejs的安裝我就是不說了，我主要采用了以下Node package

Express 4.0
nodejs下最出名的web 框架了

waterline
ORM數(shù)據(jù)操作中間件，官方團隊提供的適配器：提供了對 MySQL / MongoDB / Redis 的支持，也有很多第三方開發(fā)的適配器。

sails-mysql
這個是waterline 官方提供的對MySQL的adapter

package.json 內(nèi)容

{
  "name": "node-api",
  "version": "1.0.0",
  "description": "node api learn",
  "main": "server.js",
  "dependencies": {
    "body-parser": "^1.15.0",
    "express": "^4.13.4",
    "sails-mysql": "^0.12.1",
    "waterline": "^0.12.1"
  },
  "devDependencies": {
    "nodemon": "^1.9.1"
  }
}

運行

npm install

安裝所需要的所有package

首先讓 express 先跑起來

// server.js


var express    = require("express");     
var app        = express();                 
var bodyParser = require("body-parser");

app.use(bodyParser.urlencoded({ extended: true }));
app.use(bodyParser.json());

var port = process.env.PORT || 8080;        

var router = express.Router();             

router.get("/", function(req, res) {
    res.json({ message: "hello! welcome to our api!" });   
});

app.use("/api", router);


app.listen(port);
console.log("Magic happens on port " + port);

在控制臺運行

node server.js

因為要調(diào)試restful API 所以推薦使用POSTMAN 一款chrome下專門用來調(diào)試restful api的工具

在地址欄里輸入 http://localhost:8080/api/

可以看到，服務(wù)器已經(jīng)正常啟用了。接下來就是要做一些CRUD,的操作了.

為了保持代碼的清析和可理解，所以為測試代碼創(chuàng)建的數(shù)據(jù)庫很簡單：

CREATE TABLE `bear` (
  `id` int(10) unsigned NOT NULL AUTO_INCREMENT,
  `name` varchar(255) DEFAULT NULL
  PRIMARY KEY (`id`)
) ENGINE=MyISAM AUTO_INCREMENT=9 DEFAULT CHARSET=latin1;

就一個int id 自增型主鍵字段 和一個 varchar(255) 的name字段，方便編碼。

定義一個的model在主目錄下創(chuàng)建一個app/models/bear.js

//app/models/bear.js

var Waterline = require("waterline");

module.exports = Waterline.Collection.extend({
    identity:"bear",  //模型名，默認對應(yīng)表名，你也可以通過tableName 屬性來配置對應(yīng)的表名
    connection:"myLocalMysql",//所采有的數(shù)據(jù)庫連接
    schema: true,
    attributes:{
        name:"string"
    }
});

更詳細的models說明，清參見：https://github.com/balderdashy/waterline-docs/blob/master/models/models.md

在創(chuàng)建一個數(shù)據(jù)庫鏈接配置文件 app/config/waterline.js

//app/config/waterline.js
var mysqlAdapter = require("sails-mysql");

var wlconfig = {
    adapters: {
        "default":mysqlAdapter,
        mysql: mysqlAdapter
    },

    connections: {
        myLocalMysql: { //對應(yīng)models中的connection
            adapter : "mysql",
            host : "localhost",
            port : 3306,
            user : "root",
            password : "",
            database : "test"
        }
    },

    defaults: {
        migrate: "safe" //這個注意啊，如果是爭對已經(jīng)有的數(shù)據(jù)庫一定要注意，小心把表全刪除了
    }
};

exports.config = wlconfig;

然后回到server.js引入相關(guān)文件

//server.js

var Waterline    = require("waterline");

var Bear         = require("./app/models/bear");
var WConfig = require("./app/config/waterline");

var orm = new Waterline();
orm.loadCollection(Bear);

........
........

//把start server的代碼改為

orm.initialize(WConfig.config,function(err,models){
    if(err) throw err;
    app.models = models.collections;
    //app.set("models",models.collections);
    app.connections = models.connections;

    app.listen(port);

    console.log("Magic happens on port " + port);
});

//server.js

...

var port = process.env.PORT || 8080;

var router = express.Router();

router.use(function(req,res,next) {
    console.log("Something is happening.");
    next();
}); 

router.get("/", function(req,res) {
    res.json({ message: "Hello! welcome to our api! "});
});

...

app.use("/api",router);

使用 express.Router() 來創(chuàng)建路由并增加一個中間件，這里我們只是讓它簡單的在控制臺輸出一句 Something is happening."

router.route("/bears")
    .post(function(req,res) {
        app.models.bear.create(req.body,function(err,model) {
            if(err) return res.json({ err,err }, 500);
            res.json(model);
        });
    });

用POSTMAN測試一下

完美，不過怎么多了兩個字段 createAt 和 updateAt查了文檔才知道，這就是一開始的時候我沒有把
migrate:設(shè)為 "safe"， 不過也可以在models里關(guān)閉 autoCreatedAt：false 就可以了

//server.js
.post(function(req,res) {
        app.models.bear.create(req.body,function(err,model) {
            if(err) return res.json({ err,err }, 500);
            res.json(model);
        });
    })
.get(function(req,res) {
        app.models.bear.find().exec(function(err,model){
            if(err) return res.json({ err: err },500);
            res.json(model);
        });
    });

router.route("/bears/:bear_id")
    .get(function(req,res) {
        app.models.bear.findOne({ id: req.params.bear_id},function(err,model) {
            if(err) return res.json({ err:err },500);
            res.json(model);
        });
    })

    .put(function(req,res) {

        delete req.body.id;
        app.models.bear.update({ id: req.params.bear_id},req.body, function(err,model) {
            if(err) return res.json({ err: err},500);
            res.json(model);
        });
    })

    .delete(function(req,res) {
        app.models.bear.destroy({ id: req.params.bear_id},function(err,model) {
            if(err) return res.json({err: err},500);
            res.json({ status:"ok"});
        });
    });

整個過程應(yīng)該是比較簡單的，由于沒有涉及業(yè)務(wù)邏輯部分，所以也沒有碰到什么坑，但作為一個基本入門還是比較簡潔清晰的。