Module org.omnifaces
Package org.omnifaces.el.functions

Class 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 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