org.skfiy.util.v8.extra

类 ReadMostlyVector<E>

java.lang.Object

org.skfiy.util.v8.extra.ReadMostlyVector<E>

所有已实现的接口:

Serializable, Cloneable, Iterable<E>, Collection<E>, List<E>, RandomAccess

public class ReadMostlyVector<E>
extends Object
implements List<E>, RandomAccess, Cloneable, Serializable

A class with the same methods and array-based characteristics as Vector but with reduced contention and improved throughput when invocations of read-only methods by multiple threads are most common.

The iterators returned by this class's iterator and listIterator methods are best-effort in the presence of concurrent modifications, and do NOT throw ConcurrentModificationException. An iterator's next() method returns consecutive elements as they appear in the underlying array upon each access. Alternatively, method snapshotIterator() may be used for deterministic traversals, at the expense of making a copy, and unavailability of method Iterator.remove.

Otherwise, this class supports all methods, under the same documented specifications, as Vector. Consult Vector for detailed specifications. Additionally, this class provides methods addIfAbsent(E) and addAllAbsent(java.util.Collection<? extends E>).

作者:

Doug Lea

另请参阅:

序列化表格

嵌套类概要

嵌套类

限定符和类型	类和说明
static interface	ReadMostlyVector.Action<A> Interface describing a void action of one argument

构造器概要

构造器

构造器和说明
ReadMostlyVector() Creates an empty vector.
ReadMostlyVector(Collection<? extends E> c) Creates a vector containing the elements of the specified collection, in the order they are returned by the collection's iterator.
ReadMostlyVector(int initialCapacity) Creates an empty vector with the given initial capacity.
ReadMostlyVector(int initialCapacity, int capacityIncrement) Creates an empty vector with the given initial capacity and capacity increment.

方法概要

方法

限定符和类型	方法和说明
boolean	add(E e)
void	add(int index, E element)
boolean	addAll(Collection<? extends E> c)
boolean	addAll(int index, Collection<? extends E> c)
int	addAllAbsent(Collection<? extends E> c) Appends all of the elements in the specified collection that are not already contained in this list, to the end of this list, in the order that they are returned by the specified collection's iterator.
void	addElement(E obj) See Vector.addElement(E)
boolean	addIfAbsent(E e) Appends the element, if not present.
int	capacity() See Vector.capacity()
void	clear()
ReadMostlyVector<E>	clone()
boolean	contains(Object o)
boolean	containsAll(Collection<?> c)
void	copyInto(Object[] anArray) See Vector.copyInto(java.lang.Object[])
E	elementAt(int index) See Vector.elementAt(int)
Enumeration<E>	elements() See Vector.elements()
void	ensureCapacity(int minCapacity) See Vector.ensureCapacity(int)
boolean	equals(Object o)
E	firstElement() See Vector.firstElement()
void	forEachReadOnly(ReadMostlyVector.Action<E> action)
E	get(int index)
int	hashCode()
int	indexOf(Object o)
int	indexOf(Object o, int index) See Vector.indexOf(Object, int)
void	insertElementAt(E obj, int index) See Vector.insertElementAt(E, int)
boolean	isEmpty()
Iterator<E>	iterator()
E	lastElement() See Vector.lastElement()
int	lastIndexOf(Object o)
int	lastIndexOf(Object o, int index) See Vector.lastIndexOf(Object, int)
ListIterator<E>	listIterator()
ListIterator<E>	listIterator(int index)
E	remove(int index)
boolean	remove(Object o)
boolean	removeAll(Collection<?> c)
void	removeAllElements() See Vector.removeAllElements()
boolean	removeElement(Object obj) See Vector.removeElement(java.lang.Object)
void	removeElementAt(int index) See Vector.removeElementAt(int)
boolean	retainAll(Collection<?> c)
E	set(int index, E element)
void	setElementAt(E obj, int index) See Vector.setElementAt(E, int)
void	setSize(int newSize) See Vector.setSize(int)
int	size()
Iterator<E>	snapshotIterator() Returns an iterator operating over a snapshot copy of the elements of this collection created upon construction of the iterator.
List<E>	subList(int fromIndex, int toIndex)
Object[]	toArray()
<T> T[]	toArray(T[] a)
String	toString()
void	trimToSize() See Vector.trimToSize()

从类继承的方法 java.lang.Object

finalize, getClass, notify, notifyAll, wait, wait, wait

构造器详细资料

ReadMostlyVector

public ReadMostlyVector(int initialCapacity,
                int capacityIncrement)

Creates an empty vector with the given initial capacity and capacity increment.

参数:

initialCapacity - the initial capacity of the underlying array

capacityIncrement - if non-zero, the number to add when resizing to accommodate additional elements. If zero, the array size is doubled when resized.

抛出:

IllegalArgumentException - if initial capacity is negative

ReadMostlyVector

public ReadMostlyVector(int initialCapacity)

Creates an empty vector with the given initial capacity.

参数:

initialCapacity - the initial capacity of the underlying array

抛出:

IllegalArgumentException - if initial capacity is negative

ReadMostlyVector

public ReadMostlyVector()

Creates an empty vector.

ReadMostlyVector

public ReadMostlyVector(Collection<? extends E> c)

Creates a vector containing the elements of the specified collection, in the order they are returned by the collection's iterator.

参数:

c - the collection of initially held elements

抛出:

NullPointerException - if the specified collection is null

方法详细资料

add

public boolean add(E e)

指定者:

add 在接口中 Collection<E>

指定者:

add 在接口中 List<E>

add

