Class LazyStringArrayList (3.19.4)

public class LazyStringArrayList extends AbstractProtobufList<String> implements LazyStringList, RandomAccess

An implementation of LazyStringList that wraps an ArrayList. Each element is one of String, ByteString, or byte[]. It caches the last one requested which is most likely the one needed next. This minimizes memory usage while satisfying the most common use cases.

Note that this implementation is not synchronized. If multiple threads access an ArrayList instance concurrently, and at least one of the threads modifies the list structurally, it must be synchronized externally. (A structural modification is any operation that adds or deletes one or more elements, or explicitly resizes the backing array; merely setting the value of an element is not a structural modification.) This is typically accomplished by synchronizing on some object that naturally encapsulates the list.

If the implementation is accessed via concurrent reads, this is thread safe. Conversions are done in a thread safe manner. It's possible that the conversion may happen more than once if two threads attempt to access the same element and the modifications were not visible to each other, but this will not result in any corruption of the list or change in behavior other than performance.

Inheritance

Object > java.util.AbstractCollection > AbstractList > com.google.protobuf.AbstractProtobufList > LazyStringArrayList

Implements

LazyStringList, RandomAccess

Inherited Members

com.google.protobuf.AbstractProtobufList.add(E)

com.google.protobuf.AbstractProtobufList.add(int,E)

com.google.protobuf.AbstractProtobufList.addAll(int,java.util.Collection<? extends E>)

com.google.protobuf.AbstractProtobufList.addAll(java.util.Collection<? extends E>)

com.google.protobuf.AbstractProtobufList.clear()

com.google.protobuf.AbstractProtobufList.ensureIsMutable()

com.google.protobuf.AbstractProtobufList.equals(java.lang.Object)

com.google.protobuf.AbstractProtobufList.hashCode()

com.google.protobuf.AbstractProtobufList.isModifiable()

com.google.protobuf.AbstractProtobufList.makeImmutable()

com.google.protobuf.AbstractProtobufList.remove(int)

com.google.protobuf.AbstractProtobufList.remove(java.lang.Object)

com.google.protobuf.AbstractProtobufList.removeAll(java.util.Collection<?>)

com.google.protobuf.AbstractProtobufList.retainAll(java.util.Collection<?>)

com.google.protobuf.AbstractProtobufList.set(int,E)

Object.clone()

Object.finalize()

Object.getClass()

Object.notify()

Object.notifyAll()

Object.wait()

Object.wait(long)

Object.wait(long,int)

AbstractCollection.<T>toArray(T[])

AbstractCollection.contains(Object)

AbstractCollection.containsAll(Collection<?>)

AbstractCollection.isEmpty()

AbstractCollection.size()

AbstractCollection.toArray()

AbstractCollection.toString()

AbstractList.get(int)

AbstractList.indexOf(Object)

AbstractList.iterator()

AbstractList.lastIndexOf(Object)

AbstractList.listIterator()

AbstractList.listIterator(int)

AbstractList.removeRange(int,int)

AbstractList.subList(int,int)

Static Fields

EMPTY

public static final LazyStringList EMPTY

Field Value
Type	Description
LazyStringList

Constructors

LazyStringArrayList()

public LazyStringArrayList()

LazyStringArrayList(LazyStringList from)

public LazyStringArrayList(LazyStringList from)

Parameter
Name	Description
from	LazyStringList

LazyStringArrayList(int initialCapacity)

public LazyStringArrayList(int initialCapacity)

Parameter
Name	Description
initialCapacity	int

LazyStringArrayList(List<String> from)

public LazyStringArrayList(List<String> from)

Parameter
Name	Description
from	List<String>

Methods

add(byte[] element)

public void add(byte[] element)

Appends the specified element to the end of this list (optional operation).

Parameter
Name	Description
element	byte[]

add(ByteString element)

public void add(ByteString element)

Appends the specified element to the end of this list (optional operation).

Parameter
Name	Description
element	ByteString

add(int index, String element)

public void add(int index, String element)

Parameters
Name	Description
index	int
element	String

Overrides

com.google.protobuf.AbstractProtobufList.add(int,E)

addAll(int index, Collection<? extends String> c)

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

