Package com.google.common.collect

Class ImmutableList.Builder<E>

java.lang.Object

com.google.common.collect.ImmutableCollection.Builder<E>

com.google.common.collect.ImmutableList.Builder<E>

Enclosing class:

ImmutableList<E>

@Deprecated(since="2022-12-01")
public static final class ImmutableList.Builder<E>
extends ImmutableCollection.Builder<E>

Deprecated.

The Google Guava Core Libraries are deprecated and will not be part of the AEM SDK after April 2023

A builder for creating immutable list instances, especially public static final lists ("constant lists"). Example:

   

    public static final ImmutableList<Color> GOOGLE_COLORS
        = new ImmutableList.Builder<Color>()
            .addAll(WEBSAFE_COLORS)
            .add(new Color(0, 191, 255))
            .build();

Builder instances can be reused; it is safe to call build() multiple times to build multiple lists in series. Each new list contains all the elements of the ones created before it.

Since:

2.0 (imported from Google Collections Library)

Constructor Summary

Constructors

Constructor	Description
Builder()	Deprecated. Creates a new builder.

Method Summary

Modifier and Type	Method	Description
ImmutableList.Builder<E>	add(E element)	Deprecated. Adds element to the ImmutableList.
ImmutableList.Builder<E>	add(E... elements)	Deprecated. Adds each element of elements to the ImmutableList.
ImmutableList.Builder<E>	addAll(java.lang.Iterable<? extends E> elements)	Deprecated. Adds each element of elements to the ImmutableList.
ImmutableList.Builder<E>	addAll(java.util.Iterator<? extends E> elements)	Deprecated. Adds each element of elements to the ImmutableList.
ImmutableList<E>	build()	Deprecated. Returns a newly-created ImmutableList based on the contents of the Builder.

Methods inherited from class java.lang.Object

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

Constructor Detail

Builder

public Builder()

Deprecated.

Creates a new builder. The returned builder is equivalent to the builder generated by ImmutableList.builder().

Method Detail

add

public ImmutableList.Builder<E> add(E element)

Deprecated.

Adds element to the ImmutableList.

Parameters:

element - the element to add

Returns:

this Builder object

Throws:

java.lang.NullPointerException - if element is null

addAll

public ImmutableList.Builder<E> addAll(java.lang.Iterable<? extends E> elements)

Deprecated.

Adds each element of elements to the ImmutableList.

Parameters:

elements - the Iterable to add to the ImmutableList

Returns:

this Builder object

Throws:

java.lang.NullPointerException - if elements is null or contains a null element

add

public ImmutableList.Builder<E> add(E... elements)

Deprecated.

Adds each element of elements to the ImmutableList.

Parameters:

elements - the Iterable to add to the ImmutableList

Returns:

this Builder object

Throws:

java.lang.NullPointerException - if elements is null or contains a null element

addAll

public ImmutableList.Builder<E> addAll(java.util.Iterator<? extends E> elements)

Deprecated.

Adds each element of elements to the ImmutableList.

Overrides:

addAll in class ImmutableCollection.Builder<E>

Parameters:

elements - the Iterable to add to the ImmutableList

Returns:

this Builder object

Throws:

java.lang.NullPointerException - if elements is null or contains a null element

build

public ImmutableList<E> build()

Deprecated.

Returns a newly-created ImmutableList based on the contents of the Builder.

Specified by:

build in class ImmutableCollection.Builder<E>