李李金川个人博客

首页 / 技术手记

Java文件上传下载方案

技术手记

基于Java的文件上传与下载功能实现方案

文件上传与下载是一个常见的功能，广泛应用于各种Web系统中，实现用户与服务器之间的文件交互。以下是一种基于Spring Boot的解决方案，简单易用且扩展性强。

功能需求分析

  1. 文件上传功能：

    • 用户可以通过前端界面选择文件上传到服务器。
    • 上传文件存储在服务器指定目录中。
    • 验证文件大小和类型，防止超大文件或非法文件上传。

  2. 文件下载功能：

    • 用户通过文件名或文件标识下载指定的文件。
    • 支持异常处理，如文件未找到或访问权限不足等问题。

技术选型与实现方案

  • 后端框架：Spring Boot
  • 文件存储：
    • 存储在本地磁盘。
    • 可扩展为云存储（如阿里云OSS、亚马逊S3等）。
  • 前后端交互：使用RESTful API。
  • 文件验证：使用Apache Commons FileUpload或其他三方库。

后端实现步骤

  1. 引入依赖
    在pom.xml文件中添加以下依赖：

    <dependencies>
    <dependency>
        <groupId>org.springframework.boot</groupId>
        <artifactId>spring-boot-starter-web</artifactId>
    </dependency>
</dependencies>

  2. 配置文件存储路径
    在application.properties文件中配置存储路径：

    file.upload-dir=uploads/

  3. 创建文件上传与下载Controller
    新建一个FileController类：

    @RestController
@RequestMapping("/files")
public class FileController {

    private final String uploadDir = "uploads/";

    // 上传文件
    @PostMapping("/upload")
    public ResponseEntity<String> uploadFile(@RequestParam("file") MultipartFile file) {
        try {
            // 验证文件是否为空
            if (file.isEmpty()) {
                return ResponseEntity.badRequest().body("上传文件不能为空");
            }

            // 获取文件路径
            Path filePath = Paths.get(uploadDir + file.getOriginalFilename());

            // 写入文件到磁盘
            Files.createDirectories(filePath.getParent());
            Files.write(filePath, file.getBytes());

            return ResponseEntity.ok("文件上传成功: " + filePath.toString());
        } catch (IOException e) {
            return ResponseEntity.status(HttpStatus.INTERNAL_SERVER_ERROR).body("文件上传失败: " + e.getMessage());
        }
    }

    // 下载文件
    @GetMapping("/download/{fileName}")
    public ResponseEntity<Resource> downloadFile(@PathVariable String fileName) {
        try {
            // 构造文件路径
            Path filePath = Paths.get(uploadDir, fileName);

            // 判断文件是否存在
            if (!Files.exists(filePath)) {
                return ResponseEntity.status(HttpStatus.NOT_FOUND).body(null);
            }

            // 创建资源并设置对应的响应头
            Resource resource = new UrlResource(filePath.toUri());
            return ResponseEntity.ok()
                    .contentType(MediaType.APPLICATION_OCTET_STREAM)
                    .header(HttpHeaders.CONTENT_DISPOSITION, "attachment; filename=" + fileName)
                    .body(resource);
        } catch (MalformedURLException e) {
            return ResponseEntity.status(HttpStatus.INTERNAL_SERVER_ERROR).body(null);
        }
    }
}

  4. 异常处理优化
    使用@ControllerAdvice处理全局异常，提升代码的可维护性与扩展性。

前端交互设计

  1. 上传功能：

    • 使用HTML表单上传文件。
    <form action="/files/upload" method="post" enctype="multipart/form-data">
    <input type="file" name="file">
    <button type="submit">上传文件</button>
</form>

  2. 下载功能：

    • 文件名作为参数拼接到URL中，通过点击一个按钮或链接实现下载。
    <a href="/files/download/sample.txt" download>下载文件</a>

注意事项

  1. 文件大小限制
    在Spring Boot中可以通过application.properties配置文件限制文件大小：

    spring.servlet.multipart.max-file-size=10MB
spring.servlet.multipart.max-request-size=10MB

  2. 安全性检查

    • 验证文件类型，防止上传恶意文件。
    • 控制目录访问权限，避免文件泄露。

  3. 扩展存储功能
    如果需要将文件存储迁移到云存储，可以使用相应的SDK进行对接，并替换本地存储逻辑。

总结

本文通过Spring Boot提供了一种简洁而高效的文件上传下载功能实现方案，同时分析了功能需求、技术选型及开发注意事项。这个基础方案可以快速应用在各种Web开发场景中，并为后续的功能扩展（如分片上传、存储到云端等）提供了良好的铺垫。

返回技术手记

相关阅读