Class LazyDynaList
- All Implemented Interfaces:
- Serializable,- Cloneable,- Iterable<Object>,- Collection<Object>,- List<Object>,- RandomAccess
Lazy DynaBean List.
There are two main purposes for this class:
- To provide Lazy List behavior - automatically growing and populating the Listwith eitherDynaBean</code>, <code>java.util.Mapor POJO Beans.
- To provide a straight forward way of putting a Collection or Array into the lazy list and a straight forward way to get it out again at the end.
All elements added to the List are stored as DynaBean's:
- java.util.Map</code> elements are "wrapped" in a <code>LazyDynaMap.
- POJO Bean elements are "wrapped" in a WrapDynaBean.
- DynaBean's are stored un-changed.
toArray()
 The toArray() method returns an array of the
    elements of the appropriate type. If the LazyDynaList
    is populated with Map objects a
    Map[] array is returned.
    If the list is populated with POJO Beans an appropriate
    array of the POJO Beans is returned. Otherwise a DynaBean[]
    array is returned.
 
toDynaBeanArray()
 The toDynaBeanArray() method returns a
    DynaBean[] array of the elements in the List.
 
N.B.All the elements in the List must be the
    same type. If the DynaClass</code> or <code>Class
    of the LazyDynaList's elements is
    not specified, then it will be automatically set to the type
    of the first element populated.
 
Example 1
If you have an array of java.util.Map[] - you can put that into
    a LazyDynaList.
    TreeMap[] myArray = .... // your Map[]
    List lazyList = new LazyDynaList(myArray);
 New elements of the appropriate Map type are automatically populated:
    // get(index) automatically grows the list
    DynaBean newElement = (DynaBean)lazyList.get(lazyList.size());
    newElement.put("someProperty", "someValue");
 Once you've finished you can get back an Array of the elements of the appropriate type:
    // Retrieve the array from the list
    TreeMap[] myArray = (TreeMap[])lazyList.toArray());
 Example 2
Alternatively you can create an empty List and specify the Class for List's elements. The LazyDynaList uses the Class to automatically populate elements:
    // for example For Maps
    List lazyList = new LazyDynaList(TreeMap.class);
    // for example For POJO Beans
    List lazyList = new LazyDynaList(MyPojo.class);
    // for example For DynaBeans
    List lazyList = new LazyDynaList(MyDynaBean.class);
 Example 3
Alternatively you can create an empty List and specify the DynaClass for List's elements. The LazyDynaList uses the DynaClass to automatically populate elements:
    // for example For Maps
    DynaClass dynaClass = new LazyDynaMap(new HashMap());
    List lazyList = new LazyDynaList(dynaClass);
    // for example For POJO Beans
    DynaClass dynaClass = (new WrapDynaBean(myPojo)).getDynaClass();
    List lazyList = new LazyDynaList(dynaClass);
    // for example For DynaBeans
    DynaClass dynaClass = new BasicDynaClass(properties);
    List lazyList = new LazyDynaList(dynaClass);
 N.B. You may wonder why control the type
    using a DynaClass</code> rather than the <code>Class as in the previous example - the reason is that some DynaBean implementations don't
 have a default empty constructor and therefore need to be instantiated using the DynaClass.newInstance() method.
 
Example 4
 A slight variation - set the element type using either the setElementType(Class) method or the setElementDynaClass(DynaClass) method - then
 populate with the normal List methods (i.e. add(), addAll() or set()).
 
 // Create a new LazyDynaList (100 element capacity)
 LazyDynaList lazyList = new LazyDynaList(100);
 // Either Set the element type...
 lazyList.setElementType(TreeMap.class);
 // ...or the element DynaClass...
 lazyList.setElementDynaClass(new MyCustomDynaClass());
 // Populate from a collection
 lazyList.addAll(myCollection);
 - Since:
