node Express 框架
发布于 1 个月前 作者 melovemingming 614 次浏览 来自 分享

Express框架

简单介绍一下

Express事实上Node内置的http模块上构建的一层抽象。理论上所有Express实现的功能都能用Node实现 核心特征;

  1. 设置中间件响应http请求
  2. 定义路由表,执行不同的http请求
  3. 先模板传递参数,来动态的渲染html文件

一些网址

npm的Express https://www.npmjs.com/package/express 项目地址 https://github.com/expressjs/express 网址和文档 http://expressjs.com/ 翻译的中文文档 http://expressjs.com/zh-cn/

安装Express

使用npm安装,并将其保存进入依赖列表中 由于一堵高不可攀的墙大人的问题,所以呢,被迫使用cnpm,使用来自淘宝的镜像,由淘宝完成镜像的同步 节省一点点宝贵的时间(^o^)/

全新安装的需要安装淘宝的镜像 https://npm.taobao.org/ 使用cnpm代替npm完成安装

-save 的意思为自动更新依赖文件,依赖文件为package.json

PS C:\Users\mingm\Desktop\test\Express> cnpm install express --save
√ Installed 1 packages
√ Linked 46 latest versions
√ Run 0 scripts
Recently updated (since 2018-07-21): 1 packages (detail see file C:\Users\mingm\Desktop\test\Express\node_modules\.recently_updates.txt)
√ All packages installed (51 packages installed from npm registry, used 3s(network 3s), speed 291.62kB/s, json 47(354.74kB), tarball 535kB)
PS C:\Users\mingm\Desktop\test\Express>

查看依赖pacage.json文件

{
  "dependencies": {
    "express": "^4.16.3"
  }
}

可以看到依赖的是express的4.16.3版本

查看一下目录

PS C:\Users\mingm\Desktop\test\Express> ls


    目录: C:\Users\mingm\Desktop\test\Express


Mode                LastWriteTime         Length Name
----                -------------         ------ ----
d-----        2018/7/28     18:35                node_modules
-a----        2018/7/28     18:35             53 package.json


PS C:\Users\mingm\Desktop\test\Express>

可以查看到有一个node_modules目录,该目录保存的是npm包

一些还需要安装的模块

body-parser 一个node的中间件 用于处理JSON,等和URL的编码的处理 https://www.npmjs.com/package/body-parser 文档以及项目地址 https://github.com/expressjs/body-parser cookie-parser 一个负责解析Cookie的工具可以将传过来的Cookie将其转换为对象 https://www.npmjs.com/package/cookie-parser multer node.js的中间件 处理表单数据 项目地址 https://github.com/expressjs/multer npm https://www.npmjs.com/package/multer 自诉文件 https://github.com/expressjs/multer/blob/master/doc/README-zh-cn.md 原版的自述文件 https://github.com/expressjs/multer/blob/master/README.md 好啦。一共是一块安装了3个模块 继续使用淘宝源

PS C:\Users\mingm\Desktop\test\Express> cnpm install body-parser --save
√ Installed 1 packages
√ Linked 0 latest versions
√ Run 0 scripts
√ All packages installed (used 248ms(network 242ms), speed 23.48kB/s, json 1(5.68kB), tarball 0B)
PS C:\Users\mingm\Desktop\test\Express> cnpm install cookie-parser --save
√ Installed 1 packages
√ Linked 0 latest versions
√ Run 0 scripts
√ All packages installed (used 264ms(network 258ms), speed 4.99kB/s, json 1(1.29kB), tarball 0B)
PS C:\Users\mingm\Desktop\test\Express> cnpm install multer --save
√ Installed 1 packages
√ Linked 21 latest versions
√ Run 0 scripts
√ All packages installed (22 packages installed from npm registry, used 1s(network 1s), speed 307.56kB/s, json 22(92.57kB), tarball 343.86kB)
PS C:\Users\mingm\Desktop\test\Express>

完成三个模块的安装 查看一下依赖文件

{
  "dependencies": {
    "body-parser": "^1.18.3",
    "cookie-parser": "^1.4.3",
    "express": "^4.16.3",
    "multer": "^1.3.1"
  }
}

依赖四个模块

创建一个框架实例

输出hello world!

// app.js文件
var express = require('express');
var app = express();

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

