萬盛學電腦網

您现在的位置: 萬盛學電腦網 >> 程式設計 >  >> 網路程式設計 >> JSP 程式設計

Java Servlet 動態生成圖片完整教程:從 BufferedImage 到 JPEG 流輸出

核心原理

瀏覽器請求圖片時,服務端返回 HTTP 響應,Content-Type: image/jpeg + 二進制圖片數據流。Servlet 只需:

  1. 設置 response.setContentType("image/jpeg")
  2. 獲取 response.getOutputStream()
  3. 繪製圖像 → 編碼 → 寫入輸出流

依賴說明

示例使用 com.sun.image.codec.jpeg.JPEGImageEncoder(JDK 內部 API,位於 rt.jar)。

  • JDK 8 及以下:可直接使用,但屬於非標準 API,可能隨版本變動
  • JDK 9+:模塊化後默認不可訪問,需添加 --add-exports java.base/com.sun.image.codec.jpeg=ALL-UNNAMED
  • 生產環境推薦:使用標準 javax.imageio.ImageIO 或 TwelveMonkeys ImageIO 插件

完整 Servlet 實現

package com.example.web.util;

import java.awt.*;
import java.awt.image.BufferedImage;
import java.io.IOException;
import java.io.OutputStream;
import javax.servlet.ServletException;
import javax.servlet.http.*;
import javax.imageio.ImageIO; // 標準 API,推薦替代

public class CreateImageServlet extends HttpServlet {

    @Override
    protected void doGet(HttpServletRequest request, HttpServletResponse response)
            throws ServletException, IOException {
        
        response.setContentType("image/jpeg");
        response.setHeader("Pragma", "No-cache");
        response.setHeader("Cache-Control", "no-cache");
        response.setDateHeader("Expires", 0);
        
        createImage(response.getOutputStream());
    }

    private void createImage(OutputStream out) throws IOException {
        int width = 200, height = 100;
        
        // 1. 創建畫布
        BufferedImage bi = new BufferedImage(width, height, BufferedImage.TYPE_INT_RGB);
        Graphics2D g = bi.createGraphics();
        
        // 2. 繪製背景
        g.setRenderingHint(RenderingHints.KEY_ANTIALIASING, RenderingHints.VALUE_ANTIALIAS_ON);
        g.setColor(Color.WHITE);
        g.fillRect(0, 0, width, height);
        
        // 3. 繪製圖形/文本
        g.setColor(Color.BLUE);
        g.setFont(new Font("微軟雅黑", Font.BOLD, 24));
        g.drawString("動態生成圖片", 30, 50);
        
        g.setColor(Color.RED);
        g.drawLine(0, 0, width, height); // 對角線
        g.drawOval(50, 20, 100, 60);     // 圓形
        
        g.dispose(); // 釋放圖形資源
        
        // 4. 標準 API 編碼輸出(推薦)
        ImageIO.write(bi, "JPEG", out);
        
        /* 
        // 舊版 com.sun.image.codec.jpeg 寫法(不推薦)
        JPEGImageEncoder encoder = JPEGCodec.createJPEGEncoder(out);
        JPEGEncodeParam param = encoder.getDefaultJPEGEncodeParam(bi);
        param.setQuality(0.9f, false);
        encoder.setJPEGEncodeParam(param);
        encoder.encode(bi);
        */
    }
}

web.xml 註冊與測試

<servlet>
    <servlet-name>CreateImageServlet</servlet-name>
    <servlet-class>com.example.web.util.CreateImageServlet</servlet-class>
</servlet>
<servlet-mapping>
    <servlet-name>CreateImageServlet</servlet-name>
    <url-pattern>/CreateImage</url-pattern>
</servlet-mapping>

測試頁面 index.html

<!DOCTYPE html>
<html>
<head><title>動態圖片測試</title></head>
<body>
    <h3>Servlet 動態生成圖片</h3>
    <img src="CreateImage" alt="動態圖片" />
    <p>每次刷新圖片內容可變(如驗證碼、圖表)</p>
</body>
</html>

進階應用場景

場景關鍵技術點
驗證碼隨機字符、干擾線、噪點、字體扭曲、Session 存儲
統計圖表JFreeChart、ECharts (前端渲染更主流)、數據序列化
水印/簽名Alpha 合成、文字/圖片水印、批量處理
縮略圖Image.getScaledInstance()、Thumbnailator 庫
圖片合成Graphics2D.drawImage()、圖層疊加、透明度控制

性能優化建議

  • 對象池:BufferedImage、Graphics2D 可池化復用(注意線程安全)
  • 異步處理:耗時圖表生成放入異步任務,返回佔位圖/輪詢
  • 緩存策略:靜態圖表設置 Cache-Control: max-age=3600,動態圖片禁用緩存
  • 格式選擇:照片用 JPEG,圖標/透明背景用 PNG,動畫用 WebP/GIF
copyright © 萬盛學電腦網 all rights reserved