org.restlet.engine.util

Class StringUtils

java.lang.Object

org.restlet.engine.util.StringUtils

public class StringUtils
extends Object

String manipulation utilities.

Author:

Jerome Louvel

Method Summary

Modifier and Type	Method and Description
static String	firstLower(String string) Returns the string with the first character capitalized.
static String	firstUpper(String string) Returns the string with the first character capitalized.
static byte[]	getAsciiBytes(String string) Encodes the given String into a sequence of bytes using the Ascii character set.
static byte[]	getLatin1Bytes(String string) Encodes the given String into a sequence of bytes using the Latin1 character set.
static String	htmlEscape(String str) Returns the given String according to the HTML 4.0 encoding rules.
static String	htmlUnescape(String str) Returns the given String decoded according to the HTML 4.0 decoding rules.
static boolean	isNullOrEmpty(String string) Returns true if the given string is null or is the empty string.
static String	nullToEmpty(String string) Returns the given string if it is non-null; the empty string otherwise.
static String	repeat(String string, int occurrences) Returns the given string repeated the number of times requested.
static List<String>	splitAndTrim(String stringToSplit) Returns an list of trimmed token splitted with the split character ",".
static List<String>	splitAndTrim(String stringToSplit, String splitCharacter) Returns an list of trimmed token splitted with the split character.
static String	strip(String source, char delimiter) Strips a delimiter character from both ends of the source string.
static String	strip(String source, char delimiter, boolean start, boolean end) Strips a delimiter character from a source string.

Methods inherited from class java.lang.Object

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

Method Detail

firstLower

public static String firstLower(String string)

Returns the string with the first character capitalized.

Parameters:

string - a string reference to check

Returns:

the string with the first character capitalized.

firstUpper

public static String firstUpper(String string)

Returns the string with the first character capitalized.

Parameters:

string - a string reference to check

Returns:

the string with the first character capitalized.

getAsciiBytes

public static byte[] getAsciiBytes(String string)

Encodes the given String into a sequence of bytes using the Ascii character set.

Parameters:

string - The string to encode.

Returns:

The String encoded with the Ascii character set as an array of bytes.

getLatin1Bytes

public static byte[] getLatin1Bytes(String string)

Encodes the given String into a sequence of bytes using the Latin1 character set.

Parameters:

string - The string to encode.

Returns:

The String encoded with the Latin1 character set as an array of bytes.

htmlEscape

public static String htmlEscape(String str)

Returns the given String according to the HTML 4.0 encoding rules.

Parameters:

str - The String to encode.

Returns:

The converted String according to the HTML 4.0 encoding rules.

htmlUnescape

public static String htmlUnescape(String str)

Returns the given String decoded according to the HTML 4.0 decoding rules.

Parameters:

str - The String to decode.

Returns:

The given String decoded according to the HTML 4.0 decoding rules.

isNullOrEmpty

public static boolean isNullOrEmpty(String string)

Returns true if the given string is null or is the empty string. Consider normalizing your string references with nullToEmpty(java.lang.String). If you do, you can use String.isEmpty() instead of this method, and you won't need special null-safe forms of methods like String.toUpperCase(java.util.Locale) either.

Parameters:

string - a string reference to check

Returns:

true if the string is null or is the empty string

nullToEmpty

public static String nullToEmpty(String string)

Returns the given string if it is non-null; the empty string otherwise.

Parameters:

string - the string to test and possibly return

Returns:

string itself if it is non-null; "" if it is null

repeat

public static String repeat(String string,
                            int occurrences)

Returns the given string repeated the number of times requested.

Parameters:

string - String to be repeated.

occurrences - Number of times to repeat the string.

Returns:

splitAndTrim

public static List<String> splitAndTrim(String stringToSplit)

Returns an list of trimmed token splitted with the split character ",".

Parameters:

stringToSplit - The String to split.

Returns:

List of tokens.

splitAndTrim

public static List<String> splitAndTrim(String stringToSplit,
                                        String splitCharacter)

Returns an list of trimmed token splitted with the split character.

Parameters:

stringToSplit - The String to split.

splitCharacter - The split Character.

Returns:

List of tokens.

strip

public static String strip(String source,
                           char delimiter)

Strips a delimiter character from both ends of the source string.

Parameters:

source - The source string to strip.

delimiter - The character to remove.

Returns:

The stripped string.

strip

public static String strip(String source,
                           char delimiter,
                           boolean start,
                           boolean end)

Strips a delimiter character from a source string.

Parameters:

source - The source string to strip.

delimiter - The character to remove.

start - Indicates if start of source should be stripped.

end - Indicates if end of source should be stripped.

Returns:

The stripped source string.