Class Utils
-
Constructor Summary
Constructors -
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.(package private) static intindexOf(CharSequence cs, CharSequence searchChar, int start) Used by the indexOf(CharSequence methods) as a green implementation of indexOf.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
-
Constructor Details
-
Utils
private Utils()
-
-
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)
-
indexOf
Used by the indexOf(CharSequence methods) as a green implementation of indexOf.- Parameters:
cs- theCharSequenceto be processedsearchChar- theCharSequenceto be searched forstart- the start index- Returns:
- the index where the search sequence was found
-
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
-