org.omnifaces.el.functions

Class Arrays

java.lang.Object

org.omnifaces.el.functions.Arrays

public final class Arrays
extends Object

Collection of EL functions for array manipulation: of:createArray(), of:createIntegerArray(), of:contains() and of:reverseArray().

Author:

Bauke Scholtz

Method Summary

Modifier and Type	Method and Description
static boolean	contains(Object[] array, Object item) Returns true if the string representation of an item of the given array equals to the string representation of the given item.
static Object[]	createArray(int size) Creates and returns a dummy object array of the given size.
static Integer[]	createIntegerArray(int begin, int end) Creates and returns an integer array which starts at the given integer and ends at the given integer, inclusive.
static Object[]	reverseArray(Object[] array) Returns a copy of the array with items in reversed order.

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Method Detail

createArray

public static Object[] createArray(int size)

Creates and returns a dummy object array of the given size. This is useful if you want to iterate n times over an <ui:repeat>, which doesn't support EL in begin and end attributes.

Parameters:

size - The size of the dummy object array.

Returns:

A dummy object array of the given size.

Throws:

IllegalArgumentException - When the size is less than 0.

createIntegerArray

public static Integer[] createIntegerArray(int begin,
                                           int end)

Creates and returns an integer array which starts at the given integer and ends at the given integer, inclusive. This is useful if you want to for example populate a <f:selectItems> which shows an integer range to represent days and years. If the begin is greater than end, then the array will be decremental. If the begin equals end, then the array will contain only one item.

Parameters:

begin - The begin integer.

end - The end integer.

Returns:

An integer array which starts at the given integer and ends at the given integer, inclusive

contains

public static boolean contains(Object[] array,
                               Object item)

Returns true if the string representation of an item of the given array equals to the string representation of the given item. This returns false if either the array or the item is null. This is useful if you want to for example check if #{paramValues.foo} contains a certain value.

Parameters:

array - The array whose items have to be compared.

item - The item to be compared.

Returns:

true if the string representation of an item of the given array equals to the string representation of the given item.

reverseArray

public static Object[] reverseArray(Object[] array)

Returns a copy of the array with items in reversed order.

Parameters:

array - The array to reverse.

Returns:

A copy of the array with items in reversed order.

Since:

2.4