前端笔记之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包识别

---