Java文件下载实现与接口编写教程

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

使用原生Servlet实现文件下载

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

步骤说明：

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

代码示例：

@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进行封装。

实现要点：

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

代码示例：

@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);
    }
}

注意事项与优化建议

实际开发中需要注意以下几点：

• 对文件路径做安全校验，防止路径穿越攻击（如 ../../etc/passwd）
• 大文件下载建议增加缓冲流和分块传输，避免内存溢出
• 若文件名含中文，需用URLEncoder处理，确保浏览器正确识别
• 可以加入权限验证逻辑，比如判断用户是否有权下载该文件
• 生产环境建议使用Nginx等静态资源服务器处理文件下载，减轻应用服务器压力