前端笔记之NodeJS(三)Express&ejs模板引擎&请求识别
一、express框架
1.1基本使用
创建http服务器特别麻烦,express框架解决了这个的问题。
express在node界的地位,就相当于jquery在dom界的地位。jquery的核心就是“批量”,1个jquery对象中可以封装多个原生对象。express的核心就是中间件,express说大真心不大,主要是因为他做的事儿大,而不是这个框架的功能多。
中文官网(实际上也是英语的):
基于 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就能给别的人提供服务。
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包识别