將字符串中的 `< > & " '` 替換為對應 HTML 實體,防止 XSS 或確保正確顯示;並提供檢測方法快速判斷是否包含特殊字符。
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**,獲得經過安全專家審計、上下文感知、高性能的編碼器,專注業務邏輯而非重造輪子。