前端笔记之NodeJS（三）Express&ejs模板引擎&请求识别
一、Express框架
1.1基本使用
创建http服务器特别麻烦，express框架解决了这个的问题。
Express在node界的地位，就相当于jQuery在DOM界的地位。jQuery的核心就是“批量”，1个jQuery对象中可以封装多个原生对象。Express的核心就是中间件，Express说大真心不大，主要是因为他做的事儿大，而不是这个框架的功能多。
中文官网（实际上也是英语的）：http://www.expressjs.com.cn/
基于 Node.js 平台，快速、开放、极简的 web 开发框架。
以后的项目都先创建项目身份证，记录依赖：
npm init
安装依赖：
npm install express --save
express框架的API非常简单
var express = require("express"); //返回的是一个函数 var app = express(); //创建app，express函数执行返回一个app对象 //当用户get请求访问/的时候 app.get("/", (req,res)=>{ //输出可用end()或send()方法，而且不用设置字符集，因为express封装好了 res.send("<h1>首页</h1>"); }) //当用户get请求访问/music的时候 app.get("/music", (req,res)=>{ res.send("<h1>音乐频道</h1>"); }) app.listen(3000, function(err){ console.log("3000端口") })
1.2路由设计
在路由字符串中“:”开头表示一个待定文本（用户决定）：
//当用户get请求访问/music的时候 app.get("/music/:bianhao", (req,res)=>{ var bh = req.params.bianhao; console.log(bh) res.send("<h1>编号为"+ bh +"音乐信息</h1>"); })
app.get("/:username/follower", (req,res)=>{
var user = req.params.username;
res.send("<h1>关注"+ user +"的人如下</h1>");
})
app.get("/student/:banji/:bianhao", (req,res)=>{
var banji = req.params.banji;
var bianhao = req.params.bianhao;
res.send("<h1>"+ banji +"班的"+ bianhao +"号学生信息</h1>");
})
看以下两个路由：冲突时
app.get('/music/*', function(req, res){
res.send('<h1>音乐频道子页面</h1>');
});
//当用户get请求访问/music/xxx的时候
app.get('/music/:bianhao', function(req, res){
var bh = req.params.bianhao;
res.send("<h1>编号为"+ bh +"音乐信息</h1>");
});
描述：如果中间件请求类型一样，而且url一样，那么前者会覆盖后者，先写的就会拦截请求，不会让请求流向下执行。
注意：
l 如果遇见覆盖问题，可以使用next()方法，而且覆盖的函数不能有res.send()
l 带一些数据/xxx/:username/:xuehao 获取的时候用req.params得到url
1.3中间件
express可以非常方便的使用动词来描述用户访问这个url的请求类型，实际上是Nodejs原生的req.method属性封装的。
概述：app.动词（上行请求类型），一共26种
http://www.expressjs.com.cn/4x/api.html#app.METHOD
var express = require("express"); //返回一个函数 var app = express(); //创建app，express函数执行返回一个app对象 //当用户get请求访问/的时候 app.get('/', function(req, res){ res.send('<h1>我是GET请求</h1>'); }); //拦截前端发过来的各种请求 //拦截POST请求 app.post('/tijiao', function(req, res){ res.send('<h1>我是POST请求</h1>'); }); //删除请求 app.delete('/del', function(req, res){ res.send('<h1>我是delete请求</h1>'); }); //更新某一条数据的请求 app.patch('/update', function(req, res){ res.send('<h1>我是patch请求</h1>'); }); //更新全部数据的请求 app.checkout('/updates', function(req, res){ res.send('<h1>我是checkout请求</h1>'); }); app.listen(3000,function(err){ console.log("3000端口") });
1.4响应输出方法
以下是node中响应输出的所有方法：
app.get('/', function(req, res){
// res.send('<h1>第一个输出方法</h1>');
//输出JSON格式的数据
// res.json({name:"小明", age:12, hobby:["吃饭","睡觉"]});
//输出JSONP格式的数据
// res.jsonp({name:"小明", age:12, hobby:["吃饭","睡觉"]});
//重定向
res.redirect("http://www.baidu.com/");
});
前面学习过fs模块，它主要是文件操作：
fs.readFile(path, function(err,data){ })
在express中封装了一个函数叫sendFile()
//渲染一个文件 app.get("/ddd",(req,res)=>{ console.log(__dirname); //表示当前文件的绝对路径 res.sendFile(__dirname + "/images/1.jpg"); })
1.5静态资源服务
概述：express框架提供了一个方法，可以静态出一个文件夹(自动路由)；含义就是静态出去的文件夹当中文件之间，你可以使用相对路径，最爽的一件事，是静态出去的文件夹中的全部的文件你可以不用写路由了，因为express已经帮你做完了；
现在项目中有一个www文件夹，此时要提供自动静态化路由：
var express = require("express"); //返回的是一个函数 var app = express(); //创建app，express函数执行返回一个app对象 //静态化一个文件夹（提供自动路由） app.use(express.static("www")) app.listen(3000, ()=>{ console.log("3000端口") })
还可以给它改名：
app.use("/web", express.static("www"))
var express = require("express"); //返回的是一个函数 var app = express(); //创建app，express函数执行返回一个app对象 //静态化一个文件夹（提供自动路由） // app.use(express.static("www")) app.use("/web", express.static("www")) app.get("/", (req,res)=>{ res.send("<h1>首页</h1>") }) app.listen(3000)
二、ejs模板引擎
ejs是JavaScript模板库，用来从JSON数据中生成HTML字符串。
问题：我们可以呈递一个HTML页面，通过静态化www文件夹，sendFile。如果HTML页面上有待定的内容，怎么办？
使用模板引擎，模板引擎叫ejs（embed.js，嵌入式js）
npm init npm install --save express npm install --save ejs
┣ views
┃ ┣ index.ejs
┣ app.js
准备JSON数据：
data.json：
[ { "name" : "小明", "url" : "xiaoming" } ..... ]
app.js：
var express = require("express"); var app = express(); //设置默认使用的模板引擎 app.set("view engine", "ejs"); app.get("/", (req,res)=>{ res.render("index"); //不需要写res.render("./views/index.ejs"); }) app.listen(3000, ()=>{ console.log("3000端口") })
views/index.ejs文件：
<!DOCTYPE html> <html lang="en"> <head> <meta charset="UTF-8" /> <title>Document</title> </head> <body> <h1>我是首页!!!!</h1> </body> </html>
注意：
扩展名必须是ejs，不是html
文件夹必须叫views，如果想改名，用以下方法：
app.set("views", "shitu");
ejs的使用类似underscore的模板标记<% %>和<%= %>来当做模板，与现有的html标记混用。和php干的事情是一样的。
<html> <head> <title>首页</title> </head> <body> <h1>你好，我是首页</h1> <ul> <% for(var i = 0; i < students.length; i++){ %> <li><%= students[i] %></li> <% } %> </ul> <select> <% for(var i = start; i <= end; i++){ %> <option value="<%= i %>"><%= i %></option> <% } %> </select> </body> </html>
此时render的时候要模板传递数据：
//设置默认使用的模板引擎 app.set("view engine" , "ejs"); app.get("/",(req,res)=>{ res.render("index",{ "students" : ["小明","小红","小强","小钢炮"], "start" :1970, "end" : 2018 }); }); app.listen(3000,()=>{ console.log(3000); });
有时候render之前需要查数据，此时有点MVC的感觉了：
var fs = require("fs"); app.get("/",(req,res)=>{ //先去读取“模拟数据库” fs.readFile("./data/users.json",(err,data)=>{ //得到了数据 var arr = JSON.parse(data.toString()); //呈递页面 res.render("index",{ "students" : arr }); }); }); app.get("/:username",(req,res)=>{ //得到待定用户名 var username = req.params.username; //先去读取“模拟数据库” fs.readFile("./data/users.json",(err,data)=>{ //得到了JSON数据 var arr = JSON.parse(data.toString()); //遍历，看看谁的url和当前username相同 arr.forEach((item)=>{ if(item.url == username){ //呈递页面渲染 res.render("myhome",{ "name" : item.name }); } }); }); });
data.json：
[ { "name" : "小明", "url" : "xiaoming" } ]
myhome.ejs ：
<html> <body> <div class="container"> <h1><%= name %>的小家</h1> </div> </body> </html>
index.ejs：
<li><a href="<%= students[i].url %>"> <%= students[i].name %> </a></li>
三、复习
npm常用命令：
npm init
创建一个package.json文件
npm install --save xxx
从npm下载包，自动安装到当前目录的node_modules文件夹，并添加依赖到package.json的dependencies对象（--save可简写为-S）
npm install --save-dev xxx
从npm下载包，自动安装到当前目录的node_modules文件夹，并添加依赖到package.json的devDependencies对象(--save-dev可简写为 -D）
npm install xxx -g
安装在全局环境中
npm root -g
查看全局路径
npm install
自动安装package.json的dependencies对象列出的所有依赖包（install可简写为i）
npm uninstall express --save
卸载指定的模块
npm update express --save
更新指定的模块
npm cache
管理模块的缓存
npm cache clean
清除模块缓存
另外，要学会使用淘宝镜像，会自己研究各种包的API。
cnpm install express --save
Express框架
之前用fs.readFile()配合if(req.url)来读取静态文件。
if(req.url == "/aaa"){ fs.readFile("./images/ddd.png" , function(err , data){ res.end(data) }); }
Express框架，提供了http服务器和很多中间件，并且简化了路由表的编写。
现在只需要一条语句就可以将一个文件夹自动提供路由。
app.use(express.static("www"));
www表示需要自动提供路由的那个文件夹，类似于Apache的根目录。
在url中用冒号开头引导一个变量，可以立刻用req.params.变量来得到待定值
app.get("/:nian/:yue/:ri" , function(req,res){
var nian = req.params.nian;
var yue = req.params.yue;
var ri = req.params.ri;
res.send(nian + "年" + yue + "月" + ri + "日");
});
版本号
{ "dependencies" :
{ "foo" : "^1.0.0", //→固定住了1代大本版号，小版本号随意
"bar" : ">2.1.2", //→必须大于2.1.2版本号
"baz" : ">1.0.2 <=2.3.4", //→且
"boo" : "2.0.1", //→必须完全匹配这个版本号，下载的就是2.0.0
"qux" : "<1.0.0 || >=2.3.1 <2.4.5 || >=2.5.2 <3.0.0", //→三个区间随便选
"asd" : "http://asdf.com/asdf.tar.gz", //→指定一个地址
"til" : "~1.2", //→近似找到1.2，能多近就多近，能找到1.2就用1.2，不能就尽量近
"elf" : "~1.2.3",
"thr" : "3.3.x", //→3.3必须固定，最后一位随意
"lat" : "latest", //→最新版本
"dyl" : "*", //→任意版本，随意！,
"xxx" : "1.0.0 - 2.9999.9999", //→大于等于且小于等于
}
}
四、Nodejs请求识别
4.1 GET和POST请求介绍
比如请求一个报名表的网页，一般情况下访问时，服务器都返回相同内容
l 想要访问一个页面，返回不同的内容，如何解决？
比如希望男生和女生得到的报名表不同，最简单的办法就是请求不同的网页地址：
因为性别只有两个，所以请求不同的页面感觉不出复杂，但如果是不同的国籍，全球有190多个国家，那么页面就太多了。
解决办法有两种：
第一种：用GET请求，通过URL地址加上?引导的k=v&k=v，将自己的个性化数据告诉服务器
GET是得到的意思，指的是希望以一些参数，得到丰富的网页信息。
第二种：POST请求携带报文体
POST请求使用http请求的报文体来携带数据，传给服务器。
POST的意思是“投递”的意思，此时语义上，我们发出POST请求希望服务器持久这些数据。
淘宝买东西，你就是浏览器，卖家是服务器，你要将收货信息告诉卖家，有两种方式：
方法1：收货地址：广州天河区棠东东路御富科贸园D座108室（来了不要打电话直接放前台打电话也不接否则就差评谢谢）
如同GET请求
方法2：收货地址：广州天河区棠东东路御富科贸园D座108室
留言：（来了不要打电话直接放前台打电话也不接否则就差评谢谢）
如同POST请求
4.2 GET请求（使用express）
GET、POST请求，都是上行请求，都是把数据从浏览器带向服务器的方式。
现在不是如何发送请求，表单和Ajax都能发送GET、POST请求。现在问题是如何用node识别浏览器发送过来的请求（识别传递过来的参数）。
写一个路由，希望用get请求单独得到某一个用户的信息：
var url = require("url"); var express = require("express"); var app = express(); //静态化www文件夹，可以在www中写前端代码 // app.use(express.static("www")); var arr = [ {"id" : 10001, "name":"小明", "sex":"男"}, {"id" : 10002, "name":"小红", "sex":"女"}, {"id" : 10003, "name":"小黑", "sex":"男"} ] app.get("/people" , function(req,res){ console.log(req.url) }) app.listen(3000);
为了得到GET请求的id参数，使用nodejs提供的url模块的url.parse()方法：
//当用户用get请求访问people的时候 app.get("/people" , function(req,res){ //得到get请求的参数 var id = url.parse(req.url, true).query.id; //如果用户没有传id参数，则显示所有人信息 if(!id){ res.json(arr); return; } //遍历数组，得到id和url的id参数相同的人 for(var i = 0;i < arr.length;i++){ if(arr[i].id == id){ res.json(arr[i]) // res.send("我是服务器已经收到请求，返回的数据是：" + arr[i].name) } } //存储前端提交的数据到数组 arr.push(obj); console.log(arr) })
这个叫做接口，所谓的接口就是显示JSON数据，而不是显示HTML界面的网页
没有传id参数，则显示所有人
接口不是给人看的，是返回给前端的，前端用来发出Ajax请求调用得到，得到数据后渲染在页面中。
前端可以借助Ajax发出请求调用接口地址，拿到数据。
<input type="text" id="idTxt"> <button>GET请求-查询</button> //点击发起查询请求 $("button").eq(0).click(function(){ $.get("/people",{id:$("#idTxt").val() }, function(data){ console.log(data) }) });
升级一下案例：
www/index.html前端主页
<body> <p>I D ：<input type="text" class="idTxt" /></p> <p>姓名：<input type="text" class="name" /></p> <p>性别： <input type="radio" name="sex" value="男" class="sex" />男 <input type="radio" name="sex" value="女" class="sex" />女 </p> <p> 爱好： <input type="checkbox" class="hobby" value="游泳">游泳 <input type="checkbox" class="hobby" value="看书">看书 <input type="checkbox" class="hobby" value="打球">打球 </p> <button>GET请求-提交保存</button> </body>
前端提交的时候，复选框要写IIFE才能遍历多选的数组：
//点击提交到后端，存储信息 $("button").eq(1).click(function(){ var id = $(".idTxt").val(); var name = $(".name").val(); var sex = $(".sex:checked").val(); var hobby = (function(){ var arr = []; $(".hobby:checked").each(function(){ arr.push($(this).val()) }) return arr; })(); //发起请求 $.get("/people",{id:id,name:name,sex:sex,hobby:JSON.stringify(hobby)}, function(data){ console.log(data) }) });
数组中jQuery中发送Ajax的时候，会自作主张的给键名加上[]后缀：
解决方法两种：
1、前端提交JSON.stringify(数组); 后端JSON.parse(数组);
"hobby":JSON.stringify(hobbys)
2、使用jquery的ajax()函数的traditional参数
$.ajax({ url:"/people", data: {id:id, name:name, sex:sex, hobby:hobby}, success:function(data){ console.log(data) }, traditional:true })
前端是JS，后端也是JS，Ajax提交的参数，不变形。
4.3 POST请求（使用express）
POST请求的信息不在URL中，而是在请求的报文体中，所以不能通过req.url的形式得到数据，此时使用formidable模块。
POST请求是用来发送大量的数据给服务器，希望服务器持久这些数据，表单的提交的。Nodejs非常害怕大内容，因为如果你上传1G的内容，此时会把进程阻塞，但是Nodejs很聪明，它把浏览器传来的大内容分成一个个包来进行传输，一个包传输完毕，就是一个切断点，nodejs就能给别的人提供服务。
https://www.npmjs.com/package/formidable
npm install --save formidable
app.js后端，使用formidable包的标准语法：
//拦截前端发送的POST请求 app.post("/tijiao" , function(req,res){ //下面两行代码是标准语法 //这是formidable的构造函数，产生一个form表单对象 var form = new formidable.IncomingForm(); form.parse(req, function(err, data){ arr.push(data); //将前端提交的数据存储到数组中 res.send("ok"); //告诉前端 }); });
前端发出POST请求
//************** POST请求 ***************** $("button").eq(2).click(function(){ var id = $(".idTxt").val(); var name = $(".name").val(); var sex = $(".sex:checked").val(); $.ajax({ url:"/tijiao", type:"post", data: {id:id, name:name, sex:sex}, success:function(data){ if(data == "ok"){ alert("添加成功"); } }, traditional:true }) });
formidable还能处理文件的上传，它使用链路层协议进行传输，比HTTP快很多：
app.post("/tijiao" , function(req,res){
var form = new formidable.IncomingForm();
//设置上传的文件目录
form.uploadDir = "./uploads";
//保留文件扩展名
form.keepExtensions = true;
form.parse(req, function(err, fields, files) {
arr.push(fields); //存储数据
console.log(fields); //fields表示普通文本（文本、单选、复选等）
console.log(files); //files表示文件
res.send("ok"); //告诉前端
});
});
用form表单提交，前端表单加上enctype属性，文件控件要有name属性。
<form action="/tijiao" method="post" enctype="multipart/form-data"> <p><input type="file" name="files" ></p> <p><input type="submit" value="提交" ></p> </form>
给上传成功的文件改名：
app.post("/tijiao" , function(req,res){
var form = new formidable.IncomingForm();
//设置上传的文件目录
form.uploadDir = "./uploads";
//保留文件扩展名
form.keepExtensions = true;
form.parse(req, function(err, fields, files) {
if(files.files.name == ''){//如果表单不存在
res.send("请上传文件");
return;
}
//改名函数fs.rename(原路径,新路径,callback)
fs.rename("./"+ files.files.path, "./"+files.files.path + files.files.name,function(err){
if(err){
res.send("重命名失败！")
}else{
res.send("重命名完成！")
}
});
});
});
4.4其他请求识别
jquery特别符合w3c规范，express也特别符合。它们配合可以用不同的请求类型：
$("button").eq(3).click(function(){
$.ajax({
type : "checkout",
url : "/update",
data : {"id":10001},
success : function(data){
if(data == "ok"){
alert("更新成功！");
}
}
})
});
$("button").eq(4).click(function(){
$.ajax({
type : "delete",
url : "/remove",
data : {"id":10001},
success : function(data){
if(data == "ok"){
alert("删除成功！");
}
}
})
});
后端app.js
// 其他请求 app.checkout("/update", function(req,res){ res.send("ok"); //告诉前端 }); app.delete("/remove", function(req,res){ res.send("ok"); //告诉前端 });
总结：
① get请求在nodejs中用url.parse(req.url,true).qurey识别
② post、checkout等所有其他请求，在Nodejs中用formidable包识别
文章都是本人学习时的笔记整理，希望看完后能对您有所帮助，欢迎大家提意见，多多交流。
也有些文章是转载的，如果存在转载文章且没有标注转载地址的，请与我联系，马上处理。
自由转载-非商用-非衍生-保持署名。
