org.osgl.util

Class ListBuilder<T>

java.lang.Object

java.util.AbstractCollection<E>

java.util.AbstractList<T>

org.osgl.util.ListBuilder<T>

All Implemented Interfaces:

Serializable, Iterable<T>, Collection<T>, List<T>, RandomAccess

public class ListBuilder<T>
extends AbstractList<T>
implements RandomAccess, Serializable

A simple array based List that support append element to the tail of the list only.

Notes:

• This class is NOT thread safe. Don't use it in multiple thread context
• removeX methods are not supported
• After running toList() the builder is obsolete and cannot be used anymore
• clear() method can be called to reset the builder before calling toList()

See Also:

Serialized Form

Field Summary

Fields inherited from class java.util.AbstractList

modCount

Constructor Summary

Constructors

Constructor and Description
ListBuilder(int initialCapacity)

Method Summary

Modifier and Type	Method and Description
void	add(int index, T element)
boolean	add(T t)
boolean	addAll(Collection<? extends T> c)
boolean	addAll(int index, Collection<? extends T> c)
boolean	addAll(int index, ListBuilder<? extends T> c)
boolean	addAll(ListBuilder<? extends T> c)
ListBuilder<T>	append(Collection<? extends T> col)
ListBuilder<T>	append(Collection<? extends T> c1, Collection<? extends T> c2)
ListBuilder<T>	append(Collection<? extends T> c1, Collection<? extends T> c2, Collection<? extends T>... ca)
ListBuilder<T>	append(Enumeration<? extends T> enumeration)
ListBuilder<T>	append(Iterable<? extends T> iterable)
ListBuilder<T>	append(Iterator<? extends T> iterator)
ListBuilder<T>	append(Object[] ta)
ListBuilder<T>	append(Object[] ta1, Object[] ta2)
ListBuilder<T>	append(Object[] ta1, Object[] ta2, Object[]... taa)
ListBuilder<T>	append(T t)
ListBuilder<T>	append(T t1, T t2)
ListBuilder<T>	append(T t1, T t2, T t3)
ListBuilder<T>	append(T t1, T t2, T t3, T t4)
ListBuilder<T>	append(T t1, T t2, T t3, T t4, T t5)
ListBuilder<T>	append(T t1, T t2, T t3, T t4, T t5, T... ta)
void	clear()
static <T> ListBuilder<T>	create() Create an empty ListBuilder instance
static <T> ListBuilder<T>	create(int initialCapacity)
T	get(int index)
int	size()
Object[]	toArray()
<T> T[]	toArray(T[] a)
C.List<T>	toList() Return an immutable list contains all element of this list builder and then release references to the internal buffer.
static <T> C.List<T>	toList(Collection<? extends T> col) Returns an immutable C.List from a collection
static <T> C.List<T>	toList(Enumeration<? extends T> enumeration)
static <T> C.List<T>	toList(Iterable<? extends T> iterable) Returns an immutable C.List from iterable
static <T> C.List<T>	toList(Iterator<? extends T> iterator) Returns an immutable C.List from an iterator
C.Set<T>	toSet()

Methods inherited from class java.util.AbstractList

equals, hashCode, indexOf, iterator, lastIndexOf, listIterator, listIterator, remove, removeRange, set, subList

Methods inherited from class java.util.AbstractCollection

contains, containsAll, isEmpty, remove, removeAll, retainAll, toString

Methods inherited from class java.lang.Object

clone, finalize, getClass, notify, notifyAll, wait, wait, wait

Methods inherited from interface java.util.List

contains, containsAll, isEmpty, remove, removeAll, replaceAll, retainAll, sort, spliterator

Methods inherited from interface java.util.Collection

parallelStream, removeIf, stream

Methods inherited from interface java.lang.Iterable

forEach

Constructor Detail

ListBuilder

public ListBuilder(int initialCapacity)

Method Detail

size

public int size()

Specified by:

size in interface Collection<T>

Specified by:

size in interface List<T>

Specified by:

size in class AbstractCollection<T>

get

public T get(int index)

Specified by:

