Skip to content

Express快速入门

2024-08-17

1. Express介绍

Express是一个简洁、灵活的node.js Web应用开发框架,是目前最流行的基于Node.js的Web开发框架. 它提供一系列强大的功能,比如:

  • 模板解析
  • 静态文件服务
  • 中间件
  • 路由控制

还可以使用其他模块来帮助你创建各种Web和移动设备应用

2. 使用express

本地安装

bash
$ npm install express

获取、引用 通过变量app我们就可以调用express的各种方法

js
let express = require('express');
let app = express();

app.listen(3000);

3. get请求

根据请求路径来处理客户端发出的GET请求 语法

javascript
app.get(path, function(request, response));
  • 第一个参数path为请求的路径
  • 第二个参数为处理请求的回调函数,有两个参数分别是
    • request 代表请求信息
    • response 代表响应信息
javascript
let express = require('express');
let app = express();
app.get('/',function(req,res){
    res.end('welcome to  首页');
});
app.get('/about',function(req,res){
 res.end('欢迎来到关于我们');
})
app.listen(3000);

4.curl客户端使用方法

  • 指定请求头
bash
curl -H 'content-type:application/json;charset=utf-8' http://localhost:8080/users
  • 指定方法名
bash
curl -X POST http://localhost:8080/users
  • 指定请求体
bash
curl --data "name=zfpx&age=8" http://localhost:8080/users

5. all

app.all()函数可以匹配所有的HTTP动词 路由中的星号能匹配所有的路径 语法

javascript
app.all(path,function(request, response));

示例

javascript
let express = require('express');//引入express
let app = express();
app.all("*",function(req,res){
 res.send("404");
})
app.listen(3000);

6. 获取请求参数

  • req.host 返回请求头里取的主机名(不包含端口号)
  • req.path 返回请求的URL的路径名
javascript
app.get('/',function(req,res){
   res.end('欢迎来到首页'+req.host+" "+req.path);
});

7. 获得查询字符串

javascript
//http://localhost:3000/?a=1&b=2&c=3
app.get('/',function(req,res){
   res.send(req.query);
});

8. params路径参数

req.params可以用来获取请求URL中的参数值

javascript
app.get('/:id/:name',function(req,res){
   res.send(req.params.id+" "+req.params.name);
});

9. 中间件

中间件就是处理HTTP请求的函数,用来完成各种特定的任务 比如检查用户是否登录、检测用户是否有权限访问等,它的特点是:

  • 一个中间件处理完请求和响应可以把相应数据再传递给下一个中间件
  • 回调函数的next参数,表示接受其他中间件的调用,函数体中的next(),表示将请求数据传递给下一个中间件
  • 还可以根据路径来区分进行返回执行不同的中间件
javascript
let express = require('express');
let app = express();
let path = require('path');

app.use(function(req,res,next){
 res.setHeader('Content-Type','text/plain;charset=utf-8');
 next();
});

app.get('/',function(req,res){
 res.end('首页');
});
app.get('/about',function(req,res){
 res.end('关于我们');
});

app.listen(3000);

10. send

send方法向浏览器发送一个响应信息,并可以智能处理不同类型的数据 并在输出响应时会自动进行一些设置,比如HEAD信息、HTTP缓存支持等等。 语法

javascript
res.send([body|status], [body])

示例 1.当参数为一个String时,Content-Type默认设置为"text/html"。

javascript
res.send('Hello World'); //Hello World

2.当参数为Array或Object时,Express会返回一个JSON

javascript
res.send({ user: 'tobi' }); //{"user":"tobi"}
res.send([1,2,3]); //[1,2,3]

3.当参数为一个Number时,并且没有上面提到的任何一条在响应体里,Express会帮你设置一个响应体,比如:200会返回字符"OK"

javascript
res.send(200); // OK
res.send(404); // Not Found
res.send(500); // Internal Server Error

11. 模板

在nodejs中使用express框架,它默认的是ejs和jade渲染模板

11.1 安装模板

javascript
npm install ejs

11.2 使用模板

使用ejs模板

javascript
//指定渲染模板文件的后缀名为ejs
app.set('view engine', 'ejs');
app.set('views',path.join(__dirname,'views'));
res.render('index');

模板使用html后缀

javascript
// 修改模板文件的后缀名为html
app.set( 'view engine', 'html' );
app.set('views',path.join(__dirname,'views'));
// 运行ejs模块
app.engine( '.html', require( 'ejs' ).__express ); //__express是ejs模块的一个公共属性,表示要渲染的文件扩展名

11.3 渲染视图

语法

  • 参数view就是模板的文件名
  • 在渲染模板时locals可为其模板传入变量值
  • callback用来处理返回的渲染后的字符串
javascript
res.render(view, [locals], callback);

11.4 模板原理

javascript
let tmpl = '<h1>{{name}}</h1><h1>{{age}}</h1>';
let data = {name:'zfpx',age:30};
let html= tmpl.replace(/\{\{(\w+)\}\}/g,function(input,group){
    return data[group];
})

console.log(html);

12. 静态文件服务器

如果要在网页中加载静态文件(css、js、img),就需要另外指定一个存放静态文件的目录,当浏览器发出非HTML文件请求时,服务器端就会到这个目录下去寻找相关文件

javascript
app.use(express.static(path.join(__dirname,'/')));

13. 重定向

redirect方法允许网址的重定向,跳转到指定的url并且可以指定status,默认为302方式。 语法

javascript
res.redirect([status], url);

示例

res.redirect("http://www.baidu.com");

14. post请求

post方法 根据请求路径来处理客户端发出的Post请求 语法

app.post(path,function(req, res));

示例

javascript
let bodyParser = require('body-parser');
app.use(bodyParser.urlencoded({extended:true}));
app.post('/login',function(req,res){
        console.log(req.body.username);
});

15. 中间件原理

javascript
// 当请求到来的时候执行app,这是会对数组里的配置项一次匹配,匹配上的执行,匹配不上执行
let app = function(req,res){
   let i=0;//定义一个变量每次执行next后加一
    //每执行一次next,会取出一个中间件函数执行,并且把next传进去
   function next(){
       let fn = app.routes[i++];
       if(fn)
        fn(req,res,next);
   }
    next();
}
//存放中间件函数的数组
app.routes = [];
//配置函数
app.use = function(fn){
    //往数组里添加函数
    app.routes.push(fn);
}
//------------------------
app.use(function(req,res,next){
    console.log(req.url);
    console.log(1);
    next();
});
app.use(function(req,res,next){
    console.log(2);
    res.end('ok');
    next();
});
//-------------------
let http = require('http');
let server = http.createServer(app);
server.listen(9090);

16. params原理

javascript
//是路由里的路径
let path = '/users/:name/:age';
//真实请求的URL
let url = '/users/zfpx/8';
//存放所有的参数名
let paramNames = [];
let regStr = path.replace(/:(\w+)/g,function(matchedStr,group1){
    paramNames.push(group1);// name age 添加进来的
    return '(\\w+)';
});
console.log(regStr);//   \/users\/(\w+)\/(\w+)
let reg = new RegExp(regStr);
let result = url.match(reg);
//[ '/users/zfpx/8', 'zfpx', '8', index: 0, input: '/users/zfpx/8' ]
console.log(result);
let params = {};
//循环数组名 值就是 result中的分组
for(let i=0;i<paramNames.length;i++){
    params[paramNames[i]] = result[i+1];
}
console.log(params);

资源

从express源码中探析其路由机制

花海相伴