Express是一个简洁而灵活的node.jsWeb应用框架,提供了一系列强大特性帮助你创建各种Web应用,和丰富的HTTP工具。使用Express可以快速地搭建一个完整
Express 是一个简洁而灵活的 node.js Web应用框架, 提供了一系列强大特性帮助你创建各种 Web 应用,和丰富的 HTTP 工具。
- 使用 Express 可以快速地搭建一个完整功能的网站。
- Express 框架核心特性:
- 可以设置中间件来响应 HTTP 请求。
- 定义了路由表用于执行不同的 HTTP 请求动作。
- 可以通过向模板传递参数来动态渲染 HTML 页面。
前提知识
创建项目
这里我们使用npm初始化一个项目,直接回车使用默认参数
$ mkdir ~/myExpress
$ cd ~/myExpress
$ npm init
$ npm install express --save
$ touch app.js
基础示例
使用IDE打开项目(推荐Vscode或者WebStorm) 编辑app.js文件
// 引入依赖
var express = require('express')
var app = express()
// 定义port常亮
const port = 3030;
// 创建一个简单GET路由
app.get("/",function(req,res){
res.send("Hello,World");
});
// 启动服务,第二个参数为callback()
app.listen(port,function(){
console.log(`Express 应用启动在${port} 端口`);
});
命令行切换到app.js目录下
$ node app.js
打印出Express 应用启动在3030 端口
,在浏览器或者CURL访问http://localhost:3030即可看到Hello,World
$ curl -XGET http://localhost:3030/
路由设置
在上面的代码示例中我们使用了一个简单HelloWorld代码,使用了GET的请求方式,同样的Express也支持其他的Method,如POST,PATCH,DELETE等等,下面我们简单的写一下
// 引入依赖
var express = require('express')
var app = express()
// 定义port常亮
const port = 3030;
// 创建一个简单GET路由
app.get("/",function(req,res){
res.send("Hello,World");
});
app.post("/post",function(req,res){
var method = req.method;
res.send(`发现${method} 请求`)
});
app.patch("/patch",function(req,res){
var method = req.method;
res.send(`发现${method} 请求`)
});
app.delete("/delete",function(req,res){
var method = req.method.name;
res.send(`发现${method} 请求`)
});
// 启动服务,第二个参数为callback()
app.listen(port,function(){
console.log(`Express 应用启动在${port} 端口`);
});
如果你需要添加全部的请求方式,可以使用app.all(path,callback);
由于POST等请求不能再浏览器输入地址访问,这里我们继续使用CURL来测试,没有这个工具的可以使用PostMan测试.
$ curl -XGET http://localhost:3030
Hello,World
$ curl -XPOST http://localhost:3030/post
发现POST 请求
$ curl -XPATCH http://localhost:3030/patch
发现PATCH 请求
$ curl -XDELETE http://localhost:3030/delete
发现DELETE 请求
静态文件
Express可以设置某个目录为静态文件目录,里面的资源我们可以直接通过URL访问,在app.js同级目录下执行以下脚本
$ mkdir public && cd public
$ echo "这里是静态资源文件内容
> ./static.html
修改app.js
文件,添加以下代码
app.use(express.static('public'))
访问http://localhost:3030/static.html
$ curl -XGET http://localhost:3030/static.html
这里是静态资源文件内容
同样的,你也可以放入其他类型的资源,如JSON文件,图像,纯文本,CSS等.
Route模块
在上面示例中,我们可以使用下面的代码创建路由
var express = require('express')
var app = express()
app.get("/",function(req,res,next){})
app.get("/book",function(req,res,next){})
app.post("/book",function(req,res,next){})
显然这样并不利于我们的代码管理,因此这里引入express.Route
模块来模块化处理路由,下面我们有如下需求:
创建 GET /
创建 GET /book/nodejs
创建POST /book/
其中 /book/**单独存放于路由模块中
app.js
同级目录下创建book.js
文件代码内容如下:
var express = require('express');
// 创建router
var router = express.Router();
// 在router中设置路由
router.get('/:id', function (req, res, next) {
var book = {
id: req.params.id,
name: "深入浅出NodeJS"
};
res.send(JSON.stringify(book))
});
router.post("/", function (req, res, next) {
res.send("POST /book")
});
// 对外暴露
module.exports = router;
同样的app.js
则需要引入上面router文件
// 引入依赖
var express = require('express')
var app = express()
// 引入router
var book_router = require('./book')
// 定义port常亮
const port = 3030;
// app 使用该router
app.use('/book',book_router)
// 创建一个简单GET路由
app.get("/",function(req,res){
res.send("Hello,World");
});
// 启动服务,第二个参数为callback()
app.listen(port,function(){
console.log(`Express 应用启动在${port} 端口`);
});
启动应用,在命令行中访问,即结果如下:
$ curl -XGET http://localhost:3030/
Hello,World
$ curl -XGET http://localhost:3030/book/ISBN-123
{"id":"ISBN-123","name":"深入浅出NodeJS"}
$ curl -XPOST http://localhost:3030/book/
POST /book
NodeJs中的中间件
中间件,英文middleWare
,假设我们需要在控制台打印所有请求的消耗的时间信息,以及URL,那么我们给每个路由都加上代码,显然是很愚蠢的,那么我们可以为这些路由请求设置中间件,利用中间件来而完成统计.
修改appjs
代码为以下内容:
// 引入依赖
var express = require('express')
var app = express()
const port = 3030
/**
* 定义中间件函数
* @param req ---> requesr
* @param res ---> response
* @param next ---> 将请求传递到下一个中间件函数
*/
function logMiddleWare(req, res, next) {
var url = req.originalUrl;
// 记录开始执行时间
var start = Date.now();
// 向request中写入数据,在后面的中间件函数中可以获取到该参数
req.start_time = start
// 执行下一个中间件函数(在这里也就是路由的callback)
next();
// 记录完成时间
var end = Date.now();
// 打印日志
console.log(`${url} 请求完成时间:`, end - start, "ms");
}
// 使用该中间件
app.use(logMiddleWare)
app.get("/time", function (req, res, next) {
console.log(`获取到的参数start_time = ${req.start_time}`);
res.send(`/${req.start_time}
`);
});
// 服务启动
app.listen(port, function () {
console.log(`服务启动在${port} 端口`);
});
我们测试以下:
curl -XGET http://localhost:3030/time
返回1541220185998
,这里主要看一下控制台打印的信息
服务启动在3030 端口
获取到的参数start_time = 1541220185998
/time 请求完成时间: 6 ms
可以看到,首先是服务启动在3030 端口信息,接着我们开始请求/time,记录下了start_time,并写入到request中,接着在/time的回调函数中打印了该参数,执行完成之后,继续返回到 logMiddleWare 中记录下end_time,打印出耗时 6 ms
集成持久层(redis)
NodeJS支持多种数据库持久操作,比如常用的Redis,Mysql,MongoDB等等,那么这里我们简单的使用redis作为测试以下.首先说一下需求:
Ps: 这里我是用了docker来部署了一个redis服务器,如下
$ docker pull redis
$ docker run -d -p 6379:6379 --name redis_6379 redis
$ docker ps # 观察Redis运行情况
# 重启redis `docker restart redis_6379`
首先你需要安装redis依赖,项目目录下执行npm install redis --save
安装即可,修改app.js
内容如下
// 引入依赖
var express = require('express');
var redis = require('redis')
var app = express()
const port = 3030
const redis_port = 6379
// 创建Redis client 端口为6379
var client = redis.createClient(redis_port,'localhost');
/**
* 设置Redis的回调事件,当redis出现连接失败的时候,执行之
*/
client.on('error',function (error) {
console.log("Redis 连接出现异常")
});
app.post("/redis/:content",function (req, res, next) {
var cOntent= req.params.content;
// 设置字符串到redis中 KV结构
client.set('KEY',content)
res.send("Redis设置完成")
})
app.get("/redis",function (req, res, next) {
client.get('KEY',function (err, value) {
res.send(value)
})
})
// 服务启动
app.listen(port, function () {
console.log(`服务启动在${port} 端口`);
});
测试内容如下
$ curl -XPOST http://localhost:3030/redis/Keep_it_simple_and_stupid
Redis设置完成
$curl -XGET http://localhost:3030/redis
Keep_it_simple_and_stupid
当然也可以在Redis客户端中查询数据