public class LazyStringArrayList extends AbstractList<String > implements LazyStringList , RandomAccess
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.
| Modifier and Type | Field and Description |
|---|---|
static LazyStringList |
EMPTY
|
modCount| Constructor and Description |
|---|
LazyStringArrayList()
|
LazyStringArrayList(LazyStringList
|
LazyStringArrayList(List
|
| Modifier and Type | Method and Description |
|---|---|
void |
add(byte[] element)
Appends the specified element to the end of this list (optional operation).
|
void |
add(ByteString
Appends the specified element to the end of this list (optional operation).
|
void |
add(int index, String
|
boolean |
addAll(Collection
|
boolean |
addAll(int index, Collection
|
boolean |
addAllByteArray(Collection
Appends all elements in the specified byte[] collection to the end of this list.
|
boolean |
addAllByteString(Collection
Appends all elements in the specified ByteString collection to the end of this list.
|
List |
asByteArrayList()
Returns a mutable view of this list.
|
List |
asByteStringList()
Returns a view of the data as a list of ByteStrings.
|
void |
clear()
|
String |
get(int index)
|
byte[] |
getByteArray(int index)
Returns the element at the specified position in this list as byte[].
|
ByteString |
getByteString(int index)
Returns the element at the specified position in this list as a ByteString.
|
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[].
|
LazyStringList |
getUnmodifiableView()
Returns an unmodifiable view of the list.
|
void |
mergeFrom(LazyStringList
Merges all elements from another LazyStringList into this one.
|
String |
remove(int index)
|
void |
set(int index, byte[] s)
Replaces the element at the specified position in this list with the specified element (optional operation).
|
void |
set(int index, ByteString
Replaces the element at the specified position in this list with the specified element (optional operation).
|
String |
set(int index, String
|
int |
size()
|
add, equals, hashCode, indexOf, iterator, lastIndexOf, listIterator, listIterator, removeRange, subListcontains, containsAll, isEmpty, remove, removeAll, retainAll, toArray, toArray, toStringclone, finalize, getClass, notify, notifyAll, wait, wait, waitadd, contains, containsAll, equals, hashCode, indexOf, isEmpty, iterator, lastIndexOf, listIterator, listIterator, remove, removeAll, replaceAll, retainAll, sort, spliterator, subList, toArray, toArrayparallelStream, removeIf, streampublic static final LazyStringListEMPTY
public LazyStringArrayList()
public LazyStringArrayList(LazyStringListfrom)
public Stringget(int index)
public int size()
public void add(int index,
String element) public boolean addAll(Collection<? extends String > c)
public boolean addAll(int index,
Collection<? extends String> c) public boolean addAllByteString(Collection<? extends ByteString > values)
LazyStringList
addAllByteString in interface
LazyStringList
values - collection whose elements are to be added to this list
public boolean addAllByteArray(Collection<byte[]> c)
LazyStringList
addAllByteArray in interface
LazyStringList
c - collection whose elements are to be added to this list
public Stringremove(int index)
public void clear()
public void add(ByteStringelement)
LazyStringList
add in interface
LazyStringList
element - element to be appended to this list
public void add(byte[] element)
LazyStringList
add in interface
LazyStringList
element - element to be appended to this list
public ByteStringgetByteString(int index)
LazyStringList
getByteString in interface
LazyStringList
index - index of the element to return
public byte[] getByteArray(int index)
LazyStringList
getByteArray in interface
LazyStringList
index - index of the element to return
public void set(int index,
ByteString s)
LazyStringList
set in interface
LazyStringList
index - index of the element to replace
s - the element to be stored at the specified position
public void set(int index,
byte[] s)
LazyStringList
set in interface
LazyStringList
index - index of the element to replace
s - the element to be stored at the specified position
public List<?> getUnderlyingElements()
LazyStringList
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.
public void mergeFrom(LazyStringListother)
LazyStringList
List.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.
public List<byte[]> asByteArrayList()
LazyStringList
public List<ByteString > asByteStringList()
ProtocolStringList
public LazyStringListgetUnmodifiableView()
LazyStringList