Parameters
Name	Description
index	int
c	Collection<? extends java.lang.String>

Returns
Type	Description
boolean

Overrides

com.google.protobuf.AbstractProtobufList.addAll(int,java.util.Collection<? extends E>)

addAll(Collection<? extends String> c)

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

Parameter
Name	Description
c	Collection<? extends java.lang.String>

Returns
Type	Description
boolean

Overrides

com.google.protobuf.AbstractProtobufList.addAll(java.util.Collection<? extends E>)

addAllByteArray(Collection<byte[]> c)

public boolean addAllByteArray(Collection<byte[]> c)

Appends all elements in the specified byte[] collection to the end of this list.

Parameter
Name	Description
c	Collection<byte[]>

Returns
Type	Description
boolean

addAllByteString(Collection<? extends ByteString> values)

public boolean addAllByteString(Collection<? extends ByteString> values)

Appends all elements in the specified ByteString collection to the end of this list.

Parameter
Name	Description
values	Collection<? extends com.google.protobuf.ByteString>

Returns
Type	Description
boolean

asByteArrayList()

public List<byte[]> asByteArrayList()

Returns a mutable view of this list. Changes to the view will be made into the original list. This method is used in mutable API only.

Returns
Type	Description
List<byte[]>

asByteStringList()

public List<ByteString> asByteStringList()

Returns a view of the data as a list of ByteStrings.

Returns
Type	Description
List<ByteString>

clear()

public void clear()

Overrides

com.google.protobuf.AbstractProtobufList.clear()

get(int index)

public String get(int index)

Parameter
Name	Description
index	int

Returns
Type	Description
String

Overrides

AbstractList.get(int)

getByteArray(int index)

public byte[] getByteArray(int index)

Returns the element at the specified position in this list as byte[].

Parameter
Name	Description
index	int

Returns
Type	Description
byte[]

getByteString(int index)

public ByteString getByteString(int index)

Returns the element at the specified position in this list as a ByteString.

Parameter
Name	Description
index	int

Returns
Type	Description
ByteString

getRaw(int index)

public Object getRaw(int index)

Returns the element at the specified position in this list as an Object that will either be a String or a ByteString.

Parameter
Name	Description
index	int

Returns
Type	Description
Object

getUnderlyingElements()

public List<?> getUnderlyingElements()

Returns an unmodifiable List of the underlying elements, each of which is either a String or its equivalent UTF-8 encoded ByteString or byte[]. It is an error for the caller to modify the returned List, and attempting to do so will result in an UnsupportedOperationException.

Returns
Type	Description
List<?>

getUnmodifiableView()

public LazyStringList getUnmodifiableView()

Returns an unmodifiable view of the list.

Returns
Type	Description
LazyStringList

mergeFrom(LazyStringList other)

public void mergeFrom(LazyStringList other)

Merges all elements from another LazyStringList into this one. This method differs from #addAll(Collection) on that underlying byte arrays are copied instead of reference shared. Immutable API doesn't need to use this method as byte[] is not used there at all.

Parameter
Name	Description
other	LazyStringList

mutableCopyWithCapacity(int capacity)

public LazyStringArrayList mutableCopyWithCapacity(int capacity)

Parameter
Name	Description
capacity	int

Returns
Type	Description
LazyStringArrayList

remove(int index)

public String remove(int index)

Parameter
Name	Description
index	int

Returns
Type	Description
String

Overrides

com.google.protobuf.AbstractProtobufList.remove(int)

set(int index, byte[] s)

public void set(int index, byte[] s)

Replaces the element at the specified position in this list with the specified element (optional operation).

Parameters
Name	Description
index	int
s	byte[]

set(int index, ByteString s)

public void set(int index, ByteString s)

Replaces the element at the specified position in this list with the specified element (optional operation).

Parameters
Name	Description
index	int
s	ByteString

set(int index, String s)

public String set(int index, String s)

Parameters
Name	Description
index	int
s	String

Returns
Type	Description
String

Overrides

com.google.protobuf.AbstractProtobufList.set(int,E)

size()

public int size()

Returns
Type	Description
int

Overrides

AbstractCollection.size()