NodeJs 關(guān)系數(shù)據(jù)庫ORM庫：Bookshelf.js
bookshelf.js是基于knex的一個關(guān)系型數(shù)據(jù)庫的ORM庫。簡單易用，內(nèi)置了Promise的支持。這里主要羅列一些使用的例子，例子就是最好的教程。下面就是用mysql作為實(shí)例數(shù)據(jù)庫表明bookshelf如何使用。其他的幾個關(guān)系型數(shù)據(jù)庫使用上基本一致，只是配置等地方需要使用的名稱各自不同。為了更加貼近實(shí)際全部的例子都會放在Express打造的RESTful服務(wù)里。
安裝bookshelf和knex
首先需要安裝庫knex和bookshelf，其次還需要安裝你的數(shù)據(jù)庫對應(yīng)的包：

npm install knex --save
npm install bookshelf --save
接下來，安裝對應(yīng)于你要使用的數(shù)據(jù)庫的driver包。下面列出了三個比較典型的，只需要選擇一個安裝就可以。

npm install pg --save       // PostgreSQL
npm install mysql --save    // MySQL
npm install sqlite3 --save  // SQLite
連接數(shù)據(jù)庫
連接數(shù)據(jù)庫就是非常的簡單的，只需要傳入一個JSON格式的配置：

var knex        = require('knex'),
    db;    // 數(shù)據(jù)庫連接

// 數(shù)據(jù)庫連接配置
var config = {
    client: 'mysql',        // 其他可以是pg、sqlite3
    connection: {
        host: 'localhost',
        user: 'root',
        password: '123456',
        database: 'petshop', // 數(shù)據(jù)庫名稱
        charset: 'utf8'
    }
};

// 保證數(shù)據(jù)庫連接只初始化一次。
if (!db) {
    db = knex(config);
}
接下來就該讓bookshelf出馬了：

var bookshelf = require('bookshelf')(db);

Express打造的RESTful服務(wù)代碼：

var Promise     = require('bluebird'),
    express     = require('express'),
    bodyParser  = require('body-parser'),
    session     = require('express-session');

var app = express();

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

app.use(session({
    secret: 'abcdefghijklmnopqrstuvwxyz1234567890',
    resave: false,
    saveUninitialized: true
    // cookie: {secure: true}
}));

var models = require('./bookshelf');
var router = express.Router();

router.get('/', function(req, res) {
    res.send('Hello bookshelf');
});

/**
 * 添加
 */
router.route('/add').post(function(req, res) {
    // ...
});

/** 
 * 更新
 */
router.route('/update').post(function(req, res) {
    // ...
});

app.use('/bookshelf', router);

app.listen(4000, function(){
    console.log('express is running on http://localhost:4000');
});
為了正常使用還需要安裝某些包body-parser，這個包用來解析post發(fā)送上來的數(shù)據(jù)。bluebird和express-session什么的可以選擇不裝，不影響。
## Model

ORM，這model是必須不可以少的。如何讓model來對應(yīng)于數(shù)據(jù)庫的table呢：


var Pet = bookshelf.Model.extend({
    tableName: 'pet',
});



現(xiàn)在就可以使用`Pet`來處理pet表的數(shù)據(jù)了。

上面是理論上的?；氐奖纠?。首先在根目錄下創(chuàng)建一個文件夾*bookshelf*，然后添加文件*model.js*。

### 添加數(shù)據(jù)

給表添加一條記錄：


new Pet({
    name: 'King',
    type: 1, // 1: dog, 2: cat...
    quantity: 10,
    userId: 123456
}).save().then(function(model){
    console.log(model);
}).catch(function(err) {
    console.log(err);
});



放在RESTful API里：


router.route('/add').post(function(req, res) {
    var pet = new models.Pet({
        name: req.body.name,
        type: req.body.type,
        quantity: req.body.quantity,
        userId: req.body.userId
    });

    pet.save().then(function(model){
        res.json({message:'done', data: pet});
    }).catch(function(err){
        res.json({message: 'error', data: err});
    });
});



