package com.kri.common.feature.util; public final class StringUtil { private StringUtil() { } private static final String BASIC_TEXT_REGEX = "^[가-힣a-zA-Z0-9()_\\-\\[\\] ]+$"; /** null 또는 "" 인지 */ public static boolean isNullOrEmpty(String s) { return s == null || s.isEmpty(); } /** null 또는 공백(whitespace)만 있는지 ("" 포함) - Java 11+ */ public static boolean isNullOrBlank(String s) { return s == null || s.isBlank(); } /** (옵션) 반대 버전도 같이 두면 실무에서 더 편함 */ public static boolean hasText(String s) { return s != null && !s.isBlank(); } public static String normalizeBlank(String raw) { if (raw == null) { return null; } String s = raw.trim(); return s.isEmpty() ? null : s; } public static String normalizeEmail(String raw) { String s = normalizeBlank(raw); if (s == null) { return null; } String email = s.toLowerCase(); return email.matches("^[^@\\s]+@[^@\\s]+\\.[^@\\s]+$") ? email : null; } public static String normalizeOnlyNumber(String raw) { String s = normalizeBlank(raw); if (s == null) { return null; } String digits = s.replaceAll("[^0-9]", ""); return digits.isBlank() ? null : digits; } public static boolean isBasicText(String raw){ return isBasicText(raw, BASIC_TEXT_REGEX); } public static boolean isBasicText(String raw, String regex){ String s = normalizeBlank(raw); if (s == null) { return true; } return s.matches(regex); } public static boolean isBasicEmail(String raw) { String s = normalizeBlank(raw); if (s == null) { return true; } return s.matches("^[^@\\s]+@[^@\\s]+\\.[^@\\s]+$"); } public static String escapeUnsafeText(String value) { if (value == null) { return null; } StringBuilder sb = new StringBuilder(value.length()); for (int i = 0; i < value.length(); ) { int cp = value.codePointAt(i); i += Character.charCount(cp); if (cp == '\t' || cp == '\n' || cp == '\r') { sb.appendCodePoint(cp); continue; } if (Character.isISOControl(cp)) { sb.append("\\u") .append(String.format("%04X", cp)); continue; } sb.appendCodePoint(cp); } return sb.toString(); } public static String escapeHtml(String value) { if (value == null) { return null; } StringBuilder sb = new StringBuilder(value.length()); for (int i = 0; i < value.length(); i++) { char c = value.charAt(i); switch (c) { case '&' -> sb.append("&"); case '<' -> sb.append("<"); case '>' -> sb.append(">"); case '"' -> sb.append("""); case '\'' -> sb.append("'"); case '/' -> sb.append("/"); default -> sb.append(c); } } return sb.toString(); } public static String escapeJson(String value) { if (value == null) { return null; } StringBuilder sb = new StringBuilder(value.length() + 16); for (int i = 0; i < value.length(); ) { int cp = value.codePointAt(i); i += Character.charCount(cp); switch (cp) { case '"' -> sb.append("\\\""); case '\\' -> sb.append("\\\\"); case '\b' -> sb.append("\\b"); case '\f' -> sb.append("\\f"); case '\n' -> sb.append("\\n"); case '\r' -> sb.append("\\r"); case '\t' -> sb.append("\\t"); default -> { if (cp < 0x20) { sb.append("\\u") .append(String.format("%04X", cp)); } else { sb.appendCodePoint(cp); } } } } return sb.toString(); } public static String escapeCsv(String value) { if (value == null) { return null; } boolean needsQuote = value.contains(",") || value.contains("\"") || value.contains("\n") || value.contains("\r"); String escaped = value.replace("\"", "\"\""); return needsQuote ? "\"" + escaped + "\"" : escaped; } public static String escapeExcelFormula(String value) { if (value == null || value.isEmpty()) { return value; } char first = value.charAt(0); if (first == '=' || first == '+' || first == '-' || first == '@') { return "'" + value; } return value; } }