183 lines
4.3 KiB
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("&");
|
|
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;
|
|
}
|
|
}
|