var server = app.listen(1938, () => {
	var host = server.address().address;
	var port = server.address().port;

	console.log('%s:%s', host, port);
})
PS C:\Users\mingm\Desktop\index\Express> node app.js
:::1938

此程序会监听1938上的连接,当有连接传入的时候,应用程序会以hello world!进行响应,然后将其返回。

路由

路由决定了由谁响应http请求,通过提取GET和POST请求的参数,下面继续扩展程序

PS C:\Users\mingm\Desktop\index\Express> node app.js
{ address: '::', family: 'IPv6', port: 1937 }
var express = require('express');
var app = express();

// 输出hello world
app.get('/', (req, res) => {
	console.log('输出对于主页的GET请求');
	res.send('Hello GET!');
});

// post请求
app.post('/', (req, res) => {
	console.log('主页post请求');
	res.send('Hello POST');
});

// 对于/del_user的页面响应
app.get('/del_user', (req, res) => {
	console.log('这是对于页面 /del_user页面的响应');
	res.send("Hello del_user");
	res.send("你好哈! 这里已经将页面进行删除");
});

// /list_user 页面的GET请求
app.get('/list_user', (req, res) => {
	console.log('这里是对 /list_user页面的请求');
	res.send('Hello list_user');
});

// /对页面abcd abcdxcd ab123cd 的请求进去正则
app.get('ab*cd', (req, res) => {
	console.log('进行了正则');
	res.send('hello 正则!');
});

// 启动http服务器
var server = app.listen(1937, () => {
	console.log(server.address());
});

访问 http://127.0.0.1:1937/del_user 返回 Hello del_user 好啦!(^o^)/

解析静态文件

Express使用了中间件 express.static中间件设置静态文件

事实上是一个http服务器外加一个fs模块完成封装的

目录结构如下

- Express  // 站点文件
    - image // 图片文件夹
        1.gif   // 将要访问的静态资源
    + node_modules  // npm包所在文件夹
    app.js      // 入口文件
    package.json    // 配置文件

代码如下

PS C:\Users\mingm\Desktop\index\Express> node app.js
{ address: '::', family: 'IPv6', port: 1937 }

var express = require('express');
var app = express();

app.use(express.static('./image'));		// 使用中间件 express.static 设置的静态资源文件夹为image

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

var server = app.listen(1937, () => {
	console.log(server.address());
});

访问 http://127.0.0.1:1937/1.gif 出现静态资源,(^o^)/

GET方法

res.sendFile() http://expressjs.com/en/4x/api.html#res.sendFile

__dirname 获取当前执行文件所在目录的完整目录名 res.sendFlie(path [,options] [,fn]) path必须为绝对路径,Content-Type 会根据扩展名设置相应的HTTP标头字段,需要注意的是path必须为绝对路径

__dirname 获取当前执行文件所在目录的完整目录名 __filename 获取当前执行文件带有完整绝对路径的文件名 process.cwd() 获取当前执行node命令时候的文件夹的目录名 ./ 文件所在目录

req.query 此属性是一个对象,包含路由中每个查询字符串参数的属性。 304请求 一个条件请求,如果有缓存的数据则进行请求,否则将不会进行请求

<!doctype html>
<html>
<head>
	<title>Hello from</title>
	<meta charset="utf-8">
</head>
<body>
	<form action="/process_get" method="get">
		<label>first_name</label><input type="text" name="first_name"/>
		<label>last_name</label><input type="text" name="last_name"/>
		<input type="submit" value="Submit"/>
	</form>
</body>
</html>
var express = require('express');
var app = express();

app.use(express.static('public'));	// 加载中间件

app.get('/index.html', (req, res) => {	// 调用中间件指定的静态资源目录 public, 然后调用回调函数
	res.sendFile( __dirname + '/' + 'index.html');	// 输出html文件的绝对路径,采取的是拼接字符串的方式,设置http标头
});

app.get('/process_get', (req, res) => {
	// 输出json格式
	var response = {
		'first_name': req.query.first_name,	// 将http报文中 查询到的first_name的值作为属性值
		'last_name': req.query.last_name	// 同上
	};
	console.log(response); // 输出获取到的json的值
	res.end(JSON.stringify(response));	// 将获取到的值转为JSON格式的值,然后进行返回
});

var server = app.listen(1937, () => {
	console.log(server.address());
});

用浏览器查看一下json数据 请求为get 发送的url为 http://127.0.0.1:1937/process_get?first_name=ming&last_name=ming 查询的字符串为 first_name=ming last_name=ming 总共,请求头为

