萬盛學電腦網

您现在的位置: 萬盛學電腦網 >> 程式設計 >  >> 腳本程式專題 >> JavaScript

Java 圖片讀寫與縮圖生成實用工具類

核心功能

  • 讀取 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 坐標特點
Thumbnailatornet.coobird:thumbnailator:0.4.20流式 API、自動等比、支援水印、旋轉、裁剪
TwelveMonkeys ImageIOcom.twelvemonkeys.imageio:imageio-jpeg:3.9.4擴充 ImageIO 格式支援、CMYK、大圖分塊
Apache Commons Imagingorg.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
  • 生產環境建議引入成熟庫,避免重複造輪子
copyright © 萬盛學電腦網 all rights reserved