Files
common-library/src/main/java/com/kri/common/feature/util/StringUtil.java

183 lines
4.3 KiB
Java

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("&amp;");
case '<' -> sb.append("&lt;");
case '>' -> sb.append("&gt;");
case '"' -> sb.append("&quot;");
case '\'' -> sb.append("&#x27;");
case '/' -> sb.append("&#x2F;");
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;
}
}