- 1.8.0
- See Also:
- 
Field SummaryFields inherited from class java.util.AbstractListmodCount
- 
Constructor SummaryConstructorsConstructorDescriptionConstructs a new instance.LazyDynaList(int capacity) Constructs a LazyDynaList with the specified capacity.LazyDynaList(Class<?> elementType) Constructs a LazyDynaList with a specified type for its elements.LazyDynaList(Object[] array) Constructs a LazyDynaList populated with the elements of an Array.LazyDynaList(Collection<?> collection) Constructs a LazyDynaList populated with the elements of a Collection.LazyDynaList(DynaClass elementDynaClass) Constructs a LazyDynaList with a specified DynaClass for its elements.
- 
Method SummaryModifier and TypeMethodDescriptionvoidInsert an element at the specified index position.booleanAdd an element to the List.booleanaddAll(int index, Collection<?> collection) Insert all the elements from a Collection into the list at a specified position.booleanaddAll(Collection<?> collection) Add all the elements from a Collection to the list.get(int index) Return the element at the specified position.Set the element at the specified position.voidsetElementDynaClass(DynaClass elementDynaClass) Set the element Type and DynaClass.voidsetElementType(Class<?> elementType) Set the element Type and DynaClass.Object[]toArray()Converts the List to an Array.<T> T[]toArray(T[] model) Converts the List to an Array of the specified type.DynaBean[]Converts the List to an DynaBean Array.Methods inherited from class java.util.ArrayListclear, clone, contains, ensureCapacity, forEach, indexOf, isEmpty, iterator, lastIndexOf, listIterator, listIterator, remove, remove, removeAll, removeIf, removeRange, replaceAll, retainAll, size, sort, spliterator, subList, trimToSizeMethods inherited from class java.util.AbstractListequals, hashCodeMethods inherited from class java.util.AbstractCollectioncontainsAll, toStringMethods inherited from class java.lang.Objectfinalize, getClass, notify, notifyAll, wait, wait, waitMethods inherited from interface java.util.CollectionparallelStream, streamMethods inherited from interface java.util.ListcontainsAll, equals, hashCode
- 
Constructor Details- 
LazyDynaListpublic LazyDynaList()Constructs a new instance.
- 
LazyDynaListConstructs a LazyDynaList with a specified type for its elements.- Parameters:
- elementType- The Type of the List's elements.
 
- 
LazyDynaListConstructs a LazyDynaList populated with the elements of a Collection.- Parameters:
- collection- The Collection to populate the List from.
 
- 
LazyDynaListConstructs a LazyDynaList with a specified DynaClass for its elements.- Parameters:
- elementDynaClass- The DynaClass of the List's elements.
 
- 
LazyDynaListConstructs a LazyDynaList with the specified capacity.- Parameters:
- capacity- The initial capacity of the list.
 
- 
LazyDynaListConstructs a LazyDynaList populated with the elements of an Array.- Parameters:
- array- The Array to populate the List from.
 
 
- 
- 
Method Details- 
addInsert an element at the specified index position. If the index position is greater than the current size of the List, then the List is automatically grown to the appropriate size. 
- 
addAdd an element to the List. 
- 
addAllAdd all the elements from a Collection to the list. 
- 
addAllInsert all the elements from a Collection into the list at a specified position. If the index position is greater than the current size of the List, then the List is automatically grown to the appropriate size. 
- 
getReturn the element at the specified position. If the position requested is greater than the current size of the List, then the List is automatically grown (and populated) to the appropriate size. 
- 
setSet the element at the specified position. If the position requested is greater than the current size of the List, then the List is automatically grown (and populated) to the appropriate size. 
- 
setElementDynaClassSet the element Type and DynaClass. - Parameters:
- elementDynaClass- The DynaClass of the elements.
- Throws:
- IllegalArgumentException- if the List already contains elements or the DynaClass is null.
 
- 
setElementTypeSet the element Type and DynaClass. - Parameters:
- elementType- The type of the elements.
- Throws:
- IllegalArgumentException- if the List already contains elements or the DynaClass is null.
 
- 
toArrayConverts the List to an Array. The type of Array created depends on the contents of the List: - If the List contains only LazyDynaMap type elements then a java.util.Map[] array will be created.
- If the List contains only elements which are "wrapped" DynaBeans then an Object[] of the most suitable type will be created.
- ...otherwise a DynaBean[] will be created.
 
- 
toArrayConverts the List to an Array of the specified type. - Specified by:
- toArrayin interface- Collection<Object>
- Specified by:
- toArrayin interface- List<Object>
- Overrides:
- toArrayin class- ArrayList<Object>
- Type Parameters:
- T- The type of the array elements
- Parameters:
- model- The model for the type of array to return
- Returns:
- An Array of the elements in this List.
 
- 
toDynaBeanArrayConverts the List to an DynaBean Array. - Returns:
- A DynaBean[] of the elements in this List.
 
 
-