Code - chominsoo4245/mjon

/** * @Class Name : EgovStringUtil.java * @Description : 문자열 데이터 처리 관련 유틸리티 * @Modification Information * * 수정일 수정자 수정내용 * ------- -------- --------------------------- * 2009.01.13 박정규 최초 생성 * 2009.02.13 이삼섭 내용 추가 * * @author 공통 서비스 개발팀 박정규 * @since 2009. 01. 13 * @version 1.0 * @see * */ package itn.let.utl.fcc.service; /* * Copyright 2001-2006 The Apache Software Foundation. * * Licensed under the Apache License, Version 2.0 (the ";License"); * you may not use this file except in compliance with the License. * You may obtain a copy of the License at * * http://www.apache.org/licenses/LICENSE-2.0 * * Unless required by applicable law or agreed to in writing, software * distributed under the License is distributed on an "AS IS"; BASIS, * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. * See the License for the specific language governing permissions and * limitations under the License. */ import java.io.UnsupportedEncodingException; import java.math.BigDecimal; import java.security.SecureRandom; import java.sql.Timestamp; import java.text.SimpleDateFormat; import java.util.Locale; import org.slf4j.Logger; import org.slf4j.LoggerFactory; public class EgovStringUtil { private static final Logger LOGGER = LoggerFactory.getLogger(EgovStringUtil.class); /** * 빈 문자열 <code>""</code>. */ public static final String EMPTY = ""; /** * Padding을 할 수 있는 최대 수치 */ // private static final int PAD_LIMIT = 8192; /** * An array of <code>String</code>s used for padding. * Used for efficient space padding. The length of each String expands as needed. */ /* private static final String[] PADDING = new String[Character.MAX_VALUE]; static { // space padding is most common, start with 64 chars PADDING[32] = " "; } */ /** * 문자열이 지정한 길이를 초과했을때 지정한길이에다가 해당 문자열을 붙여주는 메서드. * @param source 원본 문자열 배열 * @param output 더할문자열 * @param slength 지정길이 * @return 지정길이로 잘라서 더할분자열 합친 문자열 */ public static String cutString(String source, String output, int slength) { String returnVal = null; if (source != null) { if (source.length() > slength) { returnVal = source.substring(0, slength) + output; } else returnVal = source; } return returnVal; } /** * 문자열이 지정한 길이를 초과했을때 해당 문자열을 삭제하는 메서드 * @param source 원본 문자열 배열 * @param slength 지정길이 * @return 지정길이로 잘라서 더할분자열 합친 문자열 */ public static String cutString(String source, int slength) { String result = null; if (source != null) { if (source.length() > slength) { result = source.substring(0, slength); } else result = source; } return result; } /** * * String이 비었거나("") 혹은 null 인지 검증한다. * * * <pre> * StringUtil.isEmpty(null) = true * StringUtil.isEmpty("") = true * StringUtil.isEmpty(" ") = false * StringUtil.isEmpty("bob") = false * StringUtil.isEmpty(" bob ") = false * </pre> * * @param str - 체크 대상 스트링오브젝트이며 null을 허용함 * @return <code>true</code> - 입력받은 String 이 빈 문자열 또는 null인 경우 */ public static boolean isEmpty(String str) { return str == null || str.length() == 0; } /** * 기준 문자열에 포함된 모든 대상 문자(char)를 제거한다. * * <pre> * StringUtil.remove(null, *) = null * StringUtil.remove("", *) = "" * StringUtil.remove("queued", 'u') = "qeed" * StringUtil.remove("queued", 'z') = "queued" * </pre> * * @param str 입력받는 기준 문자열 * @param remove 입력받는 문자열에서 제거할 대상 문자열 * @return 제거대상 문자열이 제거된 입력문자열. 입력문자열이 null인 경우 출력문자열은 null */ public static String remove(String str, char remove) { if (isEmpty(str) || str.indexOf(remove) == -1) { return str; } char[] chars = str.toCharArray(); int pos = 0; for (int i = 0; i < chars.length; i++) { if (chars[i] != remove) { chars[pos++] = chars[i]; } } return new String(chars, 0, pos); } /** * 문자열 내부의 콤마 character(,)를 모두 제거한다. * * <pre> * StringUtil.removeCommaChar(null) = null * StringUtil.removeCommaChar("") = "" * StringUtil.removeCommaChar("asdfg,qweqe") = "asdfgqweqe" * </pre> * * @param str 입력받는 기준 문자열 * @return " , "가 제거된 입력문자열 * 입력문자열이 null인 경우 출력문자열은 null */ public static String removeCommaChar(String str) { return remove(str, ','); } /** * 문자열 내부의 마이너스 character(-)를 모두 제거한다. * * <pre> * StringUtil.removeMinusChar(null) = null * StringUtil.removeMinusChar("") = "" * StringUtil.removeMinusChar("a-sdfg-qweqe") = "asdfgqweqe" * </pre> * * @param str 입력받는 기준 문자열 * @return " - "가 제거된 입력문자열 * 입력문자열이 null인 경우 출력문자열은 null */ public static String removeMinusChar(String str) { return remove(str, '-'); } /** * 원본 문자열의 포함된 특정 문자열을 새로운 문자열로 변환하는 메서드 * @param source 원본 문자열 * @param subject 원본 문자열에 포함된 특정 문자열 * @param object 변환할 문자열 * @return sb.toString() 새로운 문자열로 변환된 문자열 */ public static String replace(String source, String subject, String object) { StringBuffer rtnStr = new StringBuffer(); String preStr = ""; String nextStr = source; String srcStr = source; while (srcStr.indexOf(subject) >= 0) { preStr = srcStr.substring(0, srcStr.indexOf(subject)); nextStr = srcStr.substring(srcStr.indexOf(subject) + subject.length(), srcStr.length()); srcStr = nextStr; rtnStr.append(preStr).append(object); } rtnStr.append(nextStr); return rtnStr.toString(); } /** * 원본 문자열의 포함된 특정 문자열 첫번째 한개만 새로운 문자열로 변환하는 메서드 * @param source 원본 문자열 * @param subject 원본 문자열에 포함된 특정 문자열 * @param object 변환할 문자열 * @return sb.toString() 새로운 문자열로 변환된 문자열 / source 특정문자열이 없는 경우 원본 문자열 */ public static String replaceOnce(String source, String subject, String object) { StringBuffer rtnStr = new StringBuffer(); String preStr = ""; String nextStr = source; if (source.indexOf(subject) >= 0) { preStr = source.substring(0, source.indexOf(subject)); nextStr = source.substring(source.indexOf(subject) + subject.length(), source.length()); rtnStr.append(preStr).append(object).append(nextStr); return rtnStr.toString(); } else { return source; } } /** * <code>subject</code>에 포함된 각각의 문자를 object로 변환한다. * * @param source 원본 문자열 * @param subject 원본 문자열에 포함된 특정 문자열 * @param object 변환할 문자열 * @return sb.toString() 새로운 문자열로 변환된 문자열 */ public static String replaceChar(String source, String subject, String object) { StringBuffer rtnStr = new StringBuffer(); String preStr = ""; String nextStr = source; String srcStr = source; char chA; for (int i = 0; i < subject.length(); i++) { chA = subject.charAt(i); if (srcStr.indexOf(chA) >= 0) { preStr = srcStr.substring(0, srcStr.indexOf(chA)); nextStr = srcStr.substring(srcStr.indexOf(chA) + 1, srcStr.length()); srcStr = rtnStr.append(preStr).append(object).append(nextStr).toString(); } } return srcStr; } /** * <code>str</code> 중 <code>searchStr</code>의 시작(index) 위치를 반환. * * 입력값 중 <code>null</code>이 있을 경우 <code>-1</code>을 반환. * * <pre> * StringUtil.indexOf(null, *) = -1 * StringUtil.indexOf(*, null) = -1 * StringUtil.indexOf("", "") = 0 * StringUtil.indexOf("aabaabaa", "a") = 0 * StringUtil.indexOf("aabaabaa", "b") = 2 * StringUtil.indexOf("aabaabaa", "ab") = 1 * StringUtil.indexOf("aabaabaa", "") = 0 * </pre> * * @param str 검색 문자열 * @param searchStr 검색 대상문자열 * @return 검색 문자열 중 검색 대상문자열이 있는 시작 위치 검색대상 문자열이 없거나 null인 경우 -1 */ public static int indexOf(String str, String searchStr) { if (str == null || searchStr == null) { return -1; } return str.indexOf(searchStr); } /** * 오라클의 decode 함수와 동일한 기능을 가진 메서드이다. * <code>sourStr</code>과 <code>compareStr</code>의 값이 같으면 * <code>returStr</code>을 반환하며, 다르면 <code>defaultStr</code>을 반환한다. * * * <pre> * StringUtil.decode(null, null, "foo", "bar")= "foo" * StringUtil.decode("", null, "foo", "bar") = "bar" * StringUtil.decode(null, "", "foo", "bar") = "bar" * StringUtil.decode("하이", "하이", null, "bar") = null * StringUtil.decode("하이", "하이 ", "foo", null) = null * StringUtil.decode("하이", "하이", "foo", "bar") = "foo" * StringUtil.decode("하이", "하이 ", "foo", "bar") = "bar" * </pre> * * @param sourceStr 비교할 문자열 * @param compareStr 비교 대상 문자열 * @param returnStr sourceStr와 compareStr의 값이 같을 때 반환할 문자열 * @param defaultStr sourceStr와 compareStr의 값이 다를 때 반환할 문자열 * @return sourceStr과 compareStr의 값이 동일(equal)할 때 returnStr을 반환하며, * 다르면 defaultStr을 반환한다. */ public static String decode(String sourceStr, String compareStr, String returnStr, String defaultStr) { if (sourceStr == null && compareStr == null) { return returnStr; } if (sourceStr == null && compareStr != null) { return defaultStr; } if (sourceStr.trim().equals(compareStr)) { return returnStr; } return defaultStr; } /** * 오라클의 decode 함수와 동일한 기능을 가진 메서드이다. * <code>sourStr</code>과 <code>compareStr</code>의 값이 같으면 * <code>returStr</code>을 반환하며, 다르면 <code>sourceStr</code>을 반환한다. * * * <pre> * StringUtil.decode(null, null, "foo") = "foo" * StringUtil.decode("", null, "foo") = "" * StringUtil.decode(null, "", "foo") = null * StringUtil.decode("하이", "하이", "foo") = "foo" * StringUtil.decode("하이", "하이 ", "foo") = "하이" * StringUtil.decode("하이", "바이", "foo") = "하이" * </pre> * * @param sourceStr 비교할 문자열 * @param compareStr 비교 대상 문자열 * @param returnStr sourceStr와 compareStr의 값이 같을 때 반환할 문자열 * @return sourceStr과 compareStr의 값이 동일(equal)할 때 returnStr을 반환하며, * 다르면 sourceStr을 반환한다. */ public static String decode(String sourceStr, String compareStr, String returnStr) { return decode(sourceStr, compareStr, returnStr, sourceStr); } /** * 객체가 null인지 확인하고 null인 경우 "" 로 바꾸는 메서드 * @param object 원본 객체 * @return resultVal 문자열 */ public static String isNullToString(Object object) { String string = ""; if (object != null) { string = object.toString().trim(); } return string; } /** *<pre> * 인자로 받은 String이 null일 경우 ""로 리턴한다. * @param src null값일 가능성이 있는 String 값. * @return 만약 String이 null 값일 경우 ""로 바꾼 String 값. *</pre> */ public static String nullConvert(Object src) { //if (src != null && src.getClass().getName().equals("java.math.BigDecimal")) { if (src != null && src instanceof java.math.BigDecimal) { return ((BigDecimal)src).toString(); } if (src == null || src.equals("null")) { return ""; } else { return ((String)src).trim(); } } /** *<pre> * 인자로 받은 String이 null일 경우 ""로 리턴한다. * @param src null값일 가능성이 있는 String 값. * @return 만약 String이 null 값일 경우 ""로 바꾼 String 값. *</pre> */ public static String nullConvert(String src) { if (src == null || src.equals("null") || "".equals(src) || " ".equals(src)) { return ""; } else { return src.trim(); } } /** *<pre> * 인자로 받은 String이 null일 경우 "0"로 리턴한다. * @param src null값일 가능성이 있는 String 값. * @return 만약 String이 null 값일 경우 "0"로 바꾼 String 값. *</pre> */ public static int zeroConvert(Object src) { if (src == null || src.equals("null")) { return 0; } else { return Integer.parseInt(((String)src).trim()); } } /** *<pre> * 인자로 받은 String이 null일 경우 ""로 리턴한다. * @param src null값일 가능성이 있는 String 값. * @return 만약 String이 null 값일 경우 ""로 바꾼 String 값. *</pre> */ public static int zeroConvert(String src) { if (src == null || src.equals("null") || "".equals(src) || " ".equals(src)) { return 0; } else { return Integer.parseInt(src.trim()); } } /** * 문자열에서 {@link Character#isWhitespace(char)}에 정의된 * 모든 공백문자를 제거한다. * * <pre> * StringUtil.removeWhitespace(null) = null * StringUtil.removeWhitespace("") = "" * StringUtil.removeWhitespace("abc") = "abc" * StringUtil.removeWhitespace(" ab c ") = "abc" * </pre> * * @param str 공백문자가 제거도어야 할 문자열 * @return the 공백문자가 제거된 문자열, null이 입력되면 <code>null</code>이 리턴 */ public static String removeWhitespace(String str) { if (isEmpty(str)) { return str; } int sz = str.length(); char[] chs = new char[sz]; int count = 0; for (int i = 0; i < sz; i++) { if (!Character.isWhitespace(str.charAt(i))) { chs[count++] = str.charAt(i); } } if (count == sz) { return str; } return new String(chs, 0, count); } /** * Html 코드가 들어간 문서를 표시할때 태그에 손상없이 보이기 위한 메서드 * * @param strString * @return HTML 태그를 치환한 문자열 */ public static String checkHtmlView(String strString) { String strNew = ""; StringBuffer strTxt = new StringBuffer(""); char chrBuff; int len = strString.length(); for (int i = 0; i < len; i++) { chrBuff = (char) strString.charAt(i); switch (chrBuff) { case '<': strTxt.append("<"); break; case '>': strTxt.append(">"); break; case '"': strTxt.append("""); break; case 10: strTxt.append(" "); break; case ' ': strTxt.append(" "); break; //case '&' : //strTxt.append("&"); //break; default: strTxt.append(chrBuff); } } strNew = strTxt.toString(); return strNew; } /** * 문자열을 지정한 분리자에 의해 배열로 리턴하는 메서드. * @param source 원본 문자열 * @param separator 분리자 * @return result 분리자로 나뉘어진 문자열 배열 */ public static String[] split(String source, String separator) throws NullPointerException { String[] returnVal = null; int cnt = 1; int index = source.indexOf(separator); int index0 = 0; while (index >= 0) { cnt++; index = source.indexOf(separator, index + 1); } returnVal = new String[cnt]; cnt = 0; index = source.indexOf(separator); while (index >= 0) { returnVal[cnt] = source.substring(index0, index); index0 = index + 1; index = source.indexOf(separator, index + 1); cnt++; } returnVal[cnt] = source.substring(index0); return returnVal; } /** * {@link String#toLowerCase()}를 이용하여 소문자로 변환한다. * * <pre> * StringUtil.lowerCase(null) = null * StringUtil.lowerCase("") = "" * StringUtil.lowerCase("aBc") = "abc" * </pre> * * @param str 소문자로 변환되어야 할 문자열 * @return 소문자로 변환된 문자열, null이 입력되면 <code>null</code> 리턴 */ public static String lowerCase(String str) { if (str == null) { return null; } return str.toLowerCase(); } /** * {@link String#toUpperCase()}를 이용하여 대문자로 변환한다. * * <pre> * StringUtil.upperCase(null) = null * StringUtil.upperCase("") = "" * StringUtil.upperCase("aBc") = "ABC" * </pre> * * @param str 대문자로 변환되어야 할 문자열 * @return 대문자로 변환된 문자열, null이 입력되면 <code>null</code> 리턴 */ public static String upperCase(String str) { if (str == null) { return null; } return str.toUpperCase(); } /** * 입력된 String의 앞쪽에서 두번째 인자로 전달된 문자(stripChars)를 모두 제거한다. * * <pre> * StringUtil.stripStart(null, *) = null * StringUtil.stripStart("", *) = "" * StringUtil.stripStart("abc", "") = "abc" * StringUtil.stripStart("abc", null) = "abc" * StringUtil.stripStart(" abc", null) = "abc" * StringUtil.stripStart("abc ", null) = "abc " * StringUtil.stripStart(" abc ", null) = "abc " * StringUtil.stripStart("yxabc ", "xyz") = "abc " * </pre> * * @param str 지정된 문자가 제거되어야 할 문자열 * @param stripChars 제거대상 문자열 * @return 지정된 문자가 제거된 문자열, null이 입력되면 <code>null</code> 리턴 */ public static String stripStart(String str, String stripChars) { int strLen; if (str == null || (strLen = str.length()) == 0) { return str; } int start = 0; if (stripChars == null) { while ((start != strLen) && Character.isWhitespace(str.charAt(start))) { start++; } } else if (stripChars.length() == 0) { return str; } else { while ((start != strLen) && (stripChars.indexOf(str.charAt(start)) != -1)) { start++; } } return str.substring(start); } /** * 입력된 String의 뒤쪽에서 두번째 인자로 전달된 문자(stripChars)를 모두 제거한다. * * <pre> * StringUtil.stripEnd(null, *) = null * StringUtil.stripEnd("", *) = "" * StringUtil.stripEnd("abc", "") = "abc" * StringUtil.stripEnd("abc", null) = "abc" * StringUtil.stripEnd(" abc", null) = " abc" * StringUtil.stripEnd("abc ", null) = "abc" * StringUtil.stripEnd(" abc ", null) = " abc" * StringUtil.stripEnd(" abcyx", "xyz") = " abc" * </pre> * * @param str 지정된 문자가 제거되어야 할 문자열 * @param stripChars 제거대상 문자열 * @return 지정된 문자가 제거된 문자열, null이 입력되면 <code>null</code> 리턴 */ public static String stripEnd(String str, String stripChars) { int end; if (str == null || (end = str.length()) == 0) { return str; } if (stripChars == null) { while ((end != 0) && Character.isWhitespace(str.charAt(end - 1))) { end--; } } else if (stripChars.length() == 0) { return str; } else { while ((end != 0) && (stripChars.indexOf(str.charAt(end - 1)) != -1)) { end--; } } return str.substring(0, end); } /** * 입력된 String의 앞, 뒤에서 두번째 인자로 전달된 문자(stripChars)를 모두 제거한다. * * <pre> * StringUtil.strip(null, *) = null * StringUtil.strip("", *) = "" * StringUtil.strip("abc", null) = "abc" * StringUtil.strip(" abc", null) = "abc" * StringUtil.strip("abc ", null) = "abc" * StringUtil.strip(" abc ", null) = "abc" * StringUtil.strip(" abcyx", "xyz") = " abc" * </pre> * * @param str 지정된 문자가 제거되어야 할 문자열 * @param stripChars 제거대상 문자열 * @return 지정된 문자가 제거된 문자열, null이 입력되면 <code>null</code> 리턴 */ public static String strip(String str, String stripChars) { if (isEmpty(str)) { return str; } String srcStr = str; srcStr = stripStart(srcStr, stripChars); return stripEnd(srcStr, stripChars); } /** * 문자열을 지정한 분리자에 의해 지정된 길이의 배열로 리턴하는 메서드. * @param source 원본 문자열 * @param separator 분리자 * @param arraylength 배열 길이 * @return 분리자로 나뉘어진 문자열 배열 */ public static String[] split(String source, String separator, int arraylength) throws NullPointerException { String[] returnVal = new String[arraylength]; int cnt = 0; int index0 = 0; int index = source.indexOf(separator); while (index >= 0 && cnt < (arraylength - 1)) { returnVal[cnt] = source.substring(index0, index); index0 = index + 1; index = source.indexOf(separator, index + 1); cnt++; } returnVal[cnt] = source.substring(index0); if (cnt < (arraylength - 1)) { for (int i = cnt + 1; i < arraylength; i++) { returnVal[i] = ""; } } return returnVal; } /** * 문자열 A에서 Z사이의 랜덤 문자열을 구하는 기능을 제공 시작문자열과 종료문자열 사이의 랜덤 문자열을 구하는 기능 * * @param startChr * - 첫 문자 * @param endChr * - 마지막문자 * @return 랜덤문자 * @exception MyException * @see */ public static String getRandomStr(char startChr, char endChr) { int randomInt; String randomStr = null; // 시작문자 및 종료문자를 아스키숫자로 변환한다. int startInt = Integer.valueOf(startChr); int endInt = Integer.valueOf(endChr); // 시작문자열이 종료문자열보가 클경우 if (startInt > endInt) { throw new IllegalArgumentException("Start String: " + startChr + " End String: " + endChr); } // 랜덤 객체 생성 SecureRandom rnd = new SecureRandom(); do { // 시작문자 및 종료문자 중에서 랜덤 숫자를 발생시킨다. randomInt = rnd.nextInt(endInt + 1); } while (randomInt < startInt); // 입력받은 문자 'A'(65)보다 작으면 다시 랜덤 숫자 발생. // 랜덤 숫자를 문자로 변환 후 스트링으로 다시 변환 randomStr = (char) randomInt + ""; // 랜덤문자열를 리턴 return randomStr; } /** * 문자열을 다양한 문자셋(EUC-KR[KSC5601],UTF-8..)을 사용하여 인코딩하는 기능 역으로 디코딩하여 원래의 문자열을 * 복원하는 기능을 제공함 String temp = new String(문자열.getBytes("바꾸기전 인코딩"),"바꿀 인코딩"); * String temp = new String(문자열.getBytes("8859_1"),"KSC5601"); => UTF-8 에서 * EUC-KR * * @param srcString * - 문자열 * @param srcCharsetNm * - 원래 CharsetNm * @param charsetNm * - CharsetNm * @return 인(디)코딩 문자열 * @exception MyException * @see */ public static String getEncdDcd(String srcString, String srcCharsetNm, String cnvrCharsetNm) { String rtnStr = null; if (srcString == null) return null; try { rtnStr = new String(srcString.getBytes(srcCharsetNm), cnvrCharsetNm); } catch (UnsupportedEncodingException e) { rtnStr = null; } return rtnStr; } /** * 특수문자를 웹 브라우저에서 정상적으로 보이기 위해 특수문자를 처리('<' -> & lT)하는 기능이다 * @param srcString - '<' * @return 변환문자열('<' -> "&lt" * @exception MyException * @see */ public static String getSpclStrCnvr(String srcString) { String rtnStr = null; try { StringBuffer strTxt = new StringBuffer(""); char chrBuff; int len = srcString.length(); for (int i = 0; i < len; i++) { chrBuff = (char)srcString.charAt(i); switch (chrBuff) { case '<': strTxt.append("<"); break; case '>': strTxt.append(">"); break; case '&': strTxt.append("&"); break; default: strTxt.append(chrBuff); } } rtnStr = strTxt.toString(); } catch (Exception e) { LOGGER.debug("{}", e); } return rtnStr; } /** * 응용어플리케이션에서 고유값을 사용하기 위해 시스템에서17자리의TIMESTAMP값을 구하는 기능 * * @param * @return Timestamp 값 * @exception MyException * @see */ public static String getTimeStamp() { String rtnStr = null; // 문자열로 변환하기 위한 패턴 설정(년도-월-일 시:분:초:초(자정이후 초)) String pattern = "yyyyMMddhhmmssSSS"; SimpleDateFormat sdfCurrent = new SimpleDateFormat(pattern, Locale.KOREA); Timestamp ts = new Timestamp(System.currentTimeMillis()); rtnStr = sdfCurrent.format(ts.getTime()); return rtnStr; } /** * html의 특수문자를 표현하기 위해 * * @param srcString * @return String * @exception Exception * @see */ public static String getHtmlStrCnvr(String srcString) { String tmpString = srcString; tmpString = tmpString.replaceAll("<", "<"); tmpString = tmpString.replaceAll(">", ">"); tmpString = tmpString.replaceAll("&", "&"); tmpString = tmpString.replaceAll(" ", " "); tmpString = tmpString.replaceAll("'", "\'"); tmpString = tmpString.replaceAll(""", "\""); return tmpString; } /** * 날짜 형식의 문자열 내부에 마이너스 character(-)를 추가한다. * * <pre> * StringUtil.addMinusChar("20100901") = "2010-09-01" * </pre> * * @param date 입력받는 문자열 * @return " - "가 추가된 입력문자열 */ public static String addMinusChar(String date) { if(date.length() == 8) return date.substring(0,4).concat("-").concat(date.substring(4,6)).concat("-").concat(date.substring(6,8)); else return ""; } }