com.aoindustries.util

Class MinimalList

java.lang.Object

com.aoindustries.util.MinimalList

public class MinimalList
extends Object

MinimalList provides a set of static methods to dynamically choose the most efficient List implementation. The implementation of List is changed as needed. MinimalList is most suited for building list-based data structures that use less heap space than a pure ArrayList-based solution.

size=0: null
size=1: Collections.singletonList
size=2: ArrayList

Author:

AO Industries, Inc.

Method Summary

Modifier and Type	Method and Description
static <E> List<E>	add(List<E> list, E elem) Adds a new element to a list, returning the (possibly new) list.
static <E> List<E>	copy(List<E> list) Performs a shallow copy of a list.
static <E> E	get(List<E> list, int index) Gets an element from a list.
static <E> List<E>	unmodifiable(List<E> list) Gets an unmodifiable wrapper around this list.

Methods inherited from class java.lang.Object

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

Method Detail

add

public static <E> List<E> add(List<E> list,
                              E elem)

Adds a new element to a list, returning the (possibly new) list.

get

public static <E> E get(List<E> list,
                        int index)
                 throws IndexOutOfBoundsException

Gets an element from a list.

Throws:

IndexOutOfBoundsException

copy

public static <E> List<E> copy(List<E> list)

Performs a shallow copy of a list. The list is assumed to have been created by MinimalList and to be used through MinimalList.

unmodifiable

public static <E> List<E> unmodifiable(List<E> list)

Gets an unmodifiable wrapper around this list. May or may not wrap this list itself.