scriptella.util

Class StringUtils

java.lang.Object

scriptella.util.StringUtils

public final class StringUtils
extends java.lang.Object

Miscellaneous String/CharSequence utility methods.

Version:

1.0

Author:

Fyodor Kupolov

Method Summary

Modifier and Type	Method and Description
static java.lang.String	consoleFormat(java.lang.String string) Formats specified string for console suitable representation.
static java.lang.String	consoleFormat(java.lang.String string, int maxLength) Formats specified string for console suitable representation.
static java.lang.String	getMaskedPassword(java.lang.String string) Masks password displaying to user.
static boolean	isAsciiWhitespacesOnly(java.lang.CharSequence cs) Checks if specified characters sequence is empty or contains only ascii whitespace characters.
static boolean	isDecimalInt(java.lang.CharSequence cs) Checks if specified characters sequence represents a non negative decimal number.
static boolean	isEmpty(java.lang.CharSequence cs) Returns true if characters sequence is empty (length=0) or null.
static java.lang.String	nullsafeToString(java.lang.Object o) Returns Null safe string representation of specified object.
static java.lang.String	nullsafeTrim(java.lang.CharSequence cs) Returns a trimmed value for specified charsequence
static java.lang.String	pad(java.lang.String str, boolean left, int width, char padChar) Pads a String with a specified character.
static java.lang.String	removePrefix(java.lang.String string, java.lang.String prefix) Removes a prefix from a string.

Methods inherited from class java.lang.Object

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

Method Detail

isEmpty

public static boolean isEmpty(java.lang.CharSequence cs)

Returns true if characters sequence is empty (length=0) or null.

Parameters:

cs - characters sequence to test.

Returns:

true if characters sequence is empty (length=0) or null.

nullsafeTrim

public static java.lang.String nullsafeTrim(java.lang.CharSequence cs)

Returns a trimmed value for specified charsequence

Parameters:

cs - charsequence to trim.

Returns:

trimmed value for specified charsequence or empty string if cs=null

nullsafeToString

public static java.lang.String nullsafeToString(java.lang.Object o)

Returns Null safe string representation of specified object.

Parameters:

o - object to convert to String.

Returns:

o.toString() or "" if o==null.

isAsciiWhitespacesOnly

public static boolean isAsciiWhitespacesOnly(java.lang.CharSequence cs)

Checks if specified characters sequence is empty or contains only ascii whitespace characters.

Parameters:

cs - characters sequence to check.

Returns:

true if characters sequence is empty or contains only ascii whitespace characters.

isDecimalInt

public static boolean isDecimalInt(java.lang.CharSequence cs)

Checks if specified characters sequence represents a non negative decimal number.

Parameters:

cs - characters sequence to check.

Returns:

true if specified characters sequence represents a non negative decimal number.

consoleFormat

public static java.lang.String consoleFormat(java.lang.String string)

Formats specified string for console suitable representation.

All EOL char sequences are replaced with a single system line.separator, and all other whitespace sequences are replaced with a single space.

String larger than 10KB are trimmed.

Parameters:

string - string to format. Nulls are allowed.

Returns:

formatted string.

consoleFormat

public static java.lang.String consoleFormat(java.lang.String string,
                                             int maxLength)

Formats specified string for console suitable representation.

All EOL char sequences are replaced with a single system line.separator, and all other whitespace sequences are replaced with a single space.

Parameters:

string - string to format. Nulls are allowed.

maxLength - maximum number of characters to show or negative if the string cannot be trimmed.

Returns:

formatted string.

removePrefix

public static java.lang.String removePrefix(java.lang.String string,
                                            java.lang.String prefix)

Removes a prefix from a string.

Parameters:

string - original string. May be null.

prefix - prefix to to check and remove. May be null.

Returns:

string without a prefix, or unchanged string.

getMaskedPassword

public static java.lang.String getMaskedPassword(java.lang.String string)

Masks password displaying to user.

Parameters:

string - password.

Returns:

masked password or empty string for empty/null password.

pad

public static java.lang.String pad(java.lang.String str,
                                   boolean left,
                                   int width,
                                   char padChar)

Pads a String with a specified character.

Parameters:

str - string to pad. Null is treated as empty string.

left - true if left pad, false if right

width - with of the padded string

padChar - character to use for padding

Returns:

padded string.