org.apache.velocity.tools.generic
Class ListTool

java.lang.Object
  extended by org.apache.velocity.tools.generic.ListTool

Deprecated.

@Deprecated
@DefaultKey(value="lists")
public class ListTool
extends Object

Tool for working with Lists and arrays in Velocity templates.

With the release of Velocity 1.6, this class is largely obsolete since Velocity 1.6 now allows all List methods to be called on arrays within templates.

It provides a method to get and set specified elements. Also provides methods to perform the following actions to Lists and arrays:

 Example uses:
  $primes                    -> new int[] {2, 3, 5, 7}
  $lists.size($primes)        -> 4
  $lists.get($primes, 2)      -> 5
  $lists.set($primes, 2, 1)   -> (primes[2] becomes 1)
  $lists.get($primes, 2)      -> 1
  $lists.isEmpty($primes)     -> false
  $lists.contains($primes, 7) -> true

 Example tools.xml config (if you want to use this with VelocityView):
 <tools>
   <toolbox scope="application">
     <tool class="org.apache.velocity.tools.generic.ListTool"/>
   </toolbox>
 </tools>
 

This tool is entirely threadsafe, and has no instance members. It may be used in any scope (request, session, or application).

Since:
VelocityTools 1.2
Version:
$Id: $
Author:
Shinobu Kawai

Constructor Summary
ListTool()
          Deprecated.  
 
Method Summary
 Boolean contains(Object list, Object element)
          Deprecated. Checks if a List/array contains a certain element.
 Object get(Object list, int index)
          Deprecated. Gets the specified element of a List/array.
 boolean isArray(Object object)
          Deprecated. Checks if an object is an array.
 Boolean isEmpty(Object list)
          Deprecated. Checks if a List/array is empty.
 boolean isList(Object object)
          Deprecated. Checks if an object is a List.
 Object set(Object list, int index, Object value)
          Deprecated. Sets the specified element of a List/array.
 Integer size(Object list)
          Deprecated. Gets the size of a List/array.
 
Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
 

Constructor Detail

ListTool

public ListTool()
Deprecated. 
Method Detail

get

public Object get(Object list,
                  int index)
Deprecated. 
Gets the specified element of a List/array. It will return null under the following conditions:

Parameters:
list - the List/array object.
index - the index of the List/array to get.
Returns:
the specified element of the List/array.

set

public Object set(Object list,
                  int index,
                  Object value)
Deprecated. 
Sets the specified element of a List/array. It will return null under the following conditions:

Parameters:
list - the List/array object.
index - the index of the List/array to set.
value - the element to set.
Returns:
blank if set, null if not set.

size

public Integer size(Object list)
Deprecated. 
Gets the size of a List/array. It will return null under the following conditions:

Parameters:
list - the List object.
Returns:
the size of the List.

isArray

public boolean isArray(Object object)
Deprecated. 
Checks if an object is an array.

Parameters:
object - the object to check.
Returns:
true if the object is an array.

isList

public boolean isList(Object object)
Deprecated. 
Checks if an object is a List.

Parameters:
object - the object to check.
Returns:
true if the object is a List.

isEmpty

public Boolean isEmpty(Object list)
Deprecated. 
Checks if a List/array is empty.

Parameters:
list - the List/array to check.
Returns:
true if the List/array is empty.

contains

public Boolean contains(Object list,
                        Object element)
Deprecated. 
Checks if a List/array contains a certain element.

Parameters:
list - the List/array to check.
element - the element to check.
Returns:
true if the List/array contains the element.


Copyright © 2002-2011 The Apache Software Foundation. All Rights Reserved.