Host: 127.0.0.1:1937
User-Agent: Mozilla/5.0 (Windows NT 10.0; Win64; x64; rv:61.0) Gecko/20100101 Firefox/61.0
Accept: text/html,application/xhtml+xml,application/xml;q=0.9,*/*;q=0.8
Accept-Language: zh-CN,zh;q=0.8,zh-TW;q=0.7,zh-HK;q=0.5,en-US;q=0.3,en;q=0.2
Accept-Encoding: gzip, deflate
Referer: http://127.0.0.1:1937/
Cookie: hibext_instdsigdipv2=1
Connection: keep-alive
Upgrade-Insecure-Requests: 1

主机地址为127.0.0.1:1937 user-Agent为本地的系统的一些信息 剩下的有点看不懂。。╮(╯▽╰)╭ 由于设置的是直接返回JSON数据,所以查看一下响应头

{"first_name":"ming","last_name":"ming"}

此为响应载荷 报文为

HTTP/1.1 200 OK
X-Powered-By: Express
Date: Sat, 28 Jul 2018 16:39:08 GMT
Connection: keep-alive
Content-Length: 40

采用的是http1.1协议,返回的报文为200 同理 DevTol也是如此不在进行阐述

下面进行POST请求

需要使用一个中间件 body-parser,其简单的文档 https://www.npmjs.com/package/body-parser

需要使用一个bodyParser.urlencoded 该对象返回解析urlencoded主体。在返回的body中,将会在req对象上添加一个新的对象,该对象为body。其中的值为字符串和数组,此对象会包含键值对。其中的值可以为字符串和数组(此时设置的extended的值为false),其中的值允许为任何类型的需要设置extended的值为last

var express = require('express');
var app = express();
var bodyParser = require('body-parser');	// 加载Express中间件

// 使用中间件提供的bodyParser.urlencoded对来自于post的url进行解析,只允许字符串和数字类型的结果
var urlencodeParser = bodyParser.urlencoded({ extended: false });

app.use(express.static('public'));	// 设置静态资源目录为public

// 进行路由匹配
app.get('/index.html', (req, res) => {
	res.sendFile(__dirname + '/' + 'index.html');	// 路径的拼接,拼接的是当前文件的所在目录的绝对地址,由于要请求静态资源,自动跳到public文件夹下进行返回
});

// post请求的匹配
app.post('/process_post', urlencodeParser, (req, res) => {	// 先进行回调第一个函数,将post请求,使用中间件进行处理,处理完后的值进行返回到req和res即下一个回调函数,数据经过两次回调
	// 输出JSON格式
	var response = {
		'first_name': req.body.first_name,	// 进行键值对的保存
		'last_name': req.body.last_name	
	};
	console.log(response);	// 将接收到的数据进行输出
	res.end(JSON.stringify(response));	// 将键值对保存的对象转化为JSON格式返回给客户端
});

var server = app.listen(1937, () => {	// 开启http服务器
	console.log(server.address());
});
<!doctype html>
<html>
<head>
	<title>Hello from</title>
	<meta charset="utf-8">
</head>
<body>
	<form action="/process_post" method="POST">
		<label>first_name</label><input type="text" name="first_name"/>
		<label>last_name</label><input type="text" name="last_name"/>
		<input type="submit" value="Submit"/>
	</form>
</body>
</html>

ok~ 好啦。访问 http://127.0.0.1:1937 顺便打开浏览器开发者工具进行查看返回的JSON数据

{"first_name":"ming","last_name":"ming"}

♪(^∇^*)完美~

文件上传

使用post方法完成文件的上传。

from 表单的enctype属性当method属性值为post的时候,enctype提交的是from给服务器内容的mime类型,即媒体类型,

解释一下form表单的enctype的三个值

http的post方法,给服务器时,请求主题类型由 Content-Type 指定,通常一个POST请求是通过HTML表单发送的,并返回给服务器返回修改的结果,form表单的enctype属性是设置上传的编码的

application/x-www-form-urlencoded 数据被编码成为&进行分割的键值对同时以=作为分割的键值对。非字母和数字的字符会被进行百分比编码 解释 https://developer.mozilla.org/zh-CN/docs/Glossary/percent-encoding

multipart/form-data 将会以二进制的方式进行上传,上传文件的时候必须按照这个方法进行提交

text/plain 空格转化为+号,不对其做任何的处理进行提交

https://developer.mozilla.org/zh-CN/docs/Web/HTTP/Methods/POST

multer(opts) opts具有一个dest属性,将会告诉Multer中间件上传到服务器的位置。

multer(opts)接受链式调用.array(fieldname[, maxCount]) 支持一个是否为文件数组

/*
var express = require('express');
var app = express();	// 创建框架的类
var fs = require('fs');

var bodyParser = require('body-parser');	// 加载中间件
var multer = require('multer');
var storage = multer.diskStorage({ 
	destination: (req, file, cb) => {
		cb(null, './image')	// 文件上传的目录
	},
	filename: (req, file, cb) => {
		var fileFormat = (file.originalname).split(".");	// 先将文件名采用split按照.进行分裂
		cb(null, file.fieldname + '-' + Date.now() + '.' +  fileFormat[fileFormat.length - 1]);	// 对文件重命名,加上扩展名
	}
});	// 确定一下上传的配置选项


app.use(express.static('public'));	// 添加静态文件,用于处理静态文件,框架自带的
app.use(bodyParser.urlencoded({ extended: false }));	// 用于处理JSON等数据
app.use(multer({storage: storage}).array('image'));

app.get('/index.html', (req, res) => {
	res.sendFile( __dirname + '/' + 'index.html' );	// 对于首页的请求
});

// 该过程中间经历了对静态文件的(static中间件,urlencoded对url的解析,只允许字符串和数字的结果,使用了上传的multer的中间件,最后到回调函数)
app.post('/file_upload', (req, res) => {	// 允许上传多个文件,其中文件数组保存在req.files
	console.log(req.files[0]);	// 上传文件的信息
	 var des_file = __dirname + "/" + req.files[0].originalname;
   fs.readFile( req.files[0].path, function (err, data) {
        fs.writeFile(des_file, data, function (err) {
         if( err ){
              console.log( err );
         }else{
               response = {
                   message:'File uploaded successfully', 
                   filename:req.files[0].originalname
              };
          }
          console.log( response );
          res.end( JSON.stringify( response ) );
       });
   });
});

var server = app.listen(1937, () => {
	console.log(server.address());
});



*/

