Class Utils
-
Method Summary
Modifier and TypeMethodDescriptionstatic voidcloseQuietly(Closeable closeable) static Stringconcat(CharSequence... strings) static Stringstatic Stringhex(char ch) Returns an upper case hexadecimalStringfor the given character.static booleanisEmpty(CharSequence cs) Checks if a CharSequence is empty ("") or null.static voidValidate that the argument condition istrue; otherwise throwing an exception with the specified message.static Stringstatic Stringstatic <T extends CharSequence>
TValidate that the specified argument character sequence is neithernullnor a length of zero (no characters); otherwise throwing an exception with the specified message.static <T> TValidate that the specified argument is notnull; otherwise throwing an exception with the specified message.static voidonlyOneIsTrue(String message, boolean... expressions) Check if one and only one condition is true; otherwise throw an exception with the specified message.static booleanonlyOneIsTrueNonThrow(boolean... expressions) static Stringstatic String
-
Method Details
-
join
-
join
-
concat
-
closeQuietly
-
escape
-
unescape
-
hex
Returns an upper case hexadecimalStringfor the given character.- Parameters:
ch- The character to map.- Returns:
- An upper case hexadecimal
String
-
isEmpty
Checks if a CharSequence is empty ("") or null.
StringUtils.isEmpty(null) = true StringUtils.isEmpty("") = true StringUtils.isEmpty(" ") = false StringUtils.isEmpty("bob") = false StringUtils.isEmpty(" bob ") = falseNOTE: This method changed in Lang version 2.0. It no longer trims the CharSequence. That functionality is available in isBlank().
- Parameters:
cs- the CharSequence to check, may be null- Returns:
trueif the CharSequence is empty or null- Since:
- 3.0 Changed signature from isEmpty(String) to isEmpty(CharSequence)
-
notNull
Validate that the specified argument is not
null; otherwise throwing an exception with the specified message.Validate.notNull(myObject, "The object must not be null");
- Type Parameters:
T- the object type- Parameters:
object- the object to checkmessage- theString.format(String, Object...)exception message if invalid, not nullvalues- the optional values for the formatted exception message- Returns:
- the validated object (never
nullfor method chaining) - Throws:
NullPointerException- if the object isnull
-
isTrue
Validate that the argument condition is
true; otherwise throwing an exception with the specified message. This method is useful when validating according to an arbitrary boolean expression, such as validating a primitive number or using your own custom validation expression.Validate.isTrue(i > 0.0, "The value must be greater than zero: %d", i);
For performance reasons, the long value is passed as a separate parameter and appended to the exception message only in the case of an error.
- Parameters:
expression- the boolean expression to checkmessage-- Throws:
IllegalArgumentException- if expression isfalse
-
onlyOneIsTrue
Check if one and only one condition is true; otherwise throw an exception with the specified message.- Parameters:
message- error describing messageexpressions- the boolean expressions to check- Throws:
IllegalArgumentException- if zero or more than one expressions are true
-
onlyOneIsTrueNonThrow
public static boolean onlyOneIsTrueNonThrow(boolean... expressions) -
notEmpty
Validate that the specified argument character sequence is neither
nullnor a length of zero (no characters); otherwise throwing an exception with the specified message.Validate.notEmpty(myString, "The string must not be empty");
- Type Parameters:
T- the character sequence type- Parameters:
chars- the character sequence to check, validated not null by this methodmessage- theString.format(String, Object...)exception message if invalid, not nullvalues- the optional values for the formatted exception message, null array not recommended- Returns:
- the validated character sequence (never
nullmethod for chaining) - Throws:
NullPointerException- if the character sequence isnullIllegalArgumentException- if the character sequence is empty
-
toString
-