本文参考原文-http://bjbsair.com/2020-03-22/tech-info/2823.html
今天上午看到有朋友留言问我,现在是不是流行koa2了。确实,国内看用koa2的不少,不过整个global来看,express的使用量依然很高,并且由于express出现的早,整个生态比较完备,所以还将会在很长一段时间内拥有较多的用户。
个人比较认可数据,刚刚去npm网站看了一下express和koa的下载量。对比图如下,今早新鲜出炉的数据。
express VS koa
express的周下载量达到了1190万,koa的周下载量目前是41万。尽管目前下载量对比express占优,但是koa具有自己的优势,后面我会有文章专门介绍koa。实际工作中,一方面我们需要使用成熟稳定的技术,但是也不能放松对新技术,新事物的了解,否则很快就会被这个飞速发展的时代抛下。IT人是需要活到老,学到老的。
接下来,回到本章需要介绍的内容。
express 参数获取
这里的参数分成几类,一类是用户在网页form中输入的信息,一类是url path中的信息,还有就是post中的参数怎么获取。
- 获取用户在网页form中输入的信息
如果form使用的是GET方法,form中的信息会以下列形式在url中进行传递。
http://localhost:3000/create?name=Vincent&age=18
这个示例中form中有两个元素,分别是name和age。提交时,参数以这样的形式添加在url后面发送到服务端。
还是那句话,框架需要提供对原生功能的包装,尽可能让使用者快捷简单的使用功能。在express中,网页form的数据提交到服务端后,数据以键值对的形式保存在request.query对象中。获取参数值,只需要使用request.query.<param>即可,示例如下:
let name = request.query.name;
假设我在浏览器的"name"文本框输入值Vincent,那么上面的代码就能够获取到"Vincent"。
比起node.js原生的获取参数的方法,express便捷了很多。node.js原生获取form中参数的方法需要首先手动引入url包,通过parse后,在调用query后获取参数值。
- 获取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传参
- 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
+ ejs@2.6.2
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模板,即<project>/views/index.ejs。{title:'Express'}表示该模板使用的变量。传入之后,替代index.ejs中的<%= title %>,最后得到的页面如下。
ejs
总结
express参数获取的三种方式,模板引擎的使用和设置先介绍到这里。希望本篇能够让你在使用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中的参数怎么获取。
- 获取用户在网页form中输入的信息
如果form使用的是GET方法,form中的信息会以下列形式在url中进行传递。
http://localhost:3000/create?name=Vincent&age=18
这个示例中form中有两个元素,分别是name和age。提交时,参数以这样的形式添加在url后面发送到服务端。
还是那句话,框架需要提供对原生功能的包装,尽可能让使用者快捷简单的使用功能。在express中,网页form的数据提交到服务端后,数据以键值对的形式保存在request.query对象中。获取参数值,只需要使用request.query.<param>即可,示例如下:
let name = request.query.name;
假设我在浏览器的"name"文本框输入值Vincent,那么上面的代码就能够获取到"Vincent"。
比起node.js原生的获取参数的方法,express便捷了很多。node.js原生获取form中参数的方法需要首先手动引入url包,通过parse后,在调用query后获取参数值。
- 获取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传参
- 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
+ ejs@2.6.2
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模板,即<project>/views/index.ejs。{title:'Express'}表示该模板使用的变量。传入之后,替代index.ejs中的<%= title %>,最后得到的页面如下。
ejs
总结
express参数获取的三种方式,模板引擎的使用和设置先介绍到这里。希望本篇能够让你在使用express的时候得到帮助。
如果有问题,欢迎朋友们留言讨论。