express

1.get started

mkdir xxxxxx
cd xxxxxx
npm init -y
npm i express
node index.js

1 express --git ./express-demo && cd ./express-demo 2 npm i 3 npm start

  • bin, 存放启动项目的脚本文件

    • node_modules, 存放所有的项目依赖库

    • public 静态文件(css,js,img)

    • routes,路由文件(controller)

    • views,页面模板

    • package.json,项目依赖配置及开发者信息

    • app.js,应用核心配置文件

4 debug DEBUG=express:* node index.js

3.middleware(core concept)

简单说,中间件(middleware)就是处理HTTP请求的函数。它最大的特点就是,一个中间件处理完,再传递给下一个中间件。从本质上来说,一个 Express 应用就是在调用各种中间件

每个中间件可以从App实例,接收三个参数,依次为request对象、response对象,和 web 应用中处于请求-响应循环流程中的中间件 ,一般被命名为 next 的变量 。每个中间件都可以对HTTP请求(request对象)进行加工,并且决定是否调用next方法,将request对象再传给下一个中间件。

  • 执行任何代码

  • 修改请求和响应对象

  • 终结请求-响应循环

  • 调用堆栈中的下一个中间件

1 应用级中间件(绑定到 app 对象 使用 app.use() 和 app.METHOD(),METHOD 是需要处理的 HTTP 请求的方法,例如 GET, PUT, POST 等等,全部小写)

var app = express();

// 没有挂载路径的中间件,应用的每个请求都会执行该中间件
// 注意中间件顺序注意中间件顺序注意中间件顺序
app.use(function (req, res, next) {
  console.log('Time:', Date.now());
  next();
});

// 挂载至 /user/:id 的中间件,任何指向 /user/:id 的请求都会执行它
app.use('/user/:id', function (req, res, next) {
  console.log('Request Type:', req.method);
  next();
});

// 路由和句柄函数(中间件系统),处理指向 /user/:id 的 GET 请求
app.get('/user/:id', function (req, res, next) {
  res.send('USER');
});

//下面这个例子展示了在一个挂载点装载一组中间件
app.use('/user/:id', function(req, res, next) {
  console.log('Request URL:', req.originalUrl);
  next();
}, function (req, res, next) {
  console.log('Request Type:', req.method);
  next();
});

//作为中间件系统的路由句柄,使得为路径定义多个路由成为可能。在下面的例子中,为指向 /user/:id 的 GET 请求定义了两个路由。第二个路由虽然不会带来任何问题,但却永远不会被调用,因为第一个路由已经终止了请求-响应循环
app.get('/user/:id', function (req, res, next) {
  console.log('ID:', req.params.id);
  next();
}, function (req, res, next) {
  res.send('User Info');
});

app.get('/user/:id', function (req, res, next) {
  res.end(req.params.id);
});

//如果需要在中间件栈中跳过剩余中间件,调用 next('route') 方法将控制权交给下一个路由。 **注意**: next('route') 只对使用 app.VERB() 或 router.VERB() 加载的中间件有效
app.get('/user/:id', function (req, res, next) {
  if (req.params.id == 0) next('route');
  else next();
}, function (req, res, next) {
   res.render('regular');
});

app.get('/user/:id', function (req, res, next) {
  res.render('special');
});

2 路由级中间件(绑定的对象为 express.Router(), 路由级使用 router.use() 或 router.METHOD() 加载)

  var app = express();
   var router = express.Router();

   // 没有挂载路径的中间件,通过该路由的每个请求都会执行该中间件
   router.use(function (req, res, next) {
       console.log('Time:', Date.now());
       next();
   });

   // 一个中间件栈,显示任何指向 /user/:id 的 HTTP 请求的信息
   router.use('/user/:id', function (req, res, next) {
       console.log('Request URL:', req.originalUrl);
       next();
   }, function (req, res, next) {
       console.log('Request Type:', req.method);
       next();
   });

   // 一个中间件栈,处理指向 /user/:id 的 GET 请求
   router.get('/user/:id', function (req, res, next) {
       // 如果 user id 为 0, 跳到下一个路由
       if (req.params.id == 0) next('route');
       // 负责将控制权交给栈中下一个中间件
       else next();
   }, function (req, res, next) {
       // 渲染常规页面
       res.render('regular');
   });
   // 处理 /user/:id, 渲染一个特殊页面
   router.get('/user/:id', function (req, res, next) {
       console.log(req.params.id);
       res.render('special');
   });
   // 将路由挂载至应用
   app.use('/', router);

