com.google.protobuf

Class LazyStringArrayList

java.lang.Object

java.util.AbstractCollection<E>

java.util.AbstractList<java.lang.String>

com.google.protobuf.LazyStringArrayList

All Implemented Interfaces:

LazyStringList, java.lang.Iterable<java.lang.String>, java.util.Collection<java.lang.String>, java.util.List<java.lang.String>, java.util.RandomAccess

public class LazyStringArrayList
extends java.util.AbstractList<java.lang.String>
implements LazyStringList, java.util.RandomAccess

An implementation of LazyStringList that wraps an ArrayList. Each element is either a ByteString or a String. 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.

Author:

jonp@google.com (Jon Perlow)

Field Summary

Fields

Modifier and Type	Field and Description
static LazyStringList	EMPTY

Constructor Summary

Constructors

Constructor and Description
LazyStringArrayList()
LazyStringArrayList(LazyStringList from)
LazyStringArrayList(java.util.List<java.lang.String> from)

Method Summary

Methods

Modifier and Type	Method and Description
void	add(ByteString element) Appends the specified element to the end of this list (optional operation).
void	add(int index, java.lang.String element)
boolean	addAll(java.util.Collection<? extends java.lang.String> c)
boolean	addAll(int index, java.util.Collection<? extends java.lang.String> c)
void	clear()
java.lang.String	get(int index)
ByteString	getByteString(int index) Returns the element at the specified position in this list as a ByteString.
java.util.List<?>	getUnderlyingElements() Returns an unmodifiable List of the underlying elements, each of which is either a String or its equivalent UTF-8 encoded ByteString.
java.lang.String	remove(int index)
java.lang.String	set(int index, java.lang.String s)
int	size()

Methods inherited from class java.util.AbstractList

add, equals, hashCode, indexOf, iterator, lastIndexOf, listIterator, listIterator, subList

Methods inherited from class java.util.AbstractCollection

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

Methods inherited from class java.lang.Object

getClass, notify, notifyAll, wait, wait, wait

Methods inherited from interface java.util.List

add, contains, containsAll, equals, hashCode, indexOf, isEmpty, iterator, lastIndexOf, listIterator, listIterator, remove, removeAll, retainAll, subList, toArray, toArray

Field Detail

EMPTY

public static final LazyStringList EMPTY

Constructor Detail

LazyStringArrayList

public LazyStringArrayList()

LazyStringArrayList

public LazyStringArrayList(LazyStringList from)

LazyStringArrayList

public LazyStringArrayList(java.util.List<java.lang.String> from)

Method Detail

get

public java.lang.String get(int index)

Specified by:

get in interface java.util.List<java.lang.String>

Specified by:

get in class java.util.AbstractList<java.lang.String>

size

public int size()

Specified by:

size in interface java.util.Collection<java.lang.String>

Specified by:

size in interface java.util.List<java.lang.String>

Specified by:

size in class java.util.AbstractCollection<java.lang.String>

set

public java.lang.String set(int index,
                   java.lang.String s)

Specified by:

set in interface java.util.List<java.lang.String>

Overrides:

set in class java.util.AbstractList<java.lang.String>

add

public void add(int index,
       java.lang.String element)

Specified by:

add in interface java.util.List<java.lang.String>

Overrides:

add in class java.util.AbstractList<java.lang.String>

addAll

public boolean addAll(java.util.Collection<? extends java.lang.String> c)

Specified by:

addAll in interface java.util.Collection<java.lang.String>

Specified by:

addAll in interface java.util.List<java.lang.String>

Overrides:

addAll in class java.util.AbstractCollection<java.lang.String>

addAll

public boolean addAll(int index,
             java.util.Collection<? extends java.lang.String> c)

Specified by:

addAll in interface java.util.List<java.lang.String>

Overrides:

addAll in class java.util.AbstractList<java.lang.String>

remove

public java.lang.String remove(int index)

Specified by:

remove in interface java.util.List<java.lang.String>

Overrides:

remove in class java.util.AbstractList<java.lang.String>

clear

public void clear()

Specified by:

clear in interface java.util.Collection<java.lang.String>

Specified by:

clear in interface java.util.List<java.lang.String>

Overrides:

clear in class java.util.AbstractList<java.lang.String>

add

public void add(ByteString element)

Description copied from interface: LazyStringList

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

Specified by:

add in interface LazyStringList

Parameters:

element - element to be appended to this list

getByteString

public ByteString getByteString(int index)

Description copied from interface: LazyStringList

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

Specified by:

getByteString in interface LazyStringList

Parameters:

index - index of the element to return

Returns:

the element at the specified position in this list

getUnderlyingElements

public java.util.List<?> getUnderlyingElements()

Description copied from interface: LazyStringList

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

Specified by:

getUnderlyingElements in interface LazyStringList