com.massa.util

Class StringUtils

java.lang.Object

com.massa.util.StringUtils

public final class StringUtils
extends Object

Utility class for String manipulation

Method Summary

Modifier and Type	Method and Description
static String	concat(Iterable<?> inputs, String prefix, String separator, String suffix) Splits the provided String into a List.
static String	emptyIfNull(Object aString) Checks if aString is null and if so, returns Empty String.
static String	escapeXml(String str) Escapes special characters in a String.
static String	getMD5(String input) Computes MD5 checksum for the provided String.
static boolean	isEmpty(String aString) This method checks if the parameter is null or only contains blank characters.
static boolean	isIn(char cc, char[] ends) Is "cc" character present in "ends" array ?
static int	lastIndexOf(String s, char c, int minIndex) Searches the last index of a character in a String, searching backwards from last char until min index.
static String	ltrim(String aString)
static String	nullIfEmpty(String aString) This method return null if the parameter aString is null or only contains blank characters otherwise aString is returned
static String	rtrim(String aString)
static List<String>	stringToListBySeparator(String input, String separator) Splits the provided String into a List.
static Set<String>	stringToSetBySeparator(String input, String separator) Splits the provided String into an ordered Set.
static String	trim(String aString) This method checks if the parameter is null and if not suppresses blank characters at left and right sides.
static String	unescapeJava(String str) Unescapes any Java literals found in the String.
static void	unescapeJava(Writer out, String str) Unescapes any Java literals found in the String to a Writer.

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Method Detail

lastIndexOf

public static int lastIndexOf(String s,
                              char c,
                              int minIndex)

Searches the last index of a character in a String, searching backwards from last char until min index.
This method differs from String.lastIndexOf(int, int) as it searches the right part of the offset instead of the left part.

Returns:

-1 if c is not found.

trim

public static String trim(String aString)

This method checks if the parameter is null and if not suppresses blank characters at left and right sides.

Parameters:

aString - String to trim

Returns:

trimmed string.

ltrim

public static String ltrim(String aString)

rtrim

public static String rtrim(String aString)

isEmpty

public static boolean isEmpty(String aString)

This method checks if the parameter is null or only contains blank characters.

Parameters:

aString - String to test

Returns:

true if the parameter aString is null or only contains blank characters.

nullIfEmpty

public static String nullIfEmpty(String aString)

This method return null if the parameter aString is null or only contains blank characters otherwise aString is returned

Parameters:

aString - String to test

Returns:

aString if aString is not null or not blank

emptyIfNull

public static String emptyIfNull(Object aString)

Checks if aString is null and if so, returns Empty String. Returns aString otherwise.

Parameters:

aString - String to check

Returns:

Empty String if aString is null, aString otherwise

stringToSetBySeparator

public static Set<String> stringToSetBySeparator(String input,
                                                 String separator)

Splits the provided String into an ordered Set.

stringToListBySeparator

public static List<String> stringToListBySeparator(String input,
                                                   String separator)

Splits the provided String into a List.

concat

public static String concat(Iterable<?> inputs,
                            String prefix,
                            String separator,
                            String suffix)

Splits the provided String into a List.

getMD5

public static String getMD5(String input)

Computes MD5 checksum for the provided String.

Parameters:

input - String to compute checksum onto

Returns:

MD5 checksum

Throws:

NullPointerException - if input is null

escapeXml

public static String escapeXml(String str)

Escapes special characters in a String.

Parameters:

str - The String to escape.

Returns:

A escaped String.

unescapeJava

public static String unescapeJava(String str)

Unescapes any Java literals found in the String. For example, it will turn a sequence of '\' and 'n' into a newline character, unless the '\' is preceded by another '\'.

Parameters:

str - the String to unescape, may be null

Returns:

a new unescaped String, null if null string input

unescapeJava

public static void unescapeJava(Writer out,
                                String str)
                         throws IOException

Unescapes any Java literals found in the String to a Writer.

For example, it will turn a sequence of '\' and 'n' into a newline character, unless the '\' is preceded by another '\'.

Illegal escapes result in an exception. For example, "\d" will fail.

A null string input has no effect.

Parameters:

out - the Writer used to output unescaped characters

str - the String to unescape, may be null

Throws:

IllegalArgumentException - if the Writer is null

IOException - if error occurs on underlying Writer

isIn

public static boolean isIn(char cc,
                           char[] ends)

Is "cc" character present in "ends" array ?