欢迎您访问程序员文章站本站旨在为大家提供分享程序员计算机编程知识!
您现在的位置是: 首页

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

程序员文章站 2022-07-02 16:10:17
...

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

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

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

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后获取参数值。

  1. 获取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 - -

页面显示如图

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

path传参

  1. 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  
+ aaa@qq.com  
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 %>,最后得到的页面如下。

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

ejs

总结

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

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