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 .

Author:

Karsten Lentzsch

Field Summary

Fields

Modifier and Type	Field and Description
static String	ELLIPSIS_STRING The correct ellipsis string.
static String	NO_ELLIPSIS_STRING A string with three dots that should is often mean to be the ellipsis string "?" or character '?'.

Constructor Summary

Constructors

Modifier	Constructor and Description
protected	Strings()

Method Summary

Methods

Modifier and Type	Method and Description
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 String	get(String str, Object... args) If no arguments are provided, the plain String is returned.
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

Field Detail

NO_ELLIPSIS_STRING

public static final String NO_ELLIPSIS_STRING

A string with three dots that should is often mean to be the ellipsis string "?" or character '?'.

Since:

1.7

See Also:

ELLIPSIS_STRING, Constant Field Values

ELLIPSIS_STRING

public static final String ELLIPSIS_STRING

The correct ellipsis string.

See Also:

NO_ELLIPSIS_STRING, Constant Field Values

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

get

public static String get(String str,
         Object... args)

If no arguments are provided, the plain String is returned Otherwise the string will be formatted using String.format

Parameters:

args - optional format arguments forwarded to String#format

Returns:

the String formatted with the optional arguments - if any

Since:

1.8

See Also:

String.format(String, Object...)