public class ArgumentUtils
extends java.lang.Object
Modifier and Type | Field and Description |
---|---|
static NormalizedString[] |
EMPTY_NORMALIZED_STRING_ARRAY |
static java.lang.String[] |
EMPTY_STRING_ARRAY
An empty String array.
|
Constructor and Description |
---|
ArgumentUtils() |
Modifier and Type | Method and Description |
---|---|
static java.lang.String |
displayLineSeparators(java.lang.String str,
boolean addNewLine)
Displays line separators in a string by replacing all instances
of `\r` and `\n` with `[cr]` and `[lf]`.
|
static <T> T[] |
findDuplicates(T[] array)
Identifies duplicate values in a given array and returns them
|
static java.lang.Object[] |
findMissingElements(java.lang.Object[] array,
java.util.Collection<?> elements)
Searches for elements in a given array and returns the elements not found.
|
static java.lang.Object[] |
findMissingElements(java.lang.Object[] array,
java.lang.Object[] elements)
Searches for elements in a given array and returns the elements not found.
|
static int[] |
indexesOf(java.lang.Object[] array,
java.lang.Object element)
Returns the indexes of an element in a given array.
|
static int |
indexOf(char[] array,
char element,
int from)
Returns the index of a character in a given array.
|
static int |
indexOf(NormalizedString[] array,
NormalizedString element,
FieldSelector fieldSelector)
Returns the index of a header, when headers are selected using a
FieldSelector . |
static int |
indexOf(java.lang.Object[] array,
java.lang.Object element)
Returns the index of an element in a given array.
|
private static int |
indexOf(java.lang.Object[] array,
java.lang.Object element,
int from)
Returns the index of an element in a given array.
|
static java.io.Reader |
newReader(java.io.File file)
Creates a
Reader for a given a file |
static java.io.Reader |
newReader(java.io.File file,
java.nio.charset.Charset encoding)
Creates a
Reader for a given a file |
static java.io.Reader |
newReader(java.io.File file,
java.lang.String encoding)
Creates a
Reader for a given a file |
static java.io.Reader |
newReader(java.io.InputStream input)
Creates a
Reader from an input stream |
static java.io.Reader |
newReader(java.io.InputStream input,
java.nio.charset.Charset encoding)
Creates a
Reader from an input stream |
static java.io.Reader |
newReader(java.io.InputStream input,
java.lang.String encoding)
Creates a
Reader from an input stream |
static java.io.Writer |
newWriter(java.io.File file)
Creates a
Writer from a file |
static java.io.Writer |
newWriter(java.io.File file,
java.nio.charset.Charset encoding)
Creates a
Writer from a file |
static java.io.Writer |
newWriter(java.io.File file,
java.lang.String encoding)
Creates a
Writer from a file |
static java.io.Writer |
newWriter(java.io.OutputStream output)
Creates a
Writer from an output stream |
static java.io.Writer |
newWriter(java.io.OutputStream output,
java.nio.charset.Charset encoding)
Creates a
Writer from an output stream |
static java.io.Writer |
newWriter(java.io.OutputStream output,
java.lang.String encoding)
Creates a
Writer from an output stream |
static <T> void |
noNulls(java.lang.String argDescription,
T... args)
Throws an IllegalArgumentException if the given array is null,empty, or contains null values
|
static <T> void |
notEmpty(java.lang.String argDescription,
T... args)
Throws an IllegalArgumentException if the given array is null or empty.
|
static int[] |
removeAll(int[] array,
int e)
Removes all instances of a given element from an int array.
|
static java.lang.String |
restrictContent(int length,
java.lang.CharSequence content)
Restricts the length of a given content.
|
static java.lang.String |
restrictContent(int length,
java.lang.Object content)
Restricts the length of a given content.
|
private static <T extends java.lang.Exception> |
throwsUnchecked(java.lang.Throwable toThrow) |
static void |
throwUnchecked(java.lang.Throwable error)
Allows rethrowing a checked exception instead of wrapping it into a runtime exception.
|
static java.lang.String[] |
toArray(java.util.List<java.lang.Enum> enums)
Converts a list of enumerations to an array of their
Enum.toString() representation |
static byte[] |
toByteArray(int... ints)
Converts a sequence of int numbers into a byte array.
|
static char[] |
toCharArray(java.util.Collection<java.lang.Character> characters)
Converts any collection of
Character into a char array. |
static int[] |
toIntArray(java.util.Collection<java.lang.Integer> ints)
Converts any collection of
Integer into an int array. |
static java.lang.String |
trim(java.lang.String input,
boolean left,
boolean right)
Removes surrounding spaces from a given
String , from its right or left side, or both. |
public static final java.lang.String[] EMPTY_STRING_ARRAY
public static final NormalizedString[] EMPTY_NORMALIZED_STRING_ARRAY
public static <T> void notEmpty(java.lang.String argDescription, T... args)
T
- Type of arguments to be validatedargDescription
- the description of the elementsargs
- the elements to be validated.public static <T> void noNulls(java.lang.String argDescription, T... args)
T
- Type of arguments to be validatedargDescription
- the description of the elementsargs
- the elements to be validated.public static int indexOf(NormalizedString[] array, NormalizedString element, FieldSelector fieldSelector)
FieldSelector
.array
- the element arrayelement
- the element to be looked for in the array.fieldSelector
- a field selector that indicates which elements of the given array are selected.public static int[] indexesOf(java.lang.Object[] array, java.lang.Object element)
array
- the element arrayelement
- the element to be looked for in the array.public static int indexOf(java.lang.Object[] array, java.lang.Object element)
array
- the element arrayelement
- the element to be looked for in the array.public static int indexOf(char[] array, char element, int from)
array
- the character arrayelement
- the character to be looked for in the array.from
- the starting position of the array from where to start the searchprivate static int indexOf(java.lang.Object[] array, java.lang.Object element, int from)
array
- the element arrayelement
- the element to be looked for in the array.from
- the starting position of the array from where to start the searchpublic static java.lang.Object[] findMissingElements(java.lang.Object[] array, java.util.Collection<?> elements)
array
- An array with elementselements
- the elements to be foundpublic static java.lang.Object[] findMissingElements(java.lang.Object[] array, java.lang.Object[] elements)
array
- An array with elementselements
- the elements to be foundpublic static java.io.Writer newWriter(java.io.OutputStream output)
Writer
from an output streamoutput
- the output streamWriter
wrapping the given output streampublic static java.io.Writer newWriter(java.io.OutputStream output, java.lang.String encoding)
Writer
from an output streamoutput
- the output streamencoding
- the encoding to use when writing to the output streamWriter
wrapping the given output streampublic static java.io.Writer newWriter(java.io.OutputStream output, java.nio.charset.Charset encoding)
Writer
from an output streamoutput
- the output streamencoding
- the encoding to use when writing to the output streamWriter
wrapping the given output streampublic static java.io.Writer newWriter(java.io.File file)
Writer
from a filefile
- the file to be writtenWriter
for the given filepublic static java.io.Writer newWriter(java.io.File file, java.lang.String encoding)
Writer
from a filefile
- the file to be writtenencoding
- the encoding to use when writing to the fileWriter
for the given filepublic static java.io.Writer newWriter(java.io.File file, java.nio.charset.Charset encoding)
Writer
from a filefile
- the file to be writtenencoding
- the encoding to use when writing to the fileWriter
for the given filepublic static java.io.Reader newReader(java.io.InputStream input)
Reader
from an input streaminput
- the input streamReader
wrapping the given input streampublic static java.io.Reader newReader(java.io.InputStream input, java.lang.String encoding)
Reader
from an input streaminput
- the input streamencoding
- the encoding to use when reading from the input streamReader
wrapping the given input streampublic static java.io.Reader newReader(java.io.InputStream input, java.nio.charset.Charset encoding)
Reader
from an input streaminput
- the input streamencoding
- the encoding to use when reading from the input streamReader
wrapping the given input streampublic static java.io.Reader newReader(java.io.File file)
Reader
for a given a filefile
- the file to be readReader
for reading the given filepublic static java.io.Reader newReader(java.io.File file, java.lang.String encoding)
Reader
for a given a filefile
- the file to be readencoding
- the encoding to be used when reading from the fileReader
for reading the given filepublic static java.io.Reader newReader(java.io.File file, java.nio.charset.Charset encoding)
Reader
for a given a filefile
- the file to be readencoding
- the encoding to be used when reading from the fileReader
for reading the given filepublic static java.lang.String[] toArray(java.util.List<java.lang.Enum> enums)
Enum.toString()
representationenums
- a list of enumerations to convertString
with the values produced by each element's Enum.toString()
method.public static int[] toIntArray(java.util.Collection<java.lang.Integer> ints)
Integer
into an int
array.ints
- a collection of (boxed) integers.int
array with the unboxed integer values.public static char[] toCharArray(java.util.Collection<java.lang.Character> characters)
Character
into a char array.characters
- a collection of (boxed) characters.char
array with the unboxed character values.public static java.lang.String restrictContent(int length, java.lang.CharSequence content)
length
- the maximum length to be displayed. If 0
, the "<omitted>"
string will be returned.content
- the content whose length should be restricted.public static java.lang.String restrictContent(int length, java.lang.Object content)
length
- the maximum length to be displayed. If 0
, the "<omitted>"
string will be returned.content
- the content whose length should be restricted.public static void throwUnchecked(java.lang.Throwable error)
error
- the (potentially checked) exception to the thrown.private static <T extends java.lang.Exception> void throwsUnchecked(java.lang.Throwable toThrow) throws T extends java.lang.Exception
T extends java.lang.Exception
public static byte[] toByteArray(int... ints)
ints
- the integers to be cast to bypublic static <T> T[] findDuplicates(T[] array)
T
- the type of elements held in the given array.array
- the search arraynull
if the input is null
.public static java.lang.String trim(java.lang.String input, boolean left, boolean right)
String
, from its right or left side, or both.input
- the content to trimleft
- flag to indicate whether spaces on the left side of the string should be removed.right
- flag to indicate whether spaces on the right side of the string should be removed.public static java.lang.String displayLineSeparators(java.lang.String str, boolean addNewLine)
str
- the string to have its line separators displayedaddNewLine
- flag indicating whether the original `\r` or `\n` characters should be kept in the string.
if true
, `\r` will be replaced by `[cr]\r` for example.public static int[] removeAll(int[] array, int e)
array
- the array to be checkede
- the element to be removed