org.restlet.engine.util

Class StringUtils

java.lang.Object

org.restlet.engine.util.StringUtils

public class StringUtils
extends java.lang.Object

String manipulation utilities.

Author:

Jerome Louvel

Method Summary

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

splitAndTrim

public static java.util.List<java.lang.String> splitAndTrim(java.lang.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 java.util.List<java.lang.String> splitAndTrim(java.lang.String stringToSplit,
                                                            java.lang.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 java.lang.String strip(java.lang.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 java.lang.String strip(java.lang.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.