理解 Express.js 中的 express.static 中间件

本文从基本使用、高级使用、基本原理和模仿手写四个方面逐步阐述express.static中间件的使用及其原理。

引言

在 Express.js 中,最基础且广泛使用的中间件之一是 express.static。这个中间件用于提供静态文件,如图片、CSS 文件和 JavaScript 文件。

基本用法

第 1 步:导入 Express 并初始化应用程序

javascript 复制代码
const express = require('express');
const app = express();

第 2 步:使用 express.static

使用 express.static 时,你指定一个目录来提供静态文件。

javascript 复制代码
app.use(express.static('public'));

在此示例中,public 是包含静态文件的目录。现在,public 目录中的文件将作为 Web 应用程序的一部分被提供。

高级用法

设置虚拟路径前缀

你可以为静态文件指定一个虚拟路径前缀。

javascript 复制代码
app.use('/static', express.static('public'));

现在,静态文件将在 /static 路径下提供。例如,http://yourserver.com/static/image.jpg 将从 public 目录提供 image.jpg 文件。

设置 HTTP 头

对于更高级的场景,如设置 Cache-Control 头,你可以结合使用 express.static 和其他中间件。

javascript 复制代码
const serveStatic = require('serve-static');

app.use('/static', serveStatic('public', {
  maxAge: '1h',
  setHeaders: setCustomCacheControl
}));

function setCustomCacheControl(res, path) {
  if (serveStatic.mime.lookup(path) === 'text/html') {
    res.setHeader('Cache-Control', 'public, max-age=0');
  }
}

原理

express.static 中间件处理请求,查找指定目录中的请求文件,如果找到,返回给客户端。如果未找到文件,它将控制权传递给堆栈中的下一个中间件。

模仿 express.static

要模仿 express.static 的基本功能,你可以创建一个简单的中间件,从目录中读取并提供文件。

javascript 复制代码
const fs = require('fs');
const path = require('path');

function customStatic(dirPath) {
  return (req, res, next) => {
    const filePath = path.join(dirPath, req.url);
    
    fs.readFile(filePath, (err, data) => {
      if (err) {
        next(); // 如果找不到文件,移动到下一个中间件
        return;
      }
      res.send(data); // 提供文件数据
    });
  };
}

app.use(customStatic('public'));

这个函数创建了一个中间件,试图从给定目录读取请求的文件并提供它。如果文件未找到,它调用 next() 以传递控制权。

结论

express.static 中间件是在 Express.js 应用程序中提供静态文件的强大功能。理解其基本和高级用法以及其背后的原理,可以极大地增强你的 Web 应用程序的功能和性能。通过创建一个自定义版本,你可以更深入地理解 Express.js 中间件在基本层面上的操作方式。


English Version: Understanding the express.static Middleware in Express.js

Introduction

In Express.js, one of the most fundamental and widely used middlewares is express.static. This middleware is used to serve static files such as images, CSS files, and JavaScript files.

Basic Usage

Step 1: Importing Express and Initializing the Application

javascript 复制代码
const express = require('express');
const app = express();

Step 2: Using express.static

To use express.static, you specify the directory from which to serve the static files.

javascript 复制代码
app.use(express.static('public'));

In this example, public is the directory containing static files. Now, files in the public directory will be served as part of your web application.

Advanced Usage

Setting a Virtual Path Prefix

You can specify a virtual path prefix for your static files.

javascript 复制代码
app.use('/static', express.static('public'));

Now, static files will be served under the /static path. For instance, http://yourserver.com/static/image.jpg will serve the image.jpg file from the public directory.

Setting HTTP Headers

For more advanced scenarios, like setting Cache-Control headers, you can use a combination of express.static with other middleware.

javascript 复制代码
const serveStatic = require('serve-static');

app.use('/static', serveStatic('public', {
  maxAge: '1h',
  setHeaders: setCustomCacheControl
}));

function setCustomCacheControl(res, path) {
  if (serveStatic.mime.lookup(path) === 'text/html') {
    res.setHeader('Cache-Control', 'public, max-age=0');
  }
}

Principle

The express.static middleware processes a request, looks for the requested file in the specified directory, and if found, returns it to the client. If the file is not found, it passes control to the next middleware in the stack.

Mimicking express.static

To mimic the basic functionality of express.static, you can create a simple middleware that reads and serves files from a directory.

javascript 复制代码
const fs = require('fs');
const path = require('path');

function customStatic(dirPath) {
  return (req, res, next) => {
    const filePath = path.join(dirPath, req.url);
    
    fs.readFile(filePath, (err, data) => {
      if (err) {
        next(); // If file not found, move to the next middleware
        return;
      }
      res.send(data); // Serve the file data
    });
  };
}

app.use(customStatic('public'));

This function creates a middleware that tries to read the requested file from the given directory and serve it. If the file is not found, it calls next() to pass control.

Conclusion

The express.static middleware is a powerful feature for serving static files in an Express.js application. Understanding its usage, both basic and advanced, as well as its underlying principle, can greatly enhance the functionality and performance of your web applications. By creating a custom version, you get a deeper understanding of how middleware in Express.js operates at a fundamental level.

相关推荐
木头左11 小时前
【浏览器自动化】用 CDP 接管本机 Chrome:从一个宿主迁到另一个宿主的设计与踩坑
node.js·浏览器自动化·cdp·技能化·踩坑实践
cpolar技术支持1 天前
把 agent-autoloop 装在 Mac 上:用本机 Node 实跑一次「接活—提问—拍板—接着干」,再用 cpolar 把它的状态页开给不在工位的自己
node.js·内网穿透·cpolar·ai agent·agent-autoloop
SEO_juper1 天前
Node.js 全站 SEO 体检报告生成器:一次查完标题、描述、canonical、H1、图片
开发语言·前端·node.js·html·bash
木头左2 天前
【Node.js】Markdown 转带图片 Word 文档实战:docx 库转换器设计与 5 个踩坑
node.js·word·markdown·文档自动化
思特奇时空智能3 天前
大规模点要素地图渲染性能优化实践
vue.js·arcgis·性能优化·node.js·html·gis·webgl
w3296362715 天前
飞书接单到月度结算:我用一个 DSH 插件跑通鞋类采购 WMS,附 22 项验收
pdf·node.js·飞书·后端开发·ai agent
濮水大叔5 天前
Cabloy/Vona 为什么不需要 NestJS 的 Dynamic Module
typescript·node.js·nestjs
匠云创新5 天前
读完一万段要两分钟:我们把标书读取从 WPS 对象模型搬到了 docx 解析
性能优化·node.js
某哈压力大6 天前
SSH 突然 Connection reset?不是密钥坏了,是 OpenSSL 把 sshd 干趴了
前端·node.js·命令行
回眸&啤酒鸭6 天前
【回眸】Node.js 新手从零到一实战指南
node.js