var express = require('express');
var app = express();
var fs = require("fs");
 
var bodyParser = require('body-parser');
var multer  = require('multer');
 
app.use(express.static('public'));
app.use(bodyParser.urlencoded({ extended: false }));
app.use(multer({ dest: '/tmp/'}).array('image'));	// 设置临时上传的地址
 
app.get('/index.htm', function (req, res) {
   res.sendFile( __dirname + "/" + "index.htm" );
})
 
app.post('/file_upload', function (req, res) {
 
   console.log(req.files[0]);  // 上传的文件信息
 
   var fileFormat = (req.files[0].originalname).split(".");
   var fileName = req.files[0].fieldname + '-' + Date.now() + "." + fileFormat[fileFormat.length - 1];
   var des_file = __dirname + "/image/" + fileName;	// 将要上传的地址

	console.log(des_file);
	fs.open( './image/' + fileName, 'a', function(err, fd) {
   if (err) {
       return console.error(err);
   }
  fs.readFile( req.files[0].path, (err, data) => {
	        fs.writeFile(des_file, data, (err) => {
	        console.log(data);
	         if( err ){
	              console.log( err );
	         }else{
	               response = {
	                   message:'File uploaded successfully', 
	                   filename:req.files[0].originalname
	              };
	          }
	          console.log( response );
	          res.end( JSON.stringify( response ) );
	      	 });
   		});    
});

  		
});
 
var server = app.listen(8081, function () {
 
  var host = server.address().address
  var port = server.address().port
 
  console.log("应用实例,访问地址为 http://%s:%s", host, port)
 
})

思路,是先将文件以追加的方式打开,然后将通过中间件上传的文件写入追加打开的文件

<html>
<head>
	<title>文件上传表单</title>
</head>
<body>
	<h3>文件上传</h3>
	<form action="/file_upload" method="post" enctype="multipart/form-data">
		<input type="file" name="image" size="50">
		<br>
		<input type="submit" value="上传文件">
	</form>
</body>
</html>

Cookie管理

使用中间件发送Cokie信息。 引入cookie-parser 再引入 util模块,将对象转换为字符串 这个很简单。过

回到顶部