在處理數(shù)據(jù)的時候可以使用bookshelf提供的很多“靜態(tài)方法”。上面的`extend`就是這些靜態(tài)方法中的一個。創(chuàng)建新的model的時候就可以是用靜態(tài)方法里的一個`forge`，這樣就不用new的方式了。


    models.Pet.forge({
        name: req.body.name,
        type: req.body.type,
        quantity: req.body.quantity,
        userId: req.body.userId
    }).save().then(function(pet){
        res.json({message:'done', data: pet});
    }).catch(function(err){
        res.json({message: 'error', data: err});
    });



### 查找數(shù)據(jù)

添加了數(shù)據(jù)就可以查找出來了。

#### 查找全部

查找全部的數(shù)據(jù)：

router.route('/findall').get(function(req, res) {
    models.Pet.forge().fetchAll().then(function(pets) {
        res.json({message: 'done', data: pets});
    }).catch(function(err) {
        res.json({message: 'error', data: err});
    });
});



在瀏覽器里輸入地址：[http://localhost:4000/bookshelf/findall可以查找出全部的pet數(shù)據(jù)。](http://localhost:4000/bookshelf/findall%E5%8F%AF%E4%BB%A5%E6%9F%A5%E6%89%BE%E5%87%BA%E5%85%A8%E9%83%A8%E7%9A%84pet%E6%95%B0%E6%8D%AE%E3%80%82)

#### 查找某一個Pet


router.route('/find/:petId').get(function(req, res) {
    models.Pet.forge({
        petId: req.params.petId
    }).fetch().then(function(pet) {
        res.json({message: 'done', data: pet});
    }).catch(function(err) {
        res.json({message: 'error', data: err});
    });
});



在瀏覽器里輸入地址：[http://localhost:4000/bookshelf/find/1可以查找出petId為1的數(shù)據(jù)。](http://localhost:4000/bookshelf/find/1%E5%8F%AF%E4%BB%A5%E6%9F%A5%E6%89%BE%E5%87%BApetId%E4%B8%BA1%E7%9A%84%E6%95%B0%E6%8D%AE%E3%80%82)

我們在上一個例子中已經(jīng)創(chuàng)建了一條記錄，所以現(xiàn)在可以搜出來一條記錄。

更多的更復(fù)雜的查找可以使用方法`query`，查看[這里](http://bookshelfjs.org/#Model-instance-query)了解更多。

### 更新數(shù)據(jù)

更新和創(chuàng)建一條新紀(jì)錄，在寫法上沒什么太大的區(qū)別。只不過你需要在`save`方法里設(shè)置需要更新的數(shù)據(jù)。但是有一個限制條件，就是需要在forge方法里給出`id`，必須是這個詞`i`和`d`。如果你的Primary key不是這個名稱，那么就稍微復(fù)雜一點(diǎn)了。必須給出`where`條件，比如：


router.route('/update/:petId').post(function(req, res) {
    models.Pet.forge()
    .where('petId', '=', req.params.petId)
    .save({
        name: req.body.name,
        type: req.body.type,
        quantity: req.body.quantity,
        userId: req.body.userId
    }, {patch: true}).then(function(pet) {
        res.json({message: 'done', data: pet});
    }).catch(function(err) {
        res.json({message: 'error', data: err});
    });
});



更多關(guān)于`where`內(nèi)容可以查看[這里](http://bookshelfjs.org/#Model-instance-where)。

### 刪除記錄

最后可以刪除記錄。


router.route('/delete/:petId').get(function(req, res) {
    models.Pet.forge()
    .where('petId', '=', req.params.petId)
    .destroy()
    .then(function(pet) {
        res.json({message: 'done', data: pet});
    })
    .catch(function(err) {
        res.json({message: 'error', data: err});
    });
});

https://toscode.gitee.com/cc032191/mysql-ithm