3 错误处理中间件

app.use(function(err, req, res, next) {
  console.error(err.stack);
  res.status(500).send('Something broke!');
});

4 内置中间件

// express.static
var options = {
  dotfiles: 'ignore',
  etag: false,
  extensions: ['htm', 'html'],
  index: false,
  maxAge: '1d',
  redirect: false,
  setHeaders: function (res, path, stat) {
    res.set('x-timestamp', Date.now());
  }
}

// 每个应用可有多个静态目录
app.use(express.static('public'));
app.use(express.static('uploads'));
app.use(express.static('files'));

  • body-parser

  • compression

  • serve-static

  • session

  • cookie-parser

  • morgan

  • express-session

  • connect-mongo

4.Router(core concept)

  1. 路由路径

    app.get('/', function (req, res) {
      res.send('root');
    });
    
    app.get('/example/a', function (req, res) {
      res.send('Hello from A!');
    });
    
    // 正则
    app.get('/ab?cd', function(req, res) {
      res.send('ab?cd');
    });
    
    // 正则
    app.get('/ab(cd)?e', function(req, res) {
     res.send('ab(cd)?e');
    });
    
    // 正则
    app.get('/user/*man', function(req, res) {
     res.send('ab(cd)?e');
    });
    
    //使用多个回调函数处理路由
    app.get('/example/b', function (req, res, next) {
      console.log('response will be sent by the next function ...');
      next();
    }, function (req, res) {
      res.send('Hello from B!');
    });
    
    //使用回调函数数组处理路由
    var cb0 = function (req, res, next) {
      console.log('CB0');
      next();
    }
    
    var cb1 = function (req, res, next) {
      console.log('CB1');
      next();
    }
    
    app.get('/example/c', [cb0, cb1]);
    
    // 混合使用函数和函数数组处理路由
    var cb0 = function (req, res, next) {
      console.log('CB0');
      next();
    }
    
    var cb1 = function (req, res, next) {
      console.log('CB1');
      next();
    }
    
    app.get('/example/d', [cb0, cb1], function (req, res, next) {
      console.log('response will be sent by the next function ...');
      next();
    }, function (req, res) {
      res.send('Hello from D!');
    });
  2. 响应方法

    method

    description

    res.download()

    提示下载文件

    res.jsonp()

    发送一个支持 JSONP 的 JSON 格式的响应

    res.sendFile()

    以八位字节流的形式发送文件 response.sendFile("/path/to/anime.mp4")

    res.sendStatus()

    设置响应状态代码,并将其以字符串形式作为响应体的一部分发送

    res.json()

    发送一个 JSON 格式的响应

    res.redirect()

    重定向请求 response.redirect("/hello/anime") response.redirect("http://www.example.com") response.redirect(301, "http://www.example.com")

    res.render()

    渲染视图模板

    res.send()

    发送各种类型的响应

    res.end()

    终结响应处理流程

  3. express.Router() 路由拆分

  4. app.route()

    app.route('/book')
      .get(function(req, res) {
        res.send('Get a random book');
      })
      .post(function(req, res) {
        res.send('Add a book');
      })
      .put(function(req, res) {
        res.send('Update the book');
      });

5.views(core concept)

1 选择template engine策略

  • 支持模版继承(extend)

  • 支持模版扩展(block)

  • 支持模版组合(include)

  • 支持预编译

2 npm install --save xxxxx

3 use

app.set('views', './views')
app.set('view engine', 'pug')

4 static views

5 dync views

8.Express some API

  1. app.use([path], middleware) //use是express注册中间件的方法

    app.use("/home", function(request, response, next) {
      response.writeHead(200, { "Content-Type": "text/plain" });
      response.end("Welcome to the homepage!\n");
    });
  2. 中间件顺序很重要 处理错误需要在最后

  3. 请求必须返回,通过end、send、render等结束

  4. all方法和HTTP动词方法(get post put delete...)

  5. 模式匹配

  6. set

  7. response

Last updated