用expressjs写RESTful API

关注

原创最新推荐文章于 2026-07-05 09:19:52 发布 1.9w 阅读 AI 写同款· GEO 优化 ›

Express.js 实战：构建 RESTful API 的完整教程想象一下，你正在开发一个美食推荐App。前端设计师已经做好了漂亮的界面，但问题来了：这些美食数据从哪里来？这就像盖房子，设计师画好了图纸，现在需要你搭建"水管系统"——让数据能顺畅地在App和服务器之间流动。本教程的目的就是教你如何用Express.js这个"超级水管工工具包"，搭建一套规范、高效、可扩展的RESTful API"水管系统"。Express.js框架的核心原理RESTful API的设计规范路由和中间件的使用技巧数据库集成（MongoDB）错误处理和数据验证。阅读详情

expressjs

expressjs是一个基于nodejs的web开发框架：http://expressjs.com/，这篇博客目的就是用expressjs写一个关于products的最简单的RESTful API

一个最简单express的例子

package.json

{
"name": "hello-world",
"description": "hello world of express js",
"version": "0.0.1",
"private": true,
"dependencies": {
"express": "4.4.x"
}
}

安装express:

npm install

app.js

var express = require('express')

var app = express();

app.get('/hello', function(req, res){
res.send('hello world')
});

var server = app.listen(3000, function() {
console.log('listening on port %d', server.address().port);

});

运行:

node app

RESTful API

GET /products

GET /products/:id => 200

app.get('/products/:id', function(req, res) {
res.json(products[req.params.id]);
})

GET /products/:id => 404

app.get('/products/:id', function(req, res) {
if (products.length <= req.params.id || req.params.id < 0) {
res.statusCode = 404;
return res.send('Error 404: No products found')
}
res.json(products[req.params.id]);
})

POST /products => 201

因为我们在接受POST请求的时候，需要解析POST的body，所以，我们就要使用middleware来做这件事情，在早期版本中提供了bodyParser这样的方式。但是这种方式会创建大量的临时文件。所以，我们应该直接使用json或者urlencoded这样的middleware直接解析

在package.json中添加依赖：

"body-parser": "1.4.3"

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

var app = express()
.use(bodyParser.json());

app.post('/products', function(req, res) {
var newProduct = {
name: req.param('name'),
description: req.param('description'),
price: req.param('price')
}

products.push(newProduct);
res.statusCode = 201;
res.location('/products/' + products.length);
res.json(true);
});

POST /products => 400

app.post('/products', function(req, res) {
if (typeof req.param('name') === "undefined" ||
typeof req.param('description') === "undefined" ||
typeof req.param('price') === "undefined") {
res.statusCode = 400;
res.send('Error 400: products properties missing');
}
//......
});