public void add(int index,
       E element)

指定者:

add 在接口中 List<E>

addAll

public boolean addAll(Collection<? extends E> c)

指定者:

addAll 在接口中 Collection<E>

指定者:

addAll 在接口中 List<E>

addAll

public boolean addAll(int index,
             Collection<? extends E> c)

指定者:

addAll 在接口中 List<E>

clear

public void clear()

指定者:

clear 在接口中 Collection<E>

指定者:

clear 在接口中 List<E>

contains

public boolean contains(Object o)

指定者:

contains 在接口中 Collection<E>

指定者:

contains 在接口中 List<E>

containsAll

public boolean containsAll(Collection<?> c)

指定者:

containsAll 在接口中 Collection<E>

指定者:

containsAll 在接口中 List<E>

equals

public boolean equals(Object o)

指定者:

equals 在接口中 Collection<E>

指定者:

equals 在接口中 List<E>

覆盖:

equals 在类中 Object

get

public E get(int index)

指定者:

get 在接口中 List<E>

hashCode

public int hashCode()

指定者:

hashCode 在接口中 Collection<E>

指定者:

hashCode 在接口中 List<E>

覆盖:

hashCode 在类中 Object

indexOf

public int indexOf(Object o)

指定者:

indexOf 在接口中 List<E>

isEmpty

public boolean isEmpty()

指定者:

isEmpty 在接口中 Collection<E>

指定者:

isEmpty 在接口中 List<E>

iterator

public Iterator<E> iterator()

指定者:

iterator 在接口中 Iterable<E>

指定者:

iterator 在接口中 Collection<E>

指定者:

iterator 在接口中 List<E>

lastIndexOf

public int lastIndexOf(Object o)

指定者:

lastIndexOf 在接口中 List<E>

listIterator

public ListIterator<E> listIterator()

指定者:

listIterator 在接口中 List<E>

listIterator

public ListIterator<E> listIterator(int index)

指定者:

listIterator 在接口中 List<E>

remove

public E remove(int index)

指定者:

remove 在接口中 List<E>

remove

public boolean remove(Object o)

指定者:

remove 在接口中 Collection<E>

指定者:

remove 在接口中 List<E>

removeAll

public boolean removeAll(Collection<?> c)

指定者:

removeAll 在接口中 Collection<E>

指定者:

removeAll 在接口中 List<E>

retainAll

public boolean retainAll(Collection<?> c)

指定者:

retainAll 在接口中 Collection<E>

指定者:

retainAll 在接口中 List<E>

set

public E set(int index,
    E element)

指定者:

set 在接口中 List<E>

size

public int size()

指定者:

size 在接口中 Collection<E>

指定者:

size 在接口中 List<E>

subList

public List<E> subList(int fromIndex,
              int toIndex)

指定者:

subList 在接口中 List<E>

toArray

public Object[] toArray()

指定者:

toArray 在接口中 Collection<E>

指定者:

toArray 在接口中 List<E>

toArray

public <T> T[] toArray(T[] a)

指定者:

toArray 在接口中 Collection<E>

指定者:

toArray 在接口中 List<E>

toString

public String toString()

覆盖:

toString 在类中 Object

addIfAbsent

public boolean addIfAbsent(E e)

Appends the element, if not present.

参数:

e - element to be added to this list, if absent

返回:

true if the element was added

addAllAbsent

public int addAllAbsent(Collection<? extends E> c)

Appends all of the elements in the specified collection that are not already contained in this list, to the end of this list, in the order that they are returned by the specified collection's iterator.

参数:

c - collection containing elements to be added to this list

返回:

the number of elements added

抛出:

NullPointerException - if the specified collection is null

另请参阅:

addIfAbsent(Object)

snapshotIterator

public Iterator<E> snapshotIterator()

Returns an iterator operating over a snapshot copy of the elements of this collection created upon construction of the iterator. The iterator does NOT support the remove method.

返回:

an iterator over the elements in this list in proper sequence

forEachReadOnly

public void forEachReadOnly(ReadMostlyVector.Action<E> action)

firstElement

public E firstElement()

See Vector.firstElement()

lastElement

public E lastElement()

See Vector.lastElement()

indexOf

public int indexOf(Object o,
          int index)

See Vector.indexOf(Object, int)

lastIndexOf

public int lastIndexOf(Object o,
              int index)

See Vector.lastIndexOf(Object, int)

setSize

public void setSize(int newSize)

See Vector.setSize(int)

copyInto

public void copyInto(Object[] anArray)

See Vector.copyInto(java.lang.Object[])

trimToSize

public void trimToSize()

See Vector.trimToSize()

ensureCapacity

public void ensureCapacity(int minCapacity)

See Vector.ensureCapacity(int)

elements

public Enumeration<E> elements()

See Vector.elements()

capacity

public int capacity()

See Vector.capacity()

elementAt

public E elementAt(int index)

See Vector.elementAt(int)

setElementAt

public void setElementAt(E obj,
                int index)

See Vector.setElementAt(E, int)

removeElementAt

public void removeElementAt(int index)

See Vector.removeElementAt(int)

insertElementAt

public void insertElementAt(E obj,
                   int index)

See Vector.insertElementAt(E, int)

addElement

public void addElement(E obj)

See Vector.addElement(E)

removeElement

public boolean removeElement(Object obj)

See Vector.removeElement(java.lang.Object)

removeAllElements

public void removeAllElements()

See Vector.removeAllElements()

clone

public ReadMostlyVector<E> clone()

覆盖:

clone 在类中 Object