核心功能
- 讀取 JPEG/PNG/GIF/BMP 圖片
- 等比例縮放生成縮略圖
- JPEG 編碼輸出,可調品質
完整工具類
package util;
import java.awt.*;
import java.awt.image.BufferedImage;
import java.io.*;
import javax.imageio.ImageIO;
import com.sun.image.codec.jpeg.*;
public class ImageUtil {
/**
* 生成縮略圖
* @param srcPath 源圖路徑
* @param destPath 目標路徑
* @param maxWidth 最大寬度
* @param maxHeight 最大高度
* @param quality JPEG 品質 0-100
*/
public static void createThumbnail(String srcPath, String destPath,
int maxWidth, int maxHeight, int quality) throws IOException {
File srcFile = new File(srcPath);
BufferedImage srcImg = ImageIO.read(srcFile);
if (srcImg == null) throw new IOException("不支援的圖片格式: " + srcPath);
int srcW = srcImg.getWidth();
int srcH = srcImg.getHeight();
// 計算等比縮放尺寸
double scale = Math.min((double) maxWidth / srcW, (double) maxHeight / srcH);
int destW = (int) (srcW * scale);
int destH = (int) (srcH * scale);
// 高質量縮放
BufferedImage destImg = new BufferedImage(destW, destH, BufferedImage.TYPE_INT_RGB);
Graphics2D g2d = destImg.createGraphics();
g2d.setRenderingHint(RenderingHints.KEY_INTERPOLATION, RenderingHints.VALUE_INTERPOLATION_BILINEAR);
g2d.setRenderingHint(RenderingHints.KEY_RENDERING, RenderingHints.VALUE_RENDER_QUALITY);
g2d.drawImage(srcImg, 0, 0, destW, destH, null);
g2d.dispose();
// JPEG 輸出
try (FileOutputStream fos = new FileOutputStream(destPath)) {
JPEGImageEncoder encoder = JPEGCodec.createJPEGEncoder(fos);
JPEGEncodeParam param = encoder.getDefaultJPEGEncodeParam(destImg);
quality = Math.max(0, Math.min(quality, 100));
param.setQuality(quality / 100.0f, false);
encoder.setJPEGEncodeParam(param);
encoder.encode(destImg);
}
}
// 簡易版:固定縮放比例
public static void simpleScale(String src, String dest, double scale, int quality) throws IOException {
BufferedImage img = ImageIO.read(new File(src));
int w = (int) (img.getWidth() * scale);
int h = (int) (img.getHeight() * scale);
BufferedImage thumb = new BufferedImage(w, h, BufferedImage.TYPE_INT_RGB);
thumb.getGraphics().drawImage(img, 0, 0, w, h, null);
try (FileOutputStream fos = new FileOutputStream(dest)) {
JPEGCodec.createJPEGEncoder(fos).encode(thumb);
}
}
}
現代化替代:ImageIO + 標準 API (無需 com.sun.* 內部類)
import javax.imageio.*;
import javax.imageio.plugins.jpeg.*;
import java.util.Locale;
public static void writeJpeg(BufferedImage img, OutputStream out, float quality) throws IOException {
ImageWriter writer = ImageIO.getImageWritersByFormatName("jpeg").next();
ImageWriteParam param = writer.getDefaultWriteParam();
param.setCompressionMode(ImageWriteParam.MODE_EXPLICIT);
param.setCompressionQuality(quality); // 0.0f - 1.0f
writer.setOutput(ImageIO.createImageOutputStream(out));
writer.write(null, new IIOImage(img, null, null), param);
writer.dispose();
}
推薦第三方庫 (生產環境首選)
| 庫 | Maven 坐標 | 特點 |
| Thumbnailator | net.coobird:thumbnailator:0.4.20 | 流式 API、自動等比、支援水印、旋轉、裁剪 |
| TwelveMonkeys ImageIO | com.twelvemonkeys.imageio:imageio-jpeg:3.9.4 | 擴充 ImageIO 格式支援、CMYK、大圖分塊 |
| Apache Commons Imaging | org.apache.commons:commons-imaging:1.0-alpha2 | 無原生依賴、純 Java、支援 EXIF/ICC |
Thumbnailator 使用範例
Thumbnails.of(new File("input.jpg"))
.size(300, 200)
.keepAspectRatio(true)
.outputQuality(0.85)
.watermark(Positions.BOTTOM_RIGHT, ImageIO.read(new File("logo.png")), 0.5f)
.toFile("output.jpg");
注意事項
com.sun.image.codec.jpeg 為 JDK 內部 API,Java 9+ 已封裝/移除,勿用於新專案
- 處理大圖時注意
OutOfMemoryError,考慮分塊處理或增加 Heap
- PNG 透明背景需用
BufferedImage.TYPE_INT_ARGB 而非 TYPE_INT_RGB
- 生產環境建議引入成熟庫,避免重複造輪子