在SpringBoot項(xiàng)目中實(shí)現(xiàn)圖片縮略圖功能的三種方案
更新時(shí)間：2025年10月24日 10:12:08 作者：匆匆忙忙游刃有余
本文介紹了在SpringBoot項(xiàng)目中實(shí)現(xiàn)圖片縮略圖的三種方案：使用Thumbnailator庫(kù)、JavaAWT原生庫(kù)以及集成MinIO自動(dòng)生成縮略圖,每種方案都詳細(xì)介紹了實(shí)現(xiàn)步驟,并提供了完整的案例,需要的朋友可以參考下
引言
在SpringBoot項(xiàng)目中實(shí)現(xiàn)圖片縮略圖功能，主要有兩種常用方案：使用第三方庫(kù)Thumbnailator（推薦）或使用Java AWT原生庫(kù)。下面詳細(xì)介紹這兩種實(shí)現(xiàn)方式及完整案例。
方案一：使用Thumbnailator庫(kù)（推薦）
Thumbnailator是Google開源的一個(gè)優(yōu)秀圖片處理庫(kù)，使用簡(jiǎn)單且功能強(qiáng)大。
1. 引入依賴
<dependency>
<groupId>net.coobird</groupId>
<artifactId>thumbnailator</artifactId>
<version>0.4.8</version>
</dependency>
2. 實(shí)現(xiàn)服務(wù)層
創(chuàng)建一個(gè)服務(wù)接口和實(shí)現(xiàn)類：
public interface IThumbnailsService {
// 指定大小縮放
String changeSize(MultipartFile file, int width, int height);
// 指定比例縮放
String changeScale(MultipartFile file, double scale);
}
@Service
public class ThumbnailsServiceImpl implements IThumbnailsService {
@Override
public String changeSize(MultipartFile file, int width, int height) {
try {
// 生成文件名
String originalFilename = file.getOriginalFilename();
String suffix = originalFilename.substring(originalFilename.lastIndexOf("."));
String fileName = UUID.randomUUID().toString() + suffix;
// 保存路徑
String uploadDir = "upload/thumbnail/";
File directory = new File(uploadDir);
if (!directory.exists()) {
directory.mkdirs();
}
String filePath = uploadDir + fileName;
// 使用Thumbnailator生成縮略圖
Thumbnails.of(file.getInputStream())
.size(width, height)
.keepAspectRatio(true) // 保持寬高比
.toFile(filePath);
return "success: " + filePath;
} catch (IOException e) {
e.printStackTrace();
return "error: " + e.getMessage();
}
}
@Override
public String changeScale(MultipartFile file, double scale) {
try {
String originalFilename = file.getOriginalFilename();
String suffix = originalFilename.substring(originalFilename.lastIndexOf("."));
String fileName = UUID.randomUUID().toString() + suffix;
String uploadDir = "upload/thumbnail/";
File directory = new File(uploadDir);
if (!directory.exists()) {
directory.mkdirs();
}
String filePath = uploadDir + fileName;
// 按比例縮放
Thumbnails.of(file.getInputStream())
.scale(scale) // scale是縮放比例，如0.5表示縮小到原圖的50%
.toFile(filePath);
return "success: " + filePath;
} catch (IOException e) {
e.printStackTrace();
return "error: " + e.getMessage();
}
}
}
3. 實(shí)現(xiàn)控制器
@RestController
@RequestMapping("/api/thumbnail")
public class ThumbnailsController {
@Autowired
private IThumbnailsService thumbnailsService;
/**
* 按指定尺寸生成縮略圖
*/
@PostMapping("/changeSize")
public String changeSize(@RequestParam("file") MultipartFile file,
@RequestParam(defaultValue = "300") int width,
@RequestParam(defaultValue = "300") int height) {
return thumbnailsService.changeSize(file, width, height);
}
/**
* 按比例生成縮略圖
*/
@PostMapping("/changeScale")
public String changeScale(@RequestParam("file") MultipartFile file,
@RequestParam(defaultValue = "0.5") double scale) {
return thumbnailsService.changeScale(file, scale);
}
}
方案二：使用Java AWT原生庫(kù)
如果不想引入第三方庫(kù)，也可以使用Java自帶的AWT庫(kù)實(shí)現(xiàn)圖片縮放功能。
1. 實(shí)現(xiàn)服務(wù)層
@Service
public class AWTThumbnailService {
public String generateThumbnail(MultipartFile file, int targetWidth, int targetHeight) {
try {
// 讀取原始圖片
BufferedImage originalImage = ImageIO.read(file.getInputStream());
// 計(jì)算等比例縮放后的尺寸
double widthRatio = (double) targetWidth / originalImage.getWidth();
double heightRatio = (double) targetHeight / originalImage.getHeight();
double ratio = Math.min(widthRatio, heightRatio);
int newWidth = (int) (originalImage.getWidth() * ratio);
int newHeight = (int) (originalImage.getHeight() * ratio);
// 創(chuàng)建縮略圖
BufferedImage thumbnail = new BufferedImage(newWidth, newHeight, BufferedImage.TYPE_INT_RGB);
Graphics2D g = thumbnail.createGraphics();
g.drawImage(originalImage.getScaledInstance(newWidth, newHeight, Image.SCALE_SMOOTH), 0, 0, null);
g.dispose();
// 保存縮略圖
String originalFilename = file.getOriginalFilename();
String suffix = originalFilename.substring(originalFilename.lastIndexOf(".") + 1);
String fileName = UUID.randomUUID().toString() + "." + suffix;
String uploadDir = "upload/thumbnail/";
File directory = new File(uploadDir);
if (!directory.exists()) {
directory.mkdirs();
}
String filePath = uploadDir + fileName;
File outputFile = new File(filePath);
ImageIO.write(thumbnail, suffix, outputFile);
return "success: " + filePath;
} catch (IOException e) {
e.printStackTrace();
return "error: " + e.getMessage();
}
}
}
高級(jí)功能擴(kuò)展
1. 批量生成不同尺寸縮略圖
@Override
public Map<String, String> generateMultiSizeThumbnails(MultipartFile file, Map<String, int[]> sizeMap) {
Map<String, String> result = new HashMap<>();
try {
String originalFilename = file.getOriginalFilename();
String suffix = originalFilename.substring(originalFilename.lastIndexOf("."));
String baseName = UUID.randomUUID().toString();
String uploadDir = "upload/thumbnail/";
File directory = new File(uploadDir);
if (!directory.exists()) {
directory.mkdirs();
}
for (Map.Entry<String, int[]> entry : sizeMap.entrySet()) {
String key = entry.getKey();
int width = entry.getValue()[0];
int height = entry.getValue()[1];
String fileName = baseName + "_" + key + suffix;
String filePath = uploadDir + fileName;
Thumbnails.of(file.getInputStream())
.size(width, height)
.keepAspectRatio(true)
.toFile(filePath);
result.put(key, filePath);
}
} catch (IOException e) {
e.printStackTrace();
result.put("error", e.getMessage());
}
return result;
}
2. 異步生成縮略圖（優(yōu)化性能）
對(duì)于大量圖片或大圖片的處理，可以使用異步方式：
@Configuration
@EnableAsync
public class AsyncConfig {
@Bean("thumbnailThreadPool")
public Executor thumbnailThreadPool() {
ThreadPoolTaskExecutor executor = new ThreadPoolTaskExecutor();
executor.setCorePoolSize(5);
executor.setMaxPoolSize(10);
executor.setQueueCapacity(25);
executor.setThreadNamePrefix("thumbnail-pool-");
executor.initialize();
return executor;
}
}
@Service
public class AsyncThumbnailService {
@Async("thumbnailThreadPool")
public CompletableFuture<String> asyncGenerateThumbnail(MultipartFile file, int width, int height) {
// 實(shí)現(xiàn)與同步方法類似
// ...
return CompletableFuture.completedFuture(filePath);
}
}
方案三：集成MinIO自動(dòng)生成縮略圖
如果項(xiàng)目使用MinIO存儲(chǔ)圖片，可以使用minio-plus-spring-boot-starter實(shí)現(xiàn)上傳時(shí)自動(dòng)生成縮略圖。
1. 引入依賴
<dependency>
<groupId>com.github.ixleo</groupId>
<artifactId>minio-plus-spring-boot-starter</artifactId>
<version>2.2.0</version>
</dependency>
2. 配置文件
minio:
endpoint: http://minio:9000
access-key: minioadmin
secret-key: minioadmin
plus:
thumbnail-width: 300 # 默認(rèn)縮略圖寬度
thumbnail-bucket: ${bucket}-preview # 縮略圖存儲(chǔ)桶
3. 使用示例
@Service
public class MinioThumbnailService {
@Autowired
private MinioPlusTemplate minioPlusTemplate;
public String uploadWithThumbnail(MultipartFile file, String bucketName) {
try {
// 上傳原圖并自動(dòng)生成縮略圖
String originUrl = minioPlusTemplate.putObject(bucketName, file);
// 獲取縮略圖URL
String thumbUrl = minioPlusTemplate.getPreviewUrl(bucketName, file.getOriginalFilename());
return thumbUrl;
} catch (Exception e) {
e.printStackTrace();
return null;
}
}
}
注意事項(xiàng)和優(yōu)化建議
圖片格式支持：確保支持常用圖片格式(JPG、PNG、GIF等)，并在代碼中進(jìn)行格式驗(yàn)證
文件大小限制：配置文件上傳大小限制，防止大文件占用過多資源
spring.servlet.multipart.max-file-size=10MB spring.servlet.multipart.max-request-size=10MB
異常處理：完善異常捕獲和處理，提供友好的錯(cuò)誤信息
文件路徑安全：使用UUID生成文件名，避免路徑遍歷攻擊
存儲(chǔ)空間管理：定期清理過期的臨時(shí)文件和縮略圖
性能優(yōu)化：對(duì)于大量圖片處理，考慮使用多線程異步處理
通過以上幾種方式，您可以在SpringBoot項(xiàng)目中靈活實(shí)現(xiàn)圖片縮略圖功能，根據(jù)實(shí)際需求選擇最合適的方案。
以上就是在SpringBoot項(xiàng)目中實(shí)現(xiàn)圖片縮略圖功能的三種方案的詳細(xì)內(nèi)容，更多關(guān)于SpringBoot圖片縮略圖的資料請(qǐng)關(guān)注腳本之家其它相關(guān)文章！
相關(guān)文章
這篇文章主要介紹了Java的抽象類,是Java入門學(xué)習(xí)中的基礎(chǔ)知識(shí),需要的朋友可以參考下2015-09-09
Java使用Spire.Doc for Java實(shí)現(xiàn)自動(dòng)創(chuàng)建Word文檔
在日常的軟件開發(fā)中,我們常常會(huì)遇到需要程序化生成 Word 文檔的需求,本教程將深入探討如何利用 Spire.Doc for Java 這一強(qiáng)大庫(kù),幫助開發(fā)者掌握 Java 創(chuàng)建 Word 文檔的核心技能,希望對(duì)大家有所幫助2025-10-10
一文學(xué)會(huì)如何在SpringBoot中使用線程池執(zhí)行定時(shí)任務(wù)
在開發(fā)現(xiàn)代應(yīng)用程序時(shí)，定時(shí)任務(wù)是一項(xiàng)常見的需求，SpringBoot提供了一個(gè)強(qiáng)大的定時(shí)任務(wù)框架，可以輕松地執(zhí)行各種定時(shí)任務(wù)，結(jié)合線程池的使用，可以更好地管理任務(wù)的執(zhí)行，提高系統(tǒng)的性能和穩(wěn)定性，本文將介紹如何在Spring Boot中使用線程池執(zhí)行定時(shí)任務(wù)2023-06-06
SpringBoot2.0 整合 SpringSecurity 框架實(shí)現(xiàn)用戶權(quán)限安全管理方法
Spring Security是一個(gè)能夠?yàn)榛赟pring的企業(yè)應(yīng)用系統(tǒng)提供聲明式的安全訪問控制解決方案的安全框架。這篇文章主要介紹了SpringBoot2.0 整合 SpringSecurity 框架，實(shí)現(xiàn)用戶權(quán)限安全管理 ,需要的朋友可以參考下2019-07-07
Mybatis一對(duì)多與多對(duì)一查詢處理詳解
這篇文章主要給大家介紹了關(guān)于Mybatis一對(duì)多與多對(duì)一查詢處理的相關(guān)資料，文中通過示例代碼介紹的非常詳細(xì)，對(duì)大家的學(xué)習(xí)或者工作具有一定的參考學(xué)習(xí)價(jià)值，需要的朋友們下面隨著小編來(lái)一起學(xué)習(xí)學(xué)習(xí)吧2021-03-03
在介紹RabbitMQ之前實(shí)現(xiàn)要介紹一下MQ，MQ是什么？MQ全稱是Message Queue，可以理解為消息隊(duì)列的意思，簡(jiǎn)單來(lái)說就是消息以管道的方式進(jìn)行傳遞。RabbitMQ是一個(gè)實(shí)現(xiàn)了AMQP（Advanced Message Queuing Protocol）高級(jí)消息隊(duì)列協(xié)議的消息隊(duì)列服務(wù)，用Erlang語(yǔ)言的2021-11-11
Java如何實(shí)現(xiàn)海量數(shù)據(jù)判重
在海量數(shù)據(jù)如何確定一個(gè)值是否存在？這是一道非常經(jīng)典的面試場(chǎng)景題,那怎么回答這個(gè)問題呢？下面小編就來(lái)和大家詳細(xì)的聊一聊,感興趣的可以一起學(xué)習(xí)一下2023-09-09
這篇文章主要為大家詳細(xì)介紹了Java中CountDownLatch類的用法，本文通過一些簡(jiǎn)單的示例進(jìn)行了簡(jiǎn)單介紹，感興趣的小伙伴可以跟隨小編一起了解一下2023-05-05
這篇文章主要介紹了Java并發(fā)框架中的AQS詳細(xì)解析,之前說鎖的升級(jí)的時(shí)候,說到了自旋鎖會(huì)空轉(zhuǎn)幾次嘗試等待獲取資源,其實(shí)這一系列的動(dòng)作是有一個(gè)規(guī)范的這個(gè)規(guī)范叫做同步發(fā)生器AbstractQueuedSynchronizer ,簡(jiǎn)稱AQS,需要的朋友可以參考下2024-01-01
這篇文章主要介紹了Java日期時(shí)間類及計(jì)算詳解，文章圍繞主題展開詳細(xì)的內(nèi)容介紹，具有一定的參考價(jià)值，需要的小伙伴可以參考一下，希望對(duì)你的學(xué)習(xí)有所幫助2022-07-07