详解SpringMVC实现图片上传以及该注意的小细节

在 Spring MVC 中，实现图片上传是一个常见的需求。本文将详细讲解如何实现图片上传，包括如何配置文件上传解析器、如何编写控制器方法、如何处理上传文件、以及需要注意的小细节。同时，本文还提供了两个示例说明，演示如何实现图片上传。

配置文件上传解析器

在 Spring MVC 中，我们需要配置文件上传解析器来解析上传的文件。下面是一个示例代码，演示如何配置文件上传解析器：

<bean id="multipartResolver" class="org.springframework.web.multipart.commons.CommonsMultipartResolver">
  <property name="maxUploadSize" value="10485760" />
</bean>

在上面的代码中，我们创建了一个 CommonsMultipartResolver 对象，并设置了 maxUploadSize 属性为 10485760。这样，Spring MVC 就会使用 CommonsMultipartResolver 来解析上传的文件，并限制上传文件的大小为 10MB。

编写控制器方法

在 Spring MVC 中，我们需要编写控制器方法来处理上传的文件。下面是一个示例代码，演示如何编写控制器方法：

@PostMapping("/upload")
public String handleFileUpload(@RequestParam("file") MultipartFile file, RedirectAttributes redirectAttributes) {
  if (file.isEmpty()) {
    redirectAttributes.addFlashAttribute("message", "Please select a file to upload");
    return "redirect:/uploadStatus";
  }

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

    redirectAttributes.addFlashAttribute("message", "You successfully uploaded '" + file.getOriginalFilename() + "'");
  } catch (IOException e) {
    e.printStackTrace();
  }

  return "redirect:/uploadStatus";
}

在上面的代码中，我们创建了一个 handleFileUpload 方法，用于处理上传的文件。其中，@RequestParam("file") MultipartFile file 参数用于接收上传的文件，RedirectAttributes redirectAttributes 参数用于重定向到上传状态页面。

处理上传文件

在 Spring MVC 中，我们需要处理上传的文件。下面是一个示例代码，演示如何处理上传的文件：

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

在上面的代码中，我们使用 getBytes 方法将上传的文件转换为字节数组，使用 Paths.get 方法创建一个文件路径，使用 Files.write 方法将字节数组写入文件。

注意事项

在 Spring MVC 中，实现图片上传时需要注意以下几个小细节：

需要配置文件上传解析器，否则无法解析上传的文件。
需要限制上传文件的大小，否则可能会导致服务器崩溃。
需要处理上传的文件，否则无法保存上传的文件。
需要处理上传文件名的重复问题，否则可能会导致文件覆盖。

示例说明

示例1：实现图片上传

在 Spring MVC 中实现图片上传非常简单。下面是一个示例代码，演示如何实现图片上传：

创建一个 UploadController 类：

@Controller
public class UploadController {
  private static final String UPLOAD_FOLDER = "/path/to/upload/folder/";

  @GetMapping("/")
  public String index() {
    return "upload";
  }

  @PostMapping("/upload")
  public String handleFileUpload(@RequestParam("file") MultipartFile file, RedirectAttributes redirectAttributes) {
    if (file.isEmpty()) {
      redirectAttributes.addFlashAttribute("message", "Please select a file to upload");
      return "redirect:/uploadStatus";
    }

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

      redirectAttributes.addFlashAttribute("message", "You successfully uploaded '" + file.getOriginalFilename() + "'");
    } catch (IOException e) {
      e.printStackTrace();
    }

    return "redirect:/uploadStatus";
  }

  @GetMapping("/uploadStatus")
  public String uploadStatus() {
    return "uploadStatus";
  }
}

在上面的代码中，我们创建了一个 UploadController 类，用于处理上传文件相关的请求。其中，index 方法用于返回上传页面，handleFileUpload 方法用于处理上传文件，uploadStatus 方法用于返回上传状态页面。

创建一个 upload.html 文件：

<!DOCTYPE html>
<html>
<head>
  <title>Spring MVC File Upload Example</title>
</head>
<body>
  <h1>Spring MVC File Upload Example</h1>
  <form method="POST" action="/upload" enctype="multipart/form-data">
    <input type="file" name="file" />
    <br/><br/>
    <input type="submit" value="Upload" />
  </form>
</body>
</html>

在上面的代码中，我们创建了一个 upload.html 文件，用于显示上传页面。

创建一个 uploadStatus.html 文件：

<!DOCTYPE html>
<html>
<head>
  <title>Spring MVC File Upload Example</title>
</head>
<body>
  <h1>Spring MVC File Upload Example</h1>
  <p th:text="${message}"></p>
</body>
</html>

在上面的代码中，我们创建了一个 uploadStatus.html 文件，用于显示上传状态页面。

示例2：实现多文件上传

在 Spring MVC 中实现多文件上传也非常简单。下面是一个示例代码，演示如何实现多文件上传：

创建一个 UploadController 类：

@Controller
public class UploadController {
  private static final String UPLOAD_FOLDER = "/path/to/upload/folder/";

  @GetMapping("/")
  public String index() {
    return "upload";
  }

  @PostMapping("/upload")
  public String handleFileUpload(@RequestParam("file") List<MultipartFile> files, RedirectAttributes redirectAttributes) {
    if (files.isEmpty()) {
      redirectAttributes.addFlashAttribute("message", "Please select a file to upload");
      return "redirect:/uploadStatus";
    }

    try {
      for (MultipartFile file : files) {
        byte[] bytes = file.getBytes();
        Path path = Paths.get(UPLOAD_FOLDER + file.getOriginalFilename());
        Files.write(path, bytes);
      }

      redirectAttributes.addFlashAttribute("message", "You successfully uploaded " + files.size() + " files");
    } catch (IOException e) {
      e.printStackTrace();
    }

    return "redirect:/uploadStatus";
  }

  @GetMapping("/uploadStatus")
  public String uploadStatus() {
    return "uploadStatus";
  }
}

在上面的代码中，我们创建了一个 UploadController 类，用于处理上传文件相关的请求。其中，handleFileUpload 方法用于处理上传文件，@RequestParam("file") List files 参数用于接收上传的多个文件。

创建一个 upload.html 文件：

<!DOCTYPE html>
<html>
<head>
  <title>Spring MVC File Upload Example</title>
</head>
<body>
  <h1>Spring MVC File Upload Example</h1>
  <form method="POST" action="/upload" enctype="multipart/form-data">
    <input type="file" name="file" multiple />
    <br/><br/>
    <input type="submit" value="Upload" />
  </form>
</body>
</html>

在上面的代码中，我们创建了一个 upload.html 文件，用于显示上传页面。注意，我们在 input 标签中添加了 multiple 属性，以支持多文件上传。

创建一个 uploadStatus.html 文件：

<!DOCTYPE html>
<html>
<head>
  <title>Spring MVC File Upload Example</title>
</head>
<body>
  <h1>Spring MVC File Upload Example</h1>
  <p th:text="${message}"></p>
</body>
</html>