node.js 21 express参数获取,模板引擎

本文参考原文-http://bjbsair.com/2020-03-22/tech-info/2823/
今天上午看到有朋友留言问我，现在是不是流行koa2了。确实，国内看用koa2的不少，不过整个global来看，express的使用量依然很高，并且由于express出现的早，整个生态比较完备，所以还将会在很长一段时间内拥有较多的用户。

个人比较认可数据，刚刚去npm网站看了一下express和koa的下载量。对比图如下，今早新鲜出炉的数据。

express VS koa

express的周下载量达到了1190万，koa的周下载量目前是41万。尽管目前下载量对比express占优，但是koa具有自己的优势，后面我会有文章专门介绍koa。实际工作中，一方面我们需要使用成熟稳定的技术，但是也不能放松对新技术，新事物的了解，否则很快就会被这个飞速发展的时代抛下。IT人是需要活到老，学到老的。

接下来，回到本章需要介绍的内容。

express 参数获取

这里的参数分成几类，一类是用户在网页form中输入的信息，一类是url path中的信息，还有就是post中的参数怎么获取。

1. 获取用户在网页form中输入的信息

如果form使用的是GET方法，form中的信息会以下列形式在url中进行传递。

http://localhost:3000/create?name=Vincent&age=18

这个示例中form中有两个元素，分别是name和age。提交时，参数以这样的形式添加在url后面发送到服务端。

还是那句话，框架需要提供对原生功能的包装，尽可能让使用者快捷简单的使用功能。在express中，网页form的数据提交到服务端后，数据以键值对的形式保存在request.query对象中。**获取参数值，只需要使用request.query.**即可，示例如下：

let name = request.query.name;

假设我在浏览器的"name"文本框输入值Vincent,那么上面的代码就能够获取到"Vincent"。

比起node.js原生的获取参数的方法，express便捷了很多。node.js原生获取form中参数的方法需要首先手动引入url包，通过parse后，在调用query后获取参数值。

2. 获取url path中的参数

随着rest方式的普及，调用rest api时，会将参数值直接放在url的path中。示例，假设我们需要通过用户的名称获取用户的详细信息，那么可以采用下列的url

 http://localhost:3000/user/Vincent

在服务端的app.js中，首先要添加下列路由"/user/:name"。然后通过request.params获取参数的键值对。和form里面的参数保存不一样，path中的参数保存在request.params中。

app.get('/user/:name', function userIdHandler (req, res) {  
  console.log(req.params)  
})

那么我们在控制台可以看到下列信息，name的键值对在对象request.params中。

{ name: 'Vincent' }  
GET /user/Vincent 200 16.076 ms - 13

如果我们要传递多个参数，可以在path后面继续添加参数。

 http://localhost:3000/user/Vincent/age/18

在app.js中添加路由"/user/:name/age:age"。

app.use('/user/:name/age/:age',function(req, res, next) {  
  console.log(req.params);  
  res.send("name: " + req.params.name + ",  age: " + req.params.age);  
});

这是控制台输出里面就会多出age的键值对。

{ name: 'Vincent', age: '18' }  
GET /user/Vincent/age/18 304 3.396 ms - -

页面显示如图

path传参

3. POST方法传参

在第一点中我们采用的时form的GET方法传参，这是参数存放在request.query中。如果通过POST方法传参，参数保存在request.body中。

在app.js中，仍然使用app.js调用相关的router，假设此处我们使用的router名称是createRouter。

app.use('/create', createRouter);

在createRouter对应的js文件中，使用router.post()方法。

router.post('/', function(req, res, next) {  
  console.log("----------------------------------------------")  
  console.log(req.body)  
  console.log("----------------------------------------------")  
});

运行后，我们可以看到在控制台req.body的信息，这个一个对象，里面的信息以键值对的形式保存。

----------------------------------------------  
[Object: null prototype] {  
  name: 'Vincent',  
  age: '18'  
}  
----------------------------------------------

express 模板引擎

java的web应用会使用jsp作为view，早期的应用会直接通过servlet加html模板的方式，再好比现在Spring + thymeleaf。当然现在的前端技术已经日新月异了，各种前端框架层出不穷。作为一个web框架来讲，一定会有相关与前端配合的功能，否则得不到很好的使用和推广。

express默认支持多个模板引擎。在安装了express generator（可以参照我的上一篇express介绍进行安装）后，只需要在命令行输入"express -h"就可以看到所有的参数选项了。

D:\Projects\nodejs\NodeDemo\forms>express -h  
  Usage: express [options] [dir]  
  Options:  
        --version        output the version number  
    -e, --ejs            add ejs engine support  
        --pug            add pug engine support  
        --hbs            add handlebars engine support  
    -H, --hogan          add hogan.js engine support  
    -v, --view <engine>  add view <engine> support (dust|ejs|hbs|hjs|jade|pug|twig|vash) (defaults to jade)  
        --no-view        use static html instead of view engine  
    -c, --css <engine>   add stylesheet <engine> support (less|stylus|compass|sass) (defaults to plain css)  
        --git            add .gitignore  
    -f, --force          force on non-empty directory  
    -h, --help           output usage information

在这里，我们可以看到默认的模板引擎时jade，除了jade，还支持dust|ejs|hbs|hjs|jade|pug|twig|vash等模板引擎。

在运行命令"express"创建项目文件时，在app.js中默认使用的引擎是jade。

// view engine setup  
app.set('views', path.join(__dirname, 'views'));  
app.set('view engine', 'jade');

如果需要使用其他引擎来替代jade，比如ejs, 可以在创建项目时使用"express -e"命令。

如果项目已经创建完成，引擎将被切换为"ejs"，仍然可以使用上述的命令。

D:\Projects\nodejs\NodeDemo\node10>express -e  
  warning: option `--ejs' has been renamed to `--view=ejs'  
destination is not empty, continue? [y/N] y  
   create : public\  
   create : public\javascripts\  
   create : public\images\  
   create : public\stylesheets\  
   create : public\stylesheets\style.css  
   create : routes\  
   create : routes\index.js  
   create : routes\\users.js  
   create : views\  
   create : views\error.ejs  
   create : views\index.ejs  
   create : app.js  
   create : package.json  
   create : bin\  
   create : bin\www

同时该命令还会将app.js中的设置引擎的代码进行修改。

app.set('view engine', 'ejs');

这还不够，需要在当前的项目目录下安装ejs才能在后续运行。

D:\Projects\nodejs\NodeDemo\node10>npm install ejs --save  
+ [email protected]  
added 1 package from 2 contributors, removed 47 packages and audited 141 packages in 3.64s  
found 0 vulnerabilities

个人选用ejs，因为在ejs中变量的写法跟jsp基本相同，采用<%=variable%>的形式。

 <body>  
    <h1><%= title %></h1>  
    <p>Welcome to <%= title %></p>  
  </body>

使用时，只需要在router中将值传给变量即可。

router.get('/', function(req, res, next) {  
  res.render('index', { title: 'Express' });  
});

上面的代码中"index"表示使用index模板，即/views/index.ejs。{title:‘Express’}表示该模板使用的变量。传入之后，替代index.ejs中的<%= title %>，最后得到的页面如下。

ejs

总结

express参数获取的三种方式，模板引擎的使用和设置先介绍到这里。希望本篇能够让你在使用express的时候得到帮助。

如果有问题，欢迎朋友们留言讨论。