get in interface List<T>

Specified by:

get in class AbstractList<T>

add

public boolean add(T t)

Specified by:

add in interface Collection<T>

Specified by:

add in interface List<T>

Overrides:

add in class AbstractList<T>

add

public void add(int index,
                T element)

Specified by:

add in interface List<T>

Overrides:

add in class AbstractList<T>

toArray

public Object[] toArray()

Specified by:

toArray in interface Collection<T>

Specified by:

toArray in interface List<T>

Overrides:

toArray in class AbstractCollection<T>

toArray

public <T> T[] toArray(T[] a)

Specified by:

toArray in interface Collection<T>

Specified by:

toArray in interface List<T>

Overrides:

toArray in class AbstractCollection<T>

addAll

public boolean addAll(Collection<? extends T> c)

Specified by:

addAll in interface Collection<T>

Specified by:

addAll in interface List<T>

Overrides:

addAll in class AbstractCollection<T>

addAll

public boolean addAll(ListBuilder<? extends T> c)

addAll

public boolean addAll(int index,
                      ListBuilder<? extends T> c)

addAll

public boolean addAll(int index,
                      Collection<? extends T> c)

Specified by:

addAll in interface List<T>

Overrides:

addAll in class AbstractList<T>

clear

public void clear()

Specified by:

clear in interface Collection<T>

Specified by:

clear in interface List<T>

Overrides:

clear in class AbstractList<T>

append

public ListBuilder<T> append(T t)

append

public ListBuilder<T> append(Object[] ta)

append

public ListBuilder<T> append(Object[] ta1,
                             Object[] ta2)

append

public ListBuilder<T> append(Object[] ta1,
                             Object[] ta2,
                             Object[]... taa)

append

public ListBuilder<T> append(T t1,
                             T t2)

append

public ListBuilder<T> append(T t1,
                             T t2,
                             T t3)

append

public ListBuilder<T> append(T t1,
                             T t2,
                             T t3,
                             T t4)

append

public ListBuilder<T> append(T t1,
                             T t2,
                             T t3,
                             T t4,
                             T t5)

append

public ListBuilder<T> append(T t1,
                             T t2,
                             T t3,
                             T t4,
                             T t5,
                             T... ta)

append

public ListBuilder<T> append(Collection<? extends T> col)

append

public ListBuilder<T> append(Collection<? extends T> c1,
                             Collection<? extends T> c2)

append

public ListBuilder<T> append(Collection<? extends T> c1,
                             Collection<? extends T> c2,
                             Collection<? extends T>... ca)

append

public ListBuilder<T> append(Iterable<? extends T> iterable)

append

public ListBuilder<T> append(Iterator<? extends T> iterator)

append

public ListBuilder<T> append(Enumeration<? extends T> enumeration)

toList

public C.List<T> toList()

Return an immutable list contains all element of this list builder and then release references to the internal buffer. The list builder is obsolete after calling this method, and calling other building method thereafter will trigger IllegalStateException

Returns:

an immutable list of all element of this builder

toSet

public C.Set<T> toSet()

toList

public static <T> C.List<T> toList(Iterable<? extends T> iterable)

Returns an immutable C.List from iterable

Type Parameters:

T - the element type

Parameters:

iterable - the iterable

Returns:

an immutable list contains all elements from the iterable

toList

public static <T> C.List<T> toList(Iterator<? extends T> iterator)

Returns an immutable C.List from an iterator

Type Parameters:

T - the element type

Parameters:

iterator - the iterator

Returns:

an immutable list contains all elements from the iterator

toList

public static <T> C.List<T> toList(Enumeration<? extends T> enumeration)

toList

public static <T> C.List<T> toList(Collection<? extends T> col)

Returns an immutable C.List from a collection

Type Parameters:

T - element type

Parameters:

col - the collection specified

Returns:

an immutable list contains all elements in the collection

create

public static <T> ListBuilder<T> create()

Create an empty ListBuilder instance

Type Parameters:

T - the type of the element in the builder

Returns:

a list builder

create

public static <T> ListBuilder<T> create(int initialCapacity)