Spring Boot 中实现图片文件压缩

最新推荐文章于 2025-05-26 14:15:55 发布

原创最新推荐文章于 2025-05-26 14:15:55 发布 · 2.9k 阅读

42 ·

CC 4.0 BY-SA版权

文章标签：

#spring boot #后端 #java

spring 专栏收录该内容

14 篇文章

订阅专栏

图片文件压缩是 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 的异步处理方式，避免阻塞主线程，提高系统性能。