java怎么实现文件下载编写文件下载接口的实现方法-java教程-PHP中文网

java怎么实现文件下载编写文件下载接口的实现方法

畫卷琴夢

发布： 2025-11-09 20:03:02

原创

148人浏览过

答案：Java中实现文件下载功能可通过Servlet或Spring Boot。使用Servlet时，需设置Content-Type和Content-Disposition响应头，通过FileInputStream读取文件并写入response输出流；Spring Boot则推荐使用ResponseEntity封装FileSystemResource，结合@GetMapping返回文件资源，同时设置相应头信息。两种方式均需注意路径安全、中文文件名编码、大文件缓冲及权限校验，生产环境建议由Nginx等静态服务器处理以减轻应用压力。

java怎么实现文件下载编写文件下载接口的实现方法

在Java中实现文件下载功能，通常用于Web应用中提供用户从服务器下载文件的服务。可以通过Servlet或Spring框架来编写文件下载接口。以下是两种常见方式的实现方法。

使用原生Servlet实现文件下载

通过继承HttpServlet类，在doGet方法中设置响应头、读取文件并输出到客户端。

步骤说明：

设置响应头Content-Type为application/octet-stream，触发浏览器下载行为
设置Content-Disposition，指定文件名
使用FileInputStream读取服务器上的文件
通过response.getOutputStream()将文件内容写回客户端

代码示例：

立即学习“Java免费学习笔记（深入）”；

@WebServlet("/download")
public class FileDownloadServlet extends HttpServlet {
    protected void doGet(HttpServletRequest request, HttpServletResponse response) throws IOException {
        // 文件在服务器上的路径
        String filePath = "/path/to/your/file.pdf";
        File file = new File(filePath);

        if (!file.exists()) {
            response.sendError(HttpServletResponse.SC_NOT_FOUND, "文件未找到");
            return;
        }

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

        // 读取并输出文件
        try (FileInputStream fis = new FileInputStream(file);
             OutputStream os = response.getOutputStream()) {
            byte[] buffer = new byte[4096];
            int bytesRead;
            while ((bytesRead = fis.read(buffer)) != -1) {
                os.write(buffer, 0, bytesRead);
            }
        }
    }
}

登录后复制

使用Spring Boot实现文件下载接口

Spring提供了更简洁的方式，推荐使用Resource和ResponseEntity进行封装。

法语写作助手

法语助手旗下的AI智能写作平台，支持语法、拼写自动纠错，一键改写、润色你的法语作文。

查看详情

实现要点：

使用@GetMapping映射请求路径
返回ResponseEntity类型，便于控制响应头和状态码
利用FileSystemResource读取本地文件
设置HttpHeaders.CONTENT_DISPOSITION指定下载文件名

代码示例：

立即学习“Java免费学习笔记（深入）”；

@RestController
public class FileDownloadController {

    @GetMapping("/api/download")
    public ResponseEntity<Resource> downloadFile() throws IOException {
        // 文件路径
        Path path = Paths.get("/path/to/your/file.pdf");
        Resource resource = new FileSystemResource(path);

        if (!resource.exists()) {
            return ResponseEntity.notFound().build();
        }

        // 设置下载文件名（可支持中文）
        String filename = URLEncoder.encode(resource.getFilename(), "UTF-8");

        return ResponseEntity.ok()
                .header(HttpHeaders.CONTENT_DISPOSITION, "attachment; filename*=UTF-8''" + filename)
                .contentType(MediaType.APPLICATION_OCTET_STREAM)
                .body(resource);
    }
}

登录后复制