近来想重写一下网站的Restful API,原来是用PHP写的,看到如今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,斟酌到我用的数据库是Mysql,所以我把CRUD部份的操纵改成了MySql的,
1. 环境的搭建
nodejs的装置我就是不说了,我重要采用了以下Node package
Express 4.0
nodejs下最着名的web 框架了waterline
ORM数据操纵中间件,官方团队供应的适配器:供应了对 MySQL / MongoDB / Redis 的支撑,也有许多第三方开辟的适配器。sails-mysql
这个是waterline 官方供应的对MySQL的adapter
package.json 内容
{
"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
测试一下顺序的运转结果
因为要调试restful API 所以引荐运用POSTMAN 一款chrome下特地用来调试restful api的东西
在地址栏里输入 http://localhost:8080/api/
能够看到,服务器已一般启用了。接下来就是要做一些CRUD,的操纵了.
2. 数据库的建立
为了坚持代码的清析和可理解,所认为测试代码建立的数据库很简朴:
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在主目录下建立一个app/models/bear.js
//app/models/bear.js
var Waterline = require('waterline');
module.exports = Waterline.Collection.extend({
identity:'bear', //模子名,默许对应表名,你也能够经由历程tableName 属性来设置对应的表名
connection:'myLocalMysql',//所采有的数据库衔接
schema: true,
attributes:{
name:'string'
}
});
更细致的models申明,清拜见:https://github.com/balderdashy/waterline-docs/blob/master/models/models.md
在建立一个数据库链接设置文件 app/config/waterline.js
//app/config/waterline.js
var mysqlAdapter = require('sails-mysql');
var wlconfig = {
adapters: {
'default':mysqlAdapter,
mysql: mysqlAdapter
},
connections: {
myLocalMysql: { //对应models中的connection
adapter : 'mysql',
host : 'localhost',
port : 3306,
user : 'root',
password : '',
database : 'test'
}
},
defaults: {
migrate: 'safe' //这个注重啊,如果是争对已有的数据库肯定要注重,警惕把表全删除了
}
};
exports.config = wlconfig;
然后回到server.js引入相干文件
//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);
});
3. 定义路由
//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() 来建立路由并增添一个中间件,这里我们只是让它简朴的在控制台输出一句 Something is happening.’
POST /API/BEARS
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:设为 ‘safe’, 不过也能够在models里封闭 autoCreatedAt:false 就能够了
GET /API/BEARS
//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);
});
});
经由历程id举行查改删
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'});
});
});
总结
全部历程应该是比较简朴的,因为没有触及营业逻辑部份,所以也没有遇到什么坑,但作为一个基础入门照样比较简约清楚的。