com.jn.langx.util.collection

类 AbstractCollectionDecorator<E>

java.lang.Object

com.jn.langx.util.collection.AbstractCollectionDecorator<E>

类型参数:

E - the type of the elements in the collection

所有已实现的接口:

Serializable, Iterable<E>, Collection<E>

直接已知子类:

AbstractListDecorator

public abstract class AbstractCollectionDecorator<E>
extends Object
implements Collection<E>, Serializable

Decorates another Collection to provide additional behaviour.

Each method call made on this Collection is forwarded to the decorated Collection. This class is used as a framework on which to build to extensions such as synchronized and unmodifiable behaviour. The main advantage of decoration is that one decorator can wrap any implementation of Collection, whereas sub-classing requires a new class to be written for each implementation.

This implementation does not perform any special processing with iterator(). Instead it simply returns the value from the wrapped collection. This may be undesirable, for example if you are trying to write an unmodifiable implementation it might provide a loophole.

This implementation does not forward the hashCode and equals methods through to the backing object, but relies on Object's implementation. This is necessary to preserve the symmetry of equals. Custom definitions of equality are usually based on an interface, such as Set or List, so that the implementation of equals can cast the object being tested for equality to the custom interface. AbstractCollectionDecorator does not implement such custom interfaces directly; they are implemented only in subclasses. Therefore, forwarding equals would break symmetry, as the forwarding object might consider itself equal to the object being tested, but the reverse could not be true. This behavior is consistent with the JDK's collection wrappers, such as Collections.unmodifiableCollection(Collection). Use an interface-specific subclass of AbstractCollectionDecorator, such as AbstractListDecorator, to preserve equality behavior, or override equals directly.

从以下版本开始:

4.7.6

另请参阅:

序列化表格

构造器概要

构造器

限定符	构造器和说明
protected	AbstractCollectionDecorator() Constructor only used in deserialization, do not use otherwise.
protected	AbstractCollectionDecorator(Collection<E> coll) Constructor that wraps (not copies).

方法概要

限定符和类型	方法和说明
boolean	add(E object)
boolean	addAll(Collection<? extends E> coll)
void	clear()
boolean	contains(Object object)
boolean	containsAll(Collection<?> coll)
protected Collection<E>	decorated() Gets the collection being decorated.
boolean	isEmpty()
Iterator<E>	iterator()
boolean	remove(Object object)
boolean	removeAll(Collection<?> coll)
boolean	retainAll(Collection<?> coll)
protected void	setCollection(Collection<E> coll) Sets the collection being decorated.
int	size()
Object[]	toArray()
<T> T[]	toArray(T[] object)
String	toString()

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

clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait

从接口继承的方法 java.util.Collection

equals, hashCode, parallelStream, removeIf, spliterator, stream

从接口继承的方法 java.lang.Iterable

forEach

构造器详细资料

AbstractCollectionDecorator

protected AbstractCollectionDecorator()

Constructor only used in deserialization, do not use otherwise.

从以下版本开始:

3.1

AbstractCollectionDecorator

protected AbstractCollectionDecorator(Collection<E> coll)

Constructor that wraps (not copies).

参数:

coll - the collection to decorate, must not be null

抛出:

NullPointerException - if the collection is null

方法详细资料

decorated

protected Collection<E> decorated()

Gets the collection being decorated. All access to the decorated collection goes via this method.

返回:

the decorated collection

setCollection

protected void setCollection(Collection<E> coll)

Sets the collection being decorated.

NOTE: this method should only be used during deserialization

参数:

coll - the decorated collection

add

public boolean add(E object)

指定者:

add 在接口中 Collection<E>

addAll

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

指定者:

addAll 在接口中 Collection<E>

clear

public void clear()

指定者:

clear 在接口中 Collection<E>

contains

public boolean contains(Object object)

指定者:

contains 在接口中 Collection<E>

isEmpty

public boolean isEmpty()

指定者:

isEmpty 在接口中 Collection<E>

iterator

public Iterator<E> iterator()

指定者:

iterator 在接口中 Iterable<E>

指定者:

iterator 在接口中 Collection<E>

remove

public boolean remove(Object object)

指定者:

remove 在接口中 Collection<E>

size

public int size()

指定者:

size 在接口中 Collection<E>

toArray

public Object[] toArray()

指定者:

toArray 在接口中 Collection<E>

toArray

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

指定者:

toArray 在接口中 Collection<E>

containsAll

public boolean containsAll(Collection<?> coll)

指定者:

containsAll 在接口中 Collection<E>

removeAll

public boolean removeAll(Collection<?> coll)

指定者:

removeAll 在接口中 Collection<E>

retainAll

public boolean retainAll(Collection<?> coll)

指定者:

retainAll 在接口中 Collection<E>

toString

public String toString()

覆盖:

toString 在类中 Object