com.jgoodies.common.base
Class Strings

java.lang.Object
  com.jgoodies.common.base.Strings

public class Strings
extends Object

Provides frequently used static null-safe String testing methods .

Version:

$Revision: 1.5 $

Author:

Karsten Lentzsch

Constructor Summary

protected

Strings()

Method Summary

static String	abbreviateCenter(String str, int maxLength) Abbreviates the given string if it exceeds the given maximum lengt by replacing its center part with an ellipsis ('…').
static boolean	isBlank(String str) Checks if the given string is whitespace, empty ("") or null.
static boolean	isEmpty(String str) Checks if the given string is empty ("") or null.
static boolean	isNotBlank(String str) Checks if the given string is not empty ("") not null and not whitespace only.
static boolean	isNotEmpty(String str) Checks if the given string is not empty ("" and not null.
static boolean	isTrimmed(String str) Checks if the given string is null, empty ("") or the first and last characters are not whitespace.
static boolean	startsWithIgnoreCase(String str, String prefix) Checks if str starts with the given prefix ignoring cases.

Methods inherited from class java.lang.Object

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

Constructor Detail

Strings

protected Strings()

Method Detail

isBlank

public static boolean isBlank(String str)

Checks if the given string is whitespace, empty ("") or null

Parameters:
str - the string to check, may be null
Returns:
true if the string is whitespace, empt
    or null
See Also:
isEmpty(String)

isNotBlank

public static boolean isNotBlank(String str)

Checks if the given string is not empty ("") not null and not whitespace only

Parameters:
str - the string to check, may be null
Returns:
true if the string is not empt
    and not null and not whitespace only
See Also:
isEmpty(String)

isEmpty

public static boolean isEmpty(String str)

Checks if the given string is empty ("") or null

Parameters:
str - the string to check, may be null
Returns:
true if the string is empty or null
See Also:
isBlank(String)

isNotEmpty

public static boolean isNotEmpty(String str)

Checks if the given string is not empty ("" and not null

Parameters:
str - the string to check, may be null
Returns:
true if the string is not empty and not null
See Also:
isBlank(String)

isTrimmed

public static boolean isTrimmed(String str)

Checks if the given string is null, empty ("") or the first and last characters are not whitespace

Parameters:
str - the string to check, may be null
Returns:
true if the string is null, empty
    or the first and last characters are not whitespace.
Since:
  
1.3

startsWithIgnoreCase

public static boolean startsWithIgnoreCase(String str,
                                           String prefix)

Checks if str starts with the given prefix ignoring cases null is handled safely; if both arguments are null, tru is returned, false otherwise

Parameters:
str - the test string to check, may be null
prefix - the prefix to check for, may be null
Returns:
true, if the string starts with the prefix, ignoring cases
     false otherwise
See Also:
String.startsWith(java.lang.String)

abbreviateCenter

public static String abbreviateCenter(String str,
                                      int maxLength)

Abbreviates the given string if it exceeds the given maximum lengt by replacing its center part with an ellipsis ('…') If the string is null or shorter than the limit it is returned as is.

Parameters:

str - the source string

maxLength - the maximum length of the result string

Returns:

str if its length is less than or equal to maxLength an abbreviated string with length maxLength wher the center is replaced by an ellipsis