|
||||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | |||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |
java.lang.Objectabk.core.util.ArrayUtils
public final class ArrayUtils
Métodos de utilidad para listas, colecciones, arrays, etc. Los métodos son los siguientes, aplicados a objetos y colecciones de objetos, así como a vectores de tipos nativos:
true
si el argumento es nulo o est´
vacío.null
.null
.
Nested Class Summary | |
---|---|
static interface |
ArrayUtils.IterableItemRun<T>
Interfaz a implementar para invocar a forEach(Iterable, IterableItemRun). |
static interface |
ArrayUtils.IterableItemTest<T>
Interfaz a implimentar para every(Iterable, IterableItemTest) y some(Iterable, IterableItemTest). |
Field Summary | |
---|---|
static boolean[] |
EMPTY_BOOLEAN_ARRAY
Un vector de booleanos vacío. |
static Boolean[] |
EMPTY_BOOLEAN_OBJECT_ARRAY
Un vector de objetos Boolean vacío. |
static byte[] |
EMPTY_BYTE_ARRAY
Un vector de bytes vacío. |
static Byte[] |
EMPTY_BYTE_OBJECT_ARRAY
Un vector de objetos Byte vacío. |
static char[] |
EMPTY_CHAR_ARRAY
Un vector de caracteres vacío. |
static Character[] |
EMPTY_CHARACTER_OBJECT_ARRAY
Un vector de objetos Character vacío. |
static Class<?>[] |
EMPTY_CLASS_ARRAY
Un vector de Class vacío. |
static Comparable<?>[] |
EMPTY_COMPARABLE_ARRAY
Un vector de Comparable vacío. |
static double[] |
EMPTY_DOUBLE_ARRAY
Un vector de doubles vacío. |
static Double[] |
EMPTY_DOUBLE_OBJECT_ARRAY
Un vector de objetos Double vacío. |
static float[] |
EMPTY_FLOAT_ARRAY
Un vector de floats vacío. |
static Float[] |
EMPTY_FLOAT_OBJECT_ARRAY
Un vector de objetos Float vacío. |
static int[] |
EMPTY_INT_ARRAY
Un vector de enteros vacío. |
static Integer[] |
EMPTY_INTEGER_OBJECT_ARRAY
Un vector de objetos Integer vacío. |
static long[] |
EMPTY_LONG_ARRAY
Un vector de largos vacío. |
static Long[] |
EMPTY_LONG_OBJECT_ARRAY
Un vector de objetos Long vacío. |
static Object[] |
EMPTY_OBJECT_ARRAY
Un vector de Object vacío. |
static Serializable[] |
EMPTY_SERIALIZABLE_ARRAY
Un vector de Serializable vacío. |
static short[] |
EMPTY_SHORT_ARRAY
Un vector de cortos vacío. |
static Short[] |
EMPTY_SHORT_OBJECT_ARRAY
Un vector de objetos Short vacío. |
static String[] |
EMPTY_STRING_ARRAY
Un vector de String vacío. |
Constructor Summary | |
---|---|
private |
ArrayUtils()
Impide la creación de instancias de ArrayUtils. |
Method Summary | ||
---|---|---|
static
|
asArray(T... all)
Devuelve una lista variable de argumentos como un array protegiéndonos del caso en que se pase null . |
|
static boolean[] |
asBooleanArray(boolean... all)
Devuelve una lista variable de booleanos como un array protegiéndonos del caso en que se pase null . |
|
static byte[] |
asByteArray(byte... all)
Devuelve una lista variable de números como un array protegiéndonos del caso en que se pase null . |
|
static char[] |
asCharArray(char... all)
Devuelve una lista variable de caracteres como un array protegiéndonos del caso en que se pase null . |
|
static double[] |
asDoubleArray(double... all)
Devuelve una lista variable de números como un array protegiéndonos del caso en que se pase null . |
|
static float[] |
asFloatArray(float... all)
Devuelve una lista variable de números como un array protegiéndonos del caso en que se pase null . |
|
static int[] |
asIntArray(int... all)
Devuelve una lista variable de números como un array protegiéndonos del caso en que se pase null . |
|
static
|
asList(T... all)
Invoca a Arrays.asList(Object) pero devolviendo null cuando all es
nulo, en vez de lanzar una NullPointerException. |
|
static long[] |
asLongArray(long... all)
Devuelve una lista variable de números como un array protegiéndonos del caso en que se pase null . |
|
static short[] |
asShortArray(short... all)
Devuelve una lista variable de números como un array protegiéndonos del caso en que se pase null . |
|
static
|
castList(List<?> list)
Realiza un cast inseguro de una lista para devolver el tipo genérico. |
|
static
|
castList(List<?> all,
Class<T> clazz)
Realiza un cast seguro de una lista genérica a una lista de objetos, revisando que el casting de los elementos se realiza correctamente. |
|
static
|
castList(Object object)
Realiza un cast inseguro de una lista para devolver el tipo genérico. |
|
static
|
every(Iterable<T> all,
ArrayUtils.IterableItemTest<T> test)
Verifica que todos los elementos de una iteración satisfacen una condición definida por una función de test. |
|
static
|
every(T[] all,
ArrayUtils.IterableItemTest<T> test)
Verifica que todos los elementos de un vector satisfacen una condición definida por una función de test. |
|
static
|
forEach(Iterable<T> all,
ArrayUtils.IterableItemRun<T> runnable)
Ejecuta una acción sobre todos los elementos de una iteración. |
|
static
|
forEach(T[] all,
ArrayUtils.IterableItemRun<T> runnable)
Ejecuta una acción sobre todos los elementos de un vector. |
|
static boolean |
isEmpty(boolean[] all)
Devuelve true si el vector es nulo o está vacío. |
|
static boolean |
isEmpty(byte[] all)
Devuelve true si el vector es nulo o está vacío. |
|
static boolean |
isEmpty(char[] s)
Comprueba si una cadena de caracteres es nula o vacía. |
|
static boolean |
isEmpty(Collection<?> all)
Devuelve true si la colección es nula o está vacía. |
|
static boolean |
isEmpty(double[] all)
Devuelve true si el vector es nulo o está vacío. |
|
static boolean |
isEmpty(float[] all)
Devuelve true si el vector es nulo o está vacío. |
|
static boolean |
isEmpty(int[] all)
Devuelve true si el vector es nulo o está vacío. |
|
static boolean |
isEmpty(long[] all)
Devuelve true si el vector es nulo o está vacío. |
|
static boolean |
isEmpty(Map<?,?> mapa)
Devuelve true si el mapa que se le pasa es nulo o está vacío. |
|
static boolean |
isEmpty(Object obj)
Devuelve true si el objeto es nulo o si, siendo algún tipo de dato iterable,
está vacío. |
|
static boolean |
isEmpty(short[] all)
Devuelve true si el vector es nulo o está vacío. |
|
static
|
isEmpty(T... all)
Devuelve true si el vector es nulo o está vacío. |
|
private static boolean |
isEmptyArray(Object obj)
Es invocado por isEmpty(Object) en el caso de que obj sea un Array. |
|
static void |
reverse(boolean... array)
Invierte el orden de los elementos de un arreglo, siempre que no sea nulo o vacío. |
|
static void |
reverse(byte... array)
Invierte el orden de los elementos de un arreglo, siempre que no sea nulo o vacío. |
|
static void |
reverse(char... array)
Invierte el orden de los elementos de un arreglo, siempre que no sea nulo o vacío. |
|
static void |
reverse(double... array)
Invierte el orden de los elementos de un arreglo, siempre que no sea nulo o vacío. |
|
static void |
reverse(float... array)
Invierte el orden de los elementos de un arreglo, siempre que no sea nulo o vacío. |
|
static void |
reverse(int... array)
Invierte el orden de los elementos de un arreglo, siempre que no sea nulo o vacío. |
|
static void |
reverse(long... array)
Invierte el orden de los elementos de un arreglo, siempre que no sea nulo o vacío. |
|
static void |
reverse(short... array)
Invierte el orden de los elementos de un arreglo, siempre que no sea nulo o vacío. |
|
static
|
reverse(T... array)
Invierte el orden de los elementos de un arreglo, siempre que no sea nulo o vacío. |
|
static int |
size(boolean[] all)
Devuelve el número de elementos de un vector, o cero si el vector es null . |
|
static int |
size(byte[] all)
Devuelve el número de elementos de un vector, o cero si el vector es null . |
|
static int |
size(char[] all)
Devuelve el número de elementos de un vector, o cero si el vector es null . |
|
static int |
size(Collection<?> all)
Devuelve el número de elementos de una colección, o cero si la colección es null . |
|
static int |
size(double[] all)
Devuelve el número de elementos de un vector, o cero si el vector es null . |
|
static int |
size(float[] all)
Devuelve el número de elementos de un vector, o cero si el vector es null . |
|
static int |
size(int[] all)
Devuelve el número de elementos de un vector, o cero si el vector es null . |
|
static int |
size(long[] all)
Devuelve el número de elementos de un vector, o cero si el vector es null . |
|
static int |
size(short[] all)
Devuelve el número de elementos de un vector, o cero si el vector es null . |
|
static
|
size(T... all)
Devuelve el número de elementos de un vector, o cero si el vector es null . |
|
static
|
some(Iterable<T> all,
ArrayUtils.IterableItemTest<T> test)
Verifica que algún elemento de una iteración satisface una condición definida por una función de test. |
|
static
|
some(T[] all,
ArrayUtils.IterableItemTest<T> test)
Verifica que algún elemento de un vector satisface una condición definida por una función de test. |
|
static
|
sort(Collection<T> all)
Ordena de menor a mayor una colección de objetos usando su comparador natural. |
|
static
|
sort(Comparator<? super T> c,
Collection<T> all)
Ordena de menor a mayor una colección de objetos usando el comparador indicado. |
|
static
|
sort(Comparator<? super T> c,
T... all)
Ordena de menor a mayor un arreglo de objetos usando el comparador indicado. |
|
static
|
sort(T... all)
Ordena de menor a mayor un arreglo de objetos usando su comparador natural. |
Methods inherited from class java.lang.Object |
---|
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait |
Field Detail |
---|
public static final Object[] EMPTY_OBJECT_ARRAY
public static final String[] EMPTY_STRING_ARRAY
public static final Class<?>[] EMPTY_CLASS_ARRAY
public static final Serializable[] EMPTY_SERIALIZABLE_ARRAY
public static final Comparable<?>[] EMPTY_COMPARABLE_ARRAY
public static final char[] EMPTY_CHAR_ARRAY
public static final Character[] EMPTY_CHARACTER_OBJECT_ARRAY
public static final int[] EMPTY_INT_ARRAY
public static final Integer[] EMPTY_INTEGER_OBJECT_ARRAY
public static final long[] EMPTY_LONG_ARRAY
public static final Long[] EMPTY_LONG_OBJECT_ARRAY
public static final short[] EMPTY_SHORT_ARRAY
public static final Short[] EMPTY_SHORT_OBJECT_ARRAY
public static final byte[] EMPTY_BYTE_ARRAY
public static final Byte[] EMPTY_BYTE_OBJECT_ARRAY
public static final double[] EMPTY_DOUBLE_ARRAY
public static final Double[] EMPTY_DOUBLE_OBJECT_ARRAY
public static final float[] EMPTY_FLOAT_ARRAY
public static final Float[] EMPTY_FLOAT_OBJECT_ARRAY
public static final boolean[] EMPTY_BOOLEAN_ARRAY
public static final Boolean[] EMPTY_BOOLEAN_OBJECT_ARRAY
Constructor Detail |
---|
private ArrayUtils()
Method Detail |
---|
public static final <T> List<T> castList(Object object)
El método no verifica los elementos de la lista, simplemente hace un casting para reducir las advertencias al compilar.
T
- Tipo de dato de la lista.object
- Lista cuyo elementos son de tipo T, pero viene expresado como un objeto.
ClassCastException
- si object no implementa List.public static final <T> List<T> castList(List<?> list)
El método no verifica los elementos de la lista, simplemente hace un casting para reducir las advertencias al compilar.
T
- Tipo de dato de la lista.list
- Lista cuyo elementos son de tipo T, pero viene de código antiguo que
no reconoce genéricos.
public static final <T> List<T> castList(List<?> all, Class<T> clazz)
T
- Tipo de datos de la lista.all
- Lista de objetos que se desea devolver como objeto de T. La funcion
equivale a "return all" pero con un casting previo de los elementos de
all.clazz
- Clase con la que se realiza el casting.
ClassCastException
- si algún elemento de la lista no es nulo y no es asignable
al tipo T.
NullPointerException
- si clazz es nulo.public static boolean isEmpty(Collection<?> all)
true
si la colección es nula o está vacía.
all
- Colección que se comprueba.
true
si la colección es nula o está vacía.public static boolean isEmpty(Object obj)
true
si el objeto es nulo o si, siendo algún tipo de dato iterable,
está vacío.
Analiza los siguientes tipos de datos para obj:
null
true
.xxx[]
)false
.
obj
- Instancia que se comprueba.
true
si el objeto es nulo o si, siendo algún tipo de dato iterable,
está vacío.private static boolean isEmptyArray(Object obj)
obj
- Instancia del Array.
true
si el obj está vacío.
NullPointerException
- si obj es nulo.public static int size(Collection<?> all)
null
.
all
- Colección que se comprueba.
null
.public static final boolean isEmpty(Map<?,?> mapa)
true
si el mapa que se le pasa es nulo o está vacío.
mapa
- Instancia de Map a verificar.
true
si el mapa es nulo o está vacío.public static <T> List<T> asList(T... all)
null
cuando all es
nulo, en vez de lanzar una NullPointerException.
T
- Tipo de dato de la lista.all
- Vector de objetos.
Arrays.asList(Object...)
public static <T> boolean isEmpty(T... all)
true
si el vector es nulo o está vacío.
all
- Vector de objetos que se comprueba.
true
si el vector es nulo o est´: vacío.public static <T> int size(T... all)
null
.
all
- Vector de objetos que se comprueba.
null
.public static <T> T[] asArray(T... all)
null
.
T
- Tipo de los elementos del array.all
- Lista de argumentos.
null
.public static boolean isEmpty(long[] all)
true
si el vector es nulo o está vacío.
all
- Vector de long
que se comprueba.
true
si el vector es nulo o está vacío.public static int size(long[] all)
null
.
all
- Vector de long
que se comprueba.
null
.public static long[] asLongArray(long... all)
null
.
all
- Lista de argumentos.
null
.public static boolean isEmpty(int[] all)
true
si el vector es nulo o está vacío.
all
- Vector de int
que se comprueba.
true
si el vector es nulo o está vacío.public static int size(int[] all)
null
.
all
- Vector de int
que se comprueba.
null
.public static boolean isEmpty(short[] all)
true
si el vector es nulo o está vacío.
all
- Vector de short
que se comprueba.
true
si el vector es nulo o está vacío.public static int[] asIntArray(int... all)
null
.
all
- Lista de argumentos.
null
.public static int size(short[] all)
null
.
all
- Vector de short
que se comprueba.
null
.public static short[] asShortArray(short... all)
null
.
all
- Lista de argumentos.
null
.public static boolean isEmpty(byte[] all)
true
si el vector es nulo o está vacío.
all
- Vector de byte
que se comprueba.
true
si el vector es nulo o está vacío.public static int size(byte[] all)
null
.
all
- Vector de byte
que se comprueba.
null
.public static byte[] asByteArray(byte... all)
null
.
all
- Lista de argumentos.
null
.public static final boolean isEmpty(char[] s)
s
- Cadena a comprobar.
true
si la cadena es nula o vacía.public static int size(char[] all)
null
.
all
- Vector de char
que se comprueba.
null
.public static char[] asCharArray(char... all)
null
.
all
- Lista de argumentos.
null
.public static boolean isEmpty(double[] all)
true
si el vector es nulo o está vacío.
all
- Vector de double
que se comprueba.
true
si el vector es nulo o está vacío.public static int size(double[] all)
null
.
all
- Vector de double
que se comprueba.
null
.public static double[] asDoubleArray(double... all)
null
.
all
- Lista de argumentos.
null
.public static boolean isEmpty(float[] all)
true
si el vector es nulo o está vacío.
all
- Vector de float
que se comprueba.
true
si el vector es nulo o está vacío.public static int size(float[] all)
null
.
all
- Vector de float
que se comprueba.
null
.public static float[] asFloatArray(float... all)
null
.
all
- Lista de argumentos.
null
.public static final boolean isEmpty(boolean[] all)
true
si el vector es nulo o está vacío.
all
- Vector de boolean
que se comprueba.
true
si el vector es nulo o está vacío.public static final int size(boolean[] all)
null
.
all
- Vector de boolean
que se comprueba.
null
.public static boolean[] asBooleanArray(boolean... all)
null
.
all
- Lista de argumentos.
null
.public static <T> boolean some(Iterable<T> all, ArrayUtils.IterableItemTest<T> test)
T
- Tipo de instancia a la que hacemos el test.all
- Elementos a evaluar.test
- Función de test. Si no se pasa función de test se considera que
ningún elemento cumple la no función de test.
true
si algún elemento de all devuelve true
al
evaluar contra la función test. Si alguno de los argumentos es nulo,
devuelve false
.ArrayUtils.IterableItemTest.doTest(Object,int)
public static <T> boolean some(T[] all, ArrayUtils.IterableItemTest<T> test)
T
- Tipo de instancia a la que hacemos el test.all
- Elementos a evaluar.test
- Función de test. Si no se pasa función de test se considera que
ningún elemento cumple la no función de test.
true
si algún elemento de all devuelve true
al
evaluar contra la función test. Si alguno de los argumentos es nulo,
devuelve false
.ArrayUtils.IterableItemTest.doTest(Object,int)
public static <T> boolean every(Iterable<T> all, ArrayUtils.IterableItemTest<T> test)
T
- Tipo de instancia a la que hacemos el test.all
- Elementos a evaluar. Si no se pasan elementos, se considera que todos ellos
cumplen la condición, aunque realmente no la cumple ninguno porque no hay
elementos.test
- Función de test. Si no se pasa función de test se considera que
todos los elementos cumplen la no función de test.
true
si todos los elementos de all devuelve true
al evaluar
contra la función test. Si alguno de los argumentos es nulo,
devuelve true
.ArrayUtils.IterableItemTest.doTest(Object,int)
public static <T> boolean every(T[] all, ArrayUtils.IterableItemTest<T> test)
T
- Tipo de instancia a la que hacemos el test.all
- Elementos a evaluar. Si no se pasan elementos, se considera que todos ellos
cumplen la condición, aunque realmente no la cumple ninguno porque no hay
elementos.test
- Función de test. Si no se pasa función de test se considera que
todos los elementos cumplen la no función de test.
true
si todos los elementos de all devuelve true
al evaluar
contra la función test. Si alguno de los argumentos es nulo,
devuelve true
.ArrayUtils.IterableItemTest.doTest(Object,int)
public static <T> void forEach(Iterable<T> all, ArrayUtils.IterableItemRun<T> runnable)
T
- Tipo de instancia sobre la que ejecutamos la acción.all
- Elementos a los que se quiere ejecutar la acción. Puede ser nulo: se
trataría como un vector vacío.runnable
- Implementación de la acción a realizar. Si es nulo no se ejecuta
nada.public static <T> void forEach(T[] all, ArrayUtils.IterableItemRun<T> runnable)
T
- Tipo de instancia sobre la que ejecutamos la acción.all
- Elementos a los que se quiere ejecutar la acción. Puede ser nulo: se
trataría como un vector vacío.runnable
- Implementación de la acción a realizar. Si es nulo no se ejecuta
nada.public static <T> void reverse(T... array)
T
- Tipo de dato del arreglo.array
- Arreglo a invertir, que puede ser nulo.public static void reverse(long... array)
array
- Arreglo a invertir, que puede ser nulo.public static void reverse(int... array)
array
- Arreglo a invertir, que puede ser nulo.public static void reverse(short... array)
array
- Arreglo a invertir, que puede ser nulo.public static void reverse(byte... array)
array
- Arreglo a invertir, que puede ser nulo.public static void reverse(char... array)
array
- Arreglo a invertir, que puede ser nulo.public static void reverse(double... array)
array
- Arreglo a invertir, que puede ser nulo.public static void reverse(float... array)
array
- Arreglo a invertir, que puede ser nulo.public static void reverse(boolean... array)
array
- Arreglo a invertir, que puede ser nulo.public static final <T> List<T> sort(Comparator<? super T> c, Collection<T> all)
T
- Tipo de objeto que se ordena.c
- Comparador a utilizar. Si se pasa null
se tratará de usar la
ordenación natural, si T implementa Comparable<T>.all
- Colección de elementos a ordenar.
ClassCastException
- si la colección contiene elementos que no son comparables.Arrays.sort(Object[], int, int, Comparator)
public static final <T extends Comparable<? super T>> List<T> sort(Collection<T> all)
T
- Tipo de objeto que se ordena. Debe implementar Comparable<T>.all
- Colección de elementos a ordenar.
sort(Comparator, Collection)
public static final <T> void sort(Comparator<? super T> c, T... all)
T
- Tipo de objeto que se ordena.c
- Comparador a utilizar. Si se pasa null
se tratará de usar la
ordenación natural, si T implementa Comparable<T>.all
- Arreglo de elementos a ordenar.
ClassCastException
- si el comparador es nulo y el arreglo contiene elementos que no son
comparables.Arrays.sort(Object[], int, int, Comparator)
public static final <T extends Comparable<? super T>> void sort(T... all)
T
- Tipo de objeto que se ordena. Debe implementar Comparable<T>.all
- Arreglo de elementos a ordenar.
ClassCastException
- si el arreglo contiene elementos que no son comparables.sort(Comparator, Object...)
|
||||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | |||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |