|
||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | |||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |
java.lang.Objectjava.util.AbstractCollection<E>
java.util.AbstractList<java.lang.String>
com.google.protobuf.LazyStringArrayList
public class LazyStringArrayList
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.
Field Summary | |
---|---|
static LazyStringList |
EMPTY
|
Fields inherited from class java.util.AbstractList |
---|
modCount |
Constructor Summary | |
---|---|
LazyStringArrayList()
|
|
LazyStringArrayList(LazyStringList from)
|
|
LazyStringArrayList(java.util.List<java.lang.String> from)
|
Method Summary | |
---|---|
void |
add(byte[] element)
Appends the specified element to the end of this list (optional operation). |
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)
|
boolean |
addAllByteArray(java.util.Collection<byte[]> c)
Appends all elements in the specified byte[] collection to the end of this list. |
boolean |
addAllByteString(java.util.Collection<? extends ByteString> values)
Appends all elements in the specified ByteString collection to the end of this list. |
java.util.List<byte[]> |
asByteArrayList()
Returns a mutable view of this list. |
java.util.List<ByteString> |
asByteStringList()
Returns a view of the data as a list of ByteStrings. |
void |
clear()
|
java.lang.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. |
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
or byte[]. |
LazyStringList |
getUnmodifiableView()
Returns an unmodifiable view of the list. |
void |
mergeFrom(LazyStringList other)
Merges all elements from another LazyStringList into this one. |
java.lang.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 s)
Replaces the element at the specified position in this list with the specified element (optional operation). |
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, removeRange, subList |
Methods inherited from class java.util.AbstractCollection |
---|
contains, containsAll, isEmpty, remove, removeAll, retainAll, toArray, toArray, toString |
Methods inherited from class java.lang.Object |
---|
clone, finalize, 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 |
---|
public static final LazyStringList EMPTY
Constructor Detail |
---|
public LazyStringArrayList()
public LazyStringArrayList(LazyStringList from)
public LazyStringArrayList(java.util.List<java.lang.String> from)
Method Detail |
---|
public java.lang.String get(int index)
get
in interface java.util.List<java.lang.String>
get
in class java.util.AbstractList<java.lang.String>
public int size()
size
in interface java.util.Collection<java.lang.String>
size
in interface java.util.List<java.lang.String>
size
in class java.util.AbstractCollection<java.lang.String>
public java.lang.String set(int index, java.lang.String s)
set
in interface java.util.List<java.lang.String>
set
in class java.util.AbstractList<java.lang.String>
public void add(int index, java.lang.String element)
add
in interface java.util.List<java.lang.String>
add
in class java.util.AbstractList<java.lang.String>
public boolean addAll(java.util.Collection<? extends java.lang.String> c)
addAll
in interface java.util.Collection<java.lang.String>
addAll
in interface java.util.List<java.lang.String>
addAll
in class java.util.AbstractCollection<java.lang.String>
public boolean addAll(int index, java.util.Collection<? extends java.lang.String> c)
addAll
in interface java.util.List<java.lang.String>
addAll
in class java.util.AbstractList<java.lang.String>
public boolean addAllByteString(java.util.Collection<? extends ByteString> values)
LazyStringList
addAllByteString
in interface LazyStringList
values
- collection whose elements are to be added to this list
public boolean addAllByteArray(java.util.Collection<byte[]> c)
LazyStringList
addAllByteArray
in interface LazyStringList
c
- collection whose elements are to be added to this list
public java.lang.String remove(int index)
remove
in interface java.util.List<java.lang.String>
remove
in class java.util.AbstractList<java.lang.String>
public void clear()
clear
in interface java.util.Collection<java.lang.String>
clear
in interface java.util.List<java.lang.String>
clear
in class java.util.AbstractList<java.lang.String>
public void add(ByteString element)
LazyStringList
add
in interface LazyStringList
element
- element to be appended to this listpublic void add(byte[] element)
LazyStringList
add
in interface LazyStringList
element
- element to be appended to this listpublic ByteString getByteString(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 replaces
- the element to be stored at the specified positionpublic void set(int index, byte[] s)
LazyStringList
set
in interface LazyStringList
index
- index of the element to replaces
- the element to be stored at the specified positionpublic java.util.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
.
getUnderlyingElements
in interface LazyStringList
public void mergeFrom(LazyStringList other)
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.
mergeFrom
in interface LazyStringList
public java.util.List<byte[]> asByteArrayList()
LazyStringList
asByteArrayList
in interface LazyStringList
public java.util.List<ByteString> asByteStringList()
ProtocolStringList
asByteStringList
in interface ProtocolStringList
public LazyStringList getUnmodifiableView()
LazyStringList
getUnmodifiableView
in interface LazyStringList
|
||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | |||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |