萬盛學電腦網

您现在的位置: 萬盛學電腦網 >> 程式設計 >  >> 網頁製作 >> HTML5 教學

HTML 標籤轉換/轉義工具類:Java 實現特殊字符替換與檢測

核心需求

將字符串中的 `< > & " '` 替換為對應 HTML 實體,防止 XSS 或確保正確顯示;並提供檢測方法快速判斷是否包含特殊字符。

完整 Java 工具類

public final class HtmlEscaper {

    private HtmlEscaper() {}

    /** 替換特殊字符為 HTML 實體 */
    public static String escape(String input) {
        if (input == null || input.isEmpty() || !containsSpecialChars(input)) {
            return input;
        }
        StringBuilder sb = new StringBuilder(input.length() + 16);
        for (int i = 0; i < input.length(); i++) {
            char c = input.charAt(i);
            switch (c) {
                case '<':  sb.append("<"); break;
                case '>':  sb.append(">"); break;
                case '&':  sb.append("&"); break;
                case '"':  sb.append("""); break;
                case '\'': sb.append("'"); break; // HTML5 支援 ',但 ' 更通用
                default:   sb.append(c);
            }
        }
        return sb.toString();
    }

    /** 快速檢測是否包含需轉義字符 */
    public static boolean containsSpecialChars(String input) {
        if (input == null || input.isEmpty()) return false;
        for (int i = 0; i < input.length(); i++) {
            char c = input.charAt(i);
            if (c == '<' || c == '>' || c == '&' || c == '"' || c == '\'') {
                return true;
            }
        }
        return false;
    }
}

使用示例

String userInput = "";
String safe = HtmlEscaper.escape(userInput);
// 結果:<script>alert('XSS')</script>

if (HtmlEscaper.containsSpecialChars(userInput)) {
    log.warn("輸入包含 HTML 特殊字符,已自動轉義");
}

生產環境建議:使用成熟庫

  • OWASP Java Encoder:`Encode.forHtml(input)`、`Encode.forHtmlAttribute(input)`、`Encode.forJavaScript(input)` 等上下文感知編碼器,高性能、零依賴、安全審計通過。
  • Apache Commons Text:`StringEscapeUtils.escapeHtml4(input)`。
  • Spring WebFlux / MVC:內建 `HtmlUtils.htmlEscape()`、`JavaScriptUtils.javaScriptEscape()`。

性能優化提示

  • 先用 `containsSpecialChars` 快速判斷,無特殊字符直接返回原字符串,避免 StringBuilder 分配。
  • 高頻調用路徑可考慮 `ThreadLocal` 復用 `StringBuilder` 或使用 `char[]` 手動擴容。
  • 配合 `@GwtIncompatible` 等標註避免 GWT 編譯問題。

結語

手寫轉義工具適合學習與極簡依賴場景,**生產系統請直接引入 OWASP Java Encoder**,獲得經過安全專家審計、上下文感知、高性能的編碼器,專注業務邏輯而非重造輪子。

copyright © 萬盛學電腦網 all rights reserved