Java后端文件上传详解：从零到一打造高效稳定的文件传输系统

本文链接：https://blog.youkuaiyun.com/Q2024107/article/details/142871414

Java后端文件上传通常使用Spring Boot框架，结合MultipartFile类来实现。以下是一个简单的示例，展示了如何在Spring Boot应用程序中实现文件上传功能。

首先，需要在pom.xml文件中添加Spring Boot Web和Apache Commons IO依赖：

<dependencies>
    <dependency>
        <groupId>org.springframework.boot</groupId>
        <artifactId>spring-boot-starter-web</artifactId>
    </dependency>
    <dependency>
        <groupId>commons-io</groupId>
        <artifactId>commons-io</artifactId>
        <version>2.8.0</version>
    </dependency>
</dependencies>

在Spring Boot应用程序的主类上添加@SpringBootApplication注解，以启用Web应用程序功能：

import org.springframework.boot.SpringApplication;
import org.springframework.boot.autoconfigure.SpringBootApplication;

@SpringBootApplication
public class Application {
    public static void main(String[] args) {
        SpringApplication.run(Application.class, args);
    }
}

创建一个控制器类，用于处理文件上传请求：

import org.springframework.http.HttpStatus;
import org.springframework.http.ResponseEntity;
import org.springframework.web.bind.annotation.PostMapping;
import org.springframework.web.bind.annotation.RequestParam;
import org.springframework.web.bind.annotation.RestController;
import org.springframework.web.multipart.MultipartFile;

import java.io.File;
import java.io.IOException;
import java.nio.file.Files;
import java.nio.file.Path;
import java.nio.file.Paths;

@RestController
public class FileUploadController {

    private static final String UPLOAD_DIR = "uploads/";

    @PostMapping("/upload")
    public ResponseEntity<String> uploadFile(@RequestParam("file") MultipartFile file) {
        if (file.isEmpty()) {
            return new ResponseEntity<>("请选择一个文件上传", HttpStatus.BAD_REQUEST);
        }

        try {
            byte[] bytes = file.getBytes();
            Path path = Paths.get(UPLOAD_DIR + file.getOriginalFilename());
            Files.write(path, bytes);

            return new ResponseEntity<>("文件上传成功： " + file.getOriginalFilename(), HttpStatus.OK);
        } catch (IOException e) {
            e.printStackTrace();
            return new ResponseEntity<>("文件上传失败： " + e.getMessage(), HttpStatus.INTERNAL_SERVER_ERROR);
        }
    }
}

在这个示例中，我们创建了一个名为FileUploadController的控制器类，其中包含一个处理POST请求的方法uploadFile。该方法接收一个名为file的MultipartFile参数，表示要上传的文件。我们将文件保存到服务器的uploads目录下。

详解：

@RestController：这个注解用于标记一个类，表示它是一个RESTful风格的控制器，可以处理HTTP请求并返回响应。
@PostMapping("/upload")：这个注解用于标记一个方法，表示它处理的是HTTP POST请求，请求路径为/upload。
@RequestParam("file") MultipartFile file：这个注解用于从请求中获取名为file的参数，并将其转换为MultipartFile对象。MultipartFile是Spring提供的一个接口，用于处理上传的文件。
file.isEmpty()：这个方法检查上传的文件是否为空。如果为空，则返回一个错误响应。
file.getBytes()：这个方法将上传的文件转换为字节数组。
Paths.get(UPLOAD_DIR + file.getOriginalFilename())：这个方法创建一个指向服务器上存储文件的路径。