java response下载文件文件名

原创

mob649e816a77bf 2024-08-07 10:53:50 ©著作权

文章标签 文件下载 java Java 文章分类 Java 后端开发

©著作权归作者所有：来自51CTO博客作者mob649e816a77bf的原创作品，请联系作者获取转载授权，否则将追究法律责任

使用 Java 实现文件下载功能

在现代 web 应用中，文件下载是一个常见的功能。通过 Java，我们可以很方便地实现这一需求。在本篇文章中，我们将探讨如何使用 Java 编写一个可以下载文件并自定义文件名的简单示例。

文件下载的基本原理

当用户请求下载文件时，服务器会响应一个包含文件内容的 HTTP 响应，并在响应头中设置相关的内容类型和文件名。浏览器接收到响应后，会触发文件下载。

重要的 HTTP 响应头

在文件下载时，我们通常需要设置以下几个关键的 HTTP 响应头：

响应头	说明
Content-Type	表示文件的类型
Content-Disposition	指定文件的下载名称
Content-Length	文件的大小

Java 示例代码

下面是一个简单的 Java Servlet 示例，实现了文件下载功能。该示例中我们使用了 Apache Tomcat 作为容器。

Servlet 代码

import javax.servlet.ServletException;
import javax.servlet.annotation.WebServlet;
import javax.servlet.http.HttpServlet;
import javax.servlet.http.HttpServletRequest;
import javax.servlet.http.HttpServletResponse;
import java.io.File;
import java.io.FileInputStream;
import java.io.IOException;
import java.io.OutputStream;

@WebServlet("/download")
public class FileDownloadServlet extends HttpServlet {
    private static final String FILE_PATH = "/path/to/your/file.txt";

    protected void doGet(HttpServletRequest request, HttpServletResponse response) throws ServletException, IOException {
        File file = new File(FILE_PATH);
        FileInputStream inStream = new FileInputStream(file);

        response.setContentType("application/octet-stream");
        response.setHeader("Content-Disposition", "attachment; filename=\"" + file.getName() + "\"");
        response.setContentLength((int) file.length());

        OutputStream outStream = response.getOutputStream();
        byte[] buffer = new byte[4096];
        int bytesRead;

        while ((bytesRead = inStream.read(buffer)) != -1) {
            outStream.write(buffer, 0, bytesRead);
        }

        inStream.close();
        outStream.close();
    }
}

运行流程图

以下是文件下载过程的序列图，借助 Mermaid 语法进行描述：

sequenceDiagram
    participant User
    participant WebBrowser
    participant Server

    User->>WebBrowser: 点击下载链接
    WebBrowser->>Server: 发送 GET 请求 /download
    Server->>WebBrowser: 设置响应头，返回文件内容
    WebBrowser->>User: 提示下载文件