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

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

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

node.js 11 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 11 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   add view  support (dust|ejs|hbs|hjs|jade|pug|twig|vash) (defaults to jade)  
        --no-view        use static html instead of view engine  
    -c, --css    add stylesheet  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%>的形式。

   
    

<%= title %>

Welcome to <%= title %>

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

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

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

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

ejs

总结

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

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

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

node.js 11 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 11 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   add view  support (dust|ejs|hbs|hjs|jade|pug|twig|vash) (defaults to jade)  
        --no-view        use static html instead of view engine  
    -c, --css    add stylesheet  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%>的形式。

   
    

<%= title %>

Welcome to <%= title %>

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

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

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

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

ejs

总结

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

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

你可能感兴趣的:(node.js 21 express 参数获取,模板引擎)