001: /*
002: * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS HEADER.
003: *
004: * Copyright 1997-2007 Sun Microsystems, Inc. All rights reserved.
005: *
006: * The contents of this file are subject to the terms of either the GNU
007: * General Public License Version 2 only ("GPL") or the Common
008: * Development and Distribution License("CDDL") (collectively, the
009: * "License"). You may not use this file except in compliance with the
010: * License. You can obtain a copy of the License at
011: * http://www.netbeans.org/cddl-gplv2.html
012: * or nbbuild/licenses/CDDL-GPL-2-CP. See the License for the
013: * specific language governing permissions and limitations under the
014: * License. When distributing the software, include this License Header
015: * Notice in each file and include the License file at
016: * nbbuild/licenses/CDDL-GPL-2-CP. Sun designates this
017: * particular file as subject to the "Classpath" exception as provided
018: * by Sun in the GPL Version 2 section of the License file that
019: * accompanied this code. If applicable, add the following below the
020: * License Header, with the fields enclosed by brackets [] replaced by
021: * your own identifying information:
022: * "Portions Copyrighted [year] [name of copyright owner]"
023: *
024: * Contributor(s):
025: *
026: * The Original Software is NetBeans. The Initial Developer of the Original
027: * Software is Sun Microsystems, Inc. Portions Copyright 1997-2006 Sun
028: * Microsystems, Inc. All Rights Reserved.
029: *
030: * If you wish your version of this file to be governed by only the CDDL
031: * or only the GPL Version 2, indicate your decision by adding
032: * "[Contributor] elects to include this software in this distribution
033: * under the [CDDL or GPL Version 2] license." If you do not indicate a
034: * single choice of license, a recipient has the option to distribute
035: * your version of this file under either the CDDL, the GPL Version 2 or
036: * to extend the choice of license to its licensees as provided above.
037: * However, if you add GPL Version 2 code and therefore, elected the GPL
038: * Version 2 license, then the option applies only if the new code is
039: * made subject to such option by the copyright holder.
040: */
041:
042: package org.netbeans.modules.spring.beans.utils;
043:
044: import java.util.ArrayList;
045: import java.util.Collections;
046: import java.util.List;
047: import java.util.StringTokenizer;
048:
049: /**
050: * XXX: Need to use the StringUtils from spring.jar instead of
051: * duplication
052: *
053: * @author Rohan Ranade (Rohan.Ranade@Sun.COM)
054: */
055: public final class StringUtils {
056:
057: private StringUtils() {
058: }
059:
060: public static boolean hasText(String str) {
061: if (!hasLength(str)) {
062: return false;
063: }
064:
065: int strLen = str.length();
066: for (int i = 0; i < strLen; i++) {
067: if (!Character.isWhitespace(str.charAt(i))) {
068: return true;
069: }
070: }
071: return false;
072: }
073:
074: public static boolean hasLength(String str) {
075: return (str != null && str.length() > 0);
076: }
077:
078: /**
079: * Tokenize the given String into a String array via a StringTokenizer.
080: * Trims tokens and omits empty tokens.
081: * <p>The given delimiters string is supposed to consist of any number of
082: * delimiter characters. Each of those characters can be used to separate
083: * tokens. A delimiter is always a single character; for multi-character
084: * delimiters, consider using <code>delimitedListToStringArray</code>
085: * @param str the String to tokenize
086: * @param delimiters the delimiter characters, assembled as String
087: * (each of those characters is individually considered as delimiter).
088: * @return an array of the tokens
089: * @see java.util.StringTokenizer
090: * @see java.lang.String#trim()
091: * @see #delimitedListToStringArray
092: */
093: public static List<String> tokenize(String str, String delimiters) {
094: return tokenize(str, delimiters, true, true);
095: }
096:
097: /**
098: * Tokenize the given String into a String array via a StringTokenizer.
099: * <p>The given delimiters string is supposed to consist of any number of
100: * delimiter characters. Each of those characters can be used to separate
101: * tokens. A delimiter is always a single character; for multi-character
102: * delimiters, consider using <code>delimitedListToStringArray</code>
103: * @param str the String to tokenize
104: * @param delimiters the delimiter characters, assembled as String
105: * (each of those characters is individually considered as delimiter)
106: * @param trimTokens trim the tokens via String's <code>trim</code>
107: * @param ignoreEmptyTokens omit empty tokens from the result array
108: * (only applies to tokens that are empty after trimming; StringTokenizer
109: * will not consider subsequent delimiters as token in the first place).
110: * @return an array of the tokens (<code>null</code> if the input String
111: * was <code>null</code>)
112: * @see java.util.StringTokenizer
113: * @see java.lang.String#trim()
114: * @see #delimitedListToStringArray
115: */
116: private static List<String> tokenize(String str, String delimiters,
117: boolean trimTokens, boolean ignoreEmptyTokens) {
118: if (str == null) {
119: return Collections.emptyList();
120: }
121: StringTokenizer st = new StringTokenizer(str, delimiters);
122: List<String> tokens = new ArrayList<String>();
123: while (st.hasMoreTokens()) {
124: String token = st.nextToken();
125: if (trimTokens) {
126: token = token.trim();
127: }
128: if (!ignoreEmptyTokens || token.length() > 0) {
129: tokens.add(token);
130: }
131: }
132: return tokens;
133: }
134:
135: /**
136: * Joins a list of strings.
137: *
138: * @param strings the list of strings; can be empty, but not null.
139: * @param separator a separator; can be null.
140: * @return a string containing the joined strings; never null.
141: */
142: public static String join(List<String> strings, String separator) {
143: int size = strings.size();
144: if (size == 0) {
145: return ""; // NOI18N
146: }
147: StringBuilder sb = new StringBuilder(strings.size()
148: * strings.get(0).length());
149: int index = 0;
150: int lastIndex = size - 1;
151: for (String string : strings) {
152: sb.append(string);
153: if (separator != null && index < lastIndex) {
154: sb.append(separator);
155: }
156: index++;
157: }
158: return sb.toString();
159: }
160: }
|