Class LazyStringArrayList
- java.lang.Object
-
- java.util.AbstractCollection<E>
-
- java.util.AbstractList<java.lang.String>
-
- akka.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 ofLazyStringList
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.
-
-
Field Summary
Fields Modifier and Type Field Description static LazyStringList
EMPTY
-
Constructor Summary
Constructors Constructor Description LazyStringArrayList()
LazyStringArrayList(LazyStringList from)
LazyStringArrayList(java.util.List<java.lang.String> from)
-
Method Summary
All Methods Instance Methods Concrete Methods Modifier and Type Method Description void
add(int index, java.lang.String element)
void
add(ByteString element)
Appends the specified element to the end of this list (optional operation).boolean
addAll(int index, java.util.Collection<? extends java.lang.String> c)
boolean
addAll(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 aString
or its equivalent UTF-8 encodedByteString
.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, removeRange, subList
-
Methods inherited from class java.util.AbstractCollection
contains, containsAll, isEmpty, remove, removeAll, retainAll, toArray, toArray, toString
-
-
-
-
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 interfacejava.util.List<java.lang.String>
- Specified by:
get
in classjava.util.AbstractList<java.lang.String>
-
size
public int size()
- Specified by:
size
in interfacejava.util.Collection<java.lang.String>
- Specified by:
size
in interfacejava.util.List<java.lang.String>
- Specified by:
size
in classjava.util.AbstractCollection<java.lang.String>
-
set
public java.lang.String set(int index, java.lang.String s)
- Specified by:
set
in interfacejava.util.List<java.lang.String>
- Overrides:
set
in classjava.util.AbstractList<java.lang.String>
-
add
public void add(int index, java.lang.String element)
- Specified by:
add
in interfacejava.util.List<java.lang.String>
- Overrides:
add
in classjava.util.AbstractList<java.lang.String>
-
addAll
public boolean addAll(java.util.Collection<? extends java.lang.String> c)
- Specified by:
addAll
in interfacejava.util.Collection<java.lang.String>
- Specified by:
addAll
in interfacejava.util.List<java.lang.String>
- Overrides:
addAll
in classjava.util.AbstractCollection<java.lang.String>
-
addAll
public boolean addAll(int index, java.util.Collection<? extends java.lang.String> c)
- Specified by:
addAll
in interfacejava.util.List<java.lang.String>
- Overrides:
addAll
in classjava.util.AbstractList<java.lang.String>
-
remove
public java.lang.String remove(int index)
- Specified by:
remove
in interfacejava.util.List<java.lang.String>
- Overrides:
remove
in classjava.util.AbstractList<java.lang.String>
-
clear
public void clear()
- Specified by:
clear
in interfacejava.util.Collection<java.lang.String>
- Specified by:
clear
in interfacejava.util.List<java.lang.String>
- Overrides:
clear
in classjava.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 interfaceLazyStringList
- 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 interfaceLazyStringList
- 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 aString
or its equivalent UTF-8 encodedByteString
. It is an error for the caller to modify the returned List, and attempting to do so will result in anUnsupportedOperationException
.- Specified by:
getUnderlyingElements
in interfaceLazyStringList
-
-