LazyStringArrayList (Protocol Buffer Java API 2.4.0a API)

Package

Class

Use

Tree

Deprecated

Index

Help

PREV CLASS NEXT CLASS

FRAMES NO FRAMES

SUMMARY: NESTED | FIELD | CONSTR | METHOD

DETAIL: FIELD | CONSTR | METHOD

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
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:: [email protected] (Jon Perlow)

Field Summary
`static LazyStringList`	`EMPTY`

Fields inherited from class java.util.AbstractList
`modCount`

Constructor Summary
`LazyStringArrayList()`
`LazyStringArrayList(java.util.List<java.lang.String> from)`

Method Summary
`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(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.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
`addAll, 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, addAll, 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