Module org.omnifaces
Package 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: o:createArray(), o:createIntegerArray(), o:contains() and o:reverseArray().

Author:
Bauke Scholtz

  • Method Details

    • 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