Class Utils
-
Constructor Summary
Constructors -
Method Summary
Modifier and TypeMethodDescriptionstatic void
closeQuietly
(Closeable closeable) static String
concat
(CharSequence... strings) static String
static String
hex
(char ch) Returns an upper case hexadecimalString
for the given character.(package private) static int
indexOf
(CharSequence cs, CharSequence searchChar, int start) Used by the indexOf(CharSequence methods) as a green implementation of indexOf.static boolean
isEmpty
(CharSequence cs) Checks if a CharSequence is empty ("") or null.static void
Validate that the argument condition istrue
; otherwise throwing an exception with the specified message.static String
static String
static <T extends CharSequence>
TValidate that the specified argument character sequence is neithernull
nor a length of zero (no characters); otherwise throwing an exception with the specified message.static <T> T
Validate that the specified argument is notnull
; otherwise throwing an exception with the specified message.static void
onlyOneIsTrue
(String message, boolean... expressions) Check if one and only one condition is true; otherwise throw an exception with the specified message.static boolean
onlyOneIsTrueNonThrow
(boolean... expressions) static String
static String
-
Constructor Details
-
Utils
private Utils()
-
-
Method Details
-
join
-
join
-
concat
-
closeQuietly
-
escape
-
unescape
-
hex
Returns an upper case hexadecimalString
for 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 ") = false
NOTE: 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:
true
if 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
- theCharSequence
to be processedsearchChar
- theCharSequence
to 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
null
for 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
null
nor 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
null
method for chaining) - Throws:
NullPointerException
- if the character sequence isnull
IllegalArgumentException
- if the character sequence is empty
-
toString
-