Spring Boot 中实现图片文件压缩

图片文件压缩是 Web 应用中常见的需求，尤其是在处理用户上传或动态生成的图片时。压缩图片不仅可以减少服务器的存储空间，还能大幅提高网页加载速度和用户体验。在本文中，我们将探讨如何在 Spring Boot 中实现图片压缩，并提供接口供用户上传和下载压缩后的图片。

为什么要压缩图片？

减小文件体积：压缩图片可以显著减小文件大小，节省存储空间，提升加载速度。
提升加载速度：压缩后的图片加载更快，有助于优化前端性能，特别是在移动设备上。
降低带宽消耗：减少图片文件的大小，降低客户端和服务器之间的数据传输量，尤其在用户流量较大的情况下。
提高响应速度：压缩图片后，可以使得图片更快地上传和下载，减少响应时间。

常见的图片压缩格式包括 JPEG、PNG、WEBP 等，本文将介绍如何使用 Java 的图像处理库来实现图片的压缩。

在 Spring Boot 中压缩图片

Spring Boot 并未直接提供图片压缩功能，但我们可以结合一些开源图像处理库来实现。这里我们使用 Thumbnailator，一个轻量级的 Java 图片处理库，它提供了简洁的 API 来进行图片的缩放、压缩等操作。

步骤 1：添加依赖

首先，确保在 pom.xml 中加入 Thumbnailator 依赖。Thumbnailator 是一个非常强大的图像处理库，支持图片压缩、缩放、旋转等操作。

<dependency><groupId>net.coobird</groupId><artifactId>thumbnailator</artifactId><version>0.4.20</version>
</dependency>

步骤 2：创建图片压缩工具类

我们创建一个工具类，用来实现图片压缩功能。Thumbnailator 提供了一个非常简单的 API 来进行图片缩放和压缩。

import net.coobird.thumbnailator.Thumbnails;
import java.io.File;
import java.io.IOException;public class ImageUtils {// 压缩图片并保存public static void compressImage(String inputImagePath, String outputImagePath, int width, int height) throws IOException {Thumbnails.of(inputImagePath).size(width, height) // 设置目标图片大小.outputFormat("jpg")  // 设置输出图片格式.toFile(outputImagePath);  // 保存压缩后的图片}// 压缩图片并返回 byte[]public static byte[] compressImageToBytes(String inputImagePath, int width, int height) throws IOException {return Thumbnails.of(inputImagePath).size(width, height).outputFormat("jpg").asBytes();  // 返回字节数组}
}

compressImage 方法：该方法接收输入图片路径、输出路径、目标宽度和高度。它将图片压缩并保存为指定的路径。
compressImageToBytes 方法：该方法返回压缩后的图片字节数组，可以用于文件下载或者直接发送给客户端。

步骤 3：创建 Spring Boot 控制器提供压缩功能

接下来，我们创建一个 REST 控制器，让用户能够上传图片并获取压缩后的图片。

import org.springframework.http.*;
import org.springframework.web.bind.annotation.*;
import org.springframework.web.multipart.MultipartFile;import java.io.*;@RestController
@RequestMapping("/api/images")
public class ImageController {// 图片上传并压缩接口@PostMapping("/upload")public ResponseEntity<String> uploadImage(@RequestParam("file") MultipartFile file,@RequestParam("width") int width,@RequestParam("height") int height) throws IOException {// 获取图片文件并保存String inputFilePath = "uploads/" + file.getOriginalFilename();file.transferTo(new File(inputFilePath));// 压缩图片并保存到目标路径String outputFilePath = "uploads/compressed_" + file.getOriginalFilename();ImageUtils.compressImage(inputFilePath, outputFilePath, width, height);return ResponseEntity.ok("Image uploaded and compressed successfully!");}// 图片下载接口@GetMapping("/download/{filename}")public ResponseEntity<Resource> downloadImage(@PathVariable String filename) throws FileNotFoundException {File file = new File("uploads/compressed_" + filename);if (!file.exists()) {throw new FileNotFoundException("The file does not exist.");}// 使用 FileSystemResource 返回文件Resource resource = new FileSystemResource(file);// 设置响应头以便浏览器下载文件return ResponseEntity.ok().header(HttpHeaders.CONTENT_DISPOSITION, "attachment; filename=\"" + file.getName() + "\"").contentType(MediaType.parseMediaType("image/jpeg")).body(resource);}
}

解释

上传图片并压缩：
- 接受用户上传的图片文件和压缩后的目标宽度和高度。
- 使用 ImageUtils.compressImage 方法压缩并保存图片。
下载压缩后的图片：
- 用户可以通过 GET 请求下载压缩后的图片。返回的图片是通过 FileSystemResource 获取的，Spring 会自动处理文件下载的 HTTP 响应。

步骤 4：配置文件上传目录

为了保存上传的文件，你可以在 application.properties 中配置上传文件的存储目录：

# 设置上传文件的目录
spring.servlet.multipart.location=uploads

确保 uploads 文件夹存在，或者你可以在代码中动态创建该目录。

测试功能

上传图片并压缩：
- 使用 POST 请求，上传图片并设置压缩后的宽度和高度：
```
curl -X POST -F "file=@/path/to/your/image.jpg" -F "width=300" -F "height=300" http://localhost:8080/api/images/upload
```
- 这会将上传的图片压缩为 300x300 的大小，并保存在 uploads/compressed_image.jpg 路径下。
下载压缩后的图片：
- 使用 GET 请求下载压缩后的图片：
```
curl -O http://localhost:8080/api/images/download/compressed_image.jpg
```
- 这将下载压缩后的图片文件。

优化和改进

图片格式选择：当前我们默认将图片压缩为 JPEG 格式。如果需要其他格式（如 PNG、WEBP），可以通过 outputFormat 方法进行调整。

// 例1
Thumbnails.of(inputImagePath).size(width, height).outputFormat("png")  // 可改为 png 或其他格式.toFile(outputImagePath);// 例2
Thumbnails.of(inputStream).scale(1.0)                 // 保持原始尺寸.outputQuality(0.7)         // 设置压缩质量（0.7 可以根据需要调整）.outputFormat("jpg")        // 可指定输出格式.toOutputStream(outputStream);

文件大小限制：可以在 Spring Boot 的配置文件中设置文件上传的大小限制：
```
spring.servlet.multipart.max-file-size=5MB
spring.servlet.multipart.max-request-size=5MB
```
异步处理：对于大图片的上传和压缩过程，可以考虑使用 Spring Boot 的异步处理方式，避免阻塞主线程，提高系统性能。