使用Node.js和MongoDB通过Mongoshin和Express.js构建JSON REST API服务器

根据《JavaScript快速全栈开发》书籍和网络上的融合整理出，方便自己和大家以后学习交流哒,更加为了自己整理笔记--

将使用Mocha和Super Agent库写测试，然后使用测试驱动的方式用Express.js、MongoDBD Mongoshin库开发一个免费的Node.js JSON Rest API服务器。

1.先创建一个用于保存测试文件的文件夹。可以人工创建也可以代码创建。（我的路径D:\A_Learn\Node.js\anzhuangmulu\NodeTest\rest-api）

mkdir rest-api

cd rest-api

2.用cmd进入存放node.js的目录里安装Mocha、Exppect.js和Super Agent库。

npm install mocha

npm install expect.js

npm install supperagent

3.【测试覆盖率】使用Super Agent的链式调用函数。写一个完整的express.test.js测试覆盖率，放入刚才创建的rest-api里面（我的地址是D:\A_Learn\NodeJS\anzhuangmulu\NodeTest\rest-api）

var superagent = require('superagent')
var expect = require('expect.js')
describe('express rest api server',function(){
	var id
	it ('post object',function(done){
		 superagent.post('http://localhost:3000/collection/test')
			.send({name:'John',email:'john@rpjs.co'})
			.end(function(e,res){
				 expect(e).to.eql(null)
				 expect(res.body.length).to.eql(1)
				 expect(res.body[0]._id.length).to.eql(24)
				 id = res.body[0]._id
				 done()
			})
	})
	it('retrieves an object',function(done){
		 superagent.get('http://localhost:3000/collections/test/'+id)
			 .end(function(e,res){
				 expect(e).to.eql(null)
				 expect(typeof res.body).to.eql('object')
				 expect(res.body._id.length).to.eql(24)
				 expect(res.body._id).to.eql(id)
				 done()
		 })
	})
	it('retrieves a collection',function(done){
		 superagent.get('http://localhost:3000/collections/test')
			 .end(function(e,res){
				 expect(e).to.eql(null)
				 expect(res.body.length).to.be.above(1)
				 expect(res.body.map(function(item){
					 return item._id
			 })).to.contain(id)
			 done()
		 })			
	})
	it('updates an object',function(done){
		 superagent.get('http://localhost:3000/collections/test/'+id)
			 .send({name:'Peter',email:'peter@yahoo.com'})
			 .end(function(e,res){
					 expect(e).to.eql(null)
					 expect(typeof res.body).to.eql('object')
					 expect(res.body.msg).to.eql('success')
					 done()
			 })
	})
	it('checks an uodated object',function(done){
		 superagent.get('http://localhost:3000/collections/test/'+id)
			 .end(function(e,res){
				 expect(e).to.eql(null)
				 expect(typeof res.body).to.eql('object')
				 expect(res.body._id.length).to.eql(24)
				 expect(res.body._id).to.eql(id)
				 expect(res.body.name).to.eql('Peter')
				 done()
		     })		 
	})
	it('removes an object',function(done){
		 superagent.get('http://localhost:3000/collections/test/'+id)
			 .end(function(e,res){
				 expect(e).to.eql(null)
				 expect(typeof res.body).to.eql('object')
				 expect(res.body.msg).to.eql('success')
				 done()
			 })
	})
})

最后cmd进入到D:\A_Learn\NodeJS\anzhuangmulu\NodeTest\rest-api后运行$mocha express.test.js命令，即可查看到6条信息。

（4）【依赖】将要使用Mongoskin,它是一个MongoDB库，比原生MongoDB驱动好用。Express.js是Node.js核心模块的包装器，它下Connect中间件的基础上构建而来，提供了大量的方便。

用cmd进入到node_modules目录中进行安装

npm install express

npm install -g mongoskin

npm install -g mogodb（因为还要用到mongo所以也要安装mongo哦.这个是全局安装mongodb否则会报找不到mongo的错误）

新建一个ecpress.js放入rest-api目录中

var express = require('express'),mongoskin = require('mongoskin')
var bodyParser = require('body-parser')
var app = express()
app.use(bodyParser.urlencoded({extended:false}))
app.use(bodyParser.json())
var db = mongoskin.db('localhost:27017/test',{safe:true});
app.param('collectionName',function(req,res,next,collectionName){
	 req.collection = db.collection(collectionName)
	 return next()
})
app.get('/',function(req,res){
	 res.send('please select a collection,'+'e.g.,/collections/messages')		
})
app.get('/collections/:collectionName',function(req,res){
		req.collection.find({},{limit:10,sort:[['_id',-1]]})
		.toArray(function(e,results){
			 if(e) return next(e)
				 res.send(results)
		})
})
app.post('/collections/:collectionName',function(req,res){
		 req.collection.insert(req.body,{},function(e,results){
			 if(e) return next(e)
			 res.send(results)
		 })	 
})
app.get('/collections/:collectionName/:id',function(req,res){
			 req.collection.findOne({_id:req.collection.id(req.params.id)},function(e,result){
				if(e) return next(e)
				 res.send(result)
			 })
})
app.put('/collections/:collectionName/:id',function(req,res){
			req.collection.update({_id:req.collection.id(req.params.id)},{$set:req.body},{safe:true,multi:false},function(e,result){
				 if(e) return next(e)
					 res.send((result===1) ? {msg:'success'} : {msg:'error'})
			})	
})
app.delete('/collections/:collectionName/:id',function(req,res){
			req.collection.remove({_id:req.collection.id(req.params.id)},function(e,result){
				 if(e) return next(e)
				 res.send((result === 1) ? {msg:'success'} : {msg:'error'})
			})	 
})
app.listen(3000)

在终端运行node express.js

在另外一个窗口（不要关闭之前那个）运行mocha  express.test.js

还可以在浏览器中查看比如http://localhost:3000/test

延伸：以前写成以下时会报下面的错误

var express = require('express'),mongoskin = require('mongoskin')
var app = express()
app.use(bodyParser())

这是因为express3和express4的区别：参考文献:http://www.expressjs.com.cn/guide/migrating-4.html#overview

所以改成了下面这样并且在node-moudle里面引入body-parser (npm install body-parser)：

var express = require('express'),mongoskin = require('mongoskin')
var bodyParser = require('body-parser')
var app = express()

运行了发现还报错误：body-parser deprecated bodyParser:use indiidual json/urlencoded middewares express.js:4:9

因此在里面加上

var express = require('express'),mongoskin = require('mongoskin')
var bodyParser = require('body-parser')
var app = express()
app.use(bodyParser.urlencoded({extended:false}))app.use(bodyParser.json())