javolution.util.internal.collection.SharedCollectionImpl< E > Class Template Reference

Inheritance diagram for javolution.util.internal.collection.SharedCollectionImpl< E >:

Collaboration diagram for javolution.util.internal.collection.SharedCollectionImpl< E >:

Classes
class	IteratorImpl

Public Member Functions
	SharedCollectionImpl (CollectionService< E > target)
	SharedCollectionImpl (CollectionService< E > target, ReadWriteLockImpl lock)
boolean	add (E element)
boolean	addAll (Collection<? extends E > c)
void	clear ()
SharedCollectionImpl< E >	clone ()
Equality<? super E >	comparator ()
boolean	contains (Object o)
boolean	containsAll (Collection<?> c)
boolean	equals (Object o)
int	hashCode ()
boolean	isEmpty ()
Iterator< E >	iterator ()
void	perform (Consumer< CollectionService< E >> action, CollectionService< E > view)
boolean	remove (Object o)
boolean	removeAll (Collection<?> c)
boolean	retainAll (Collection<?> c)
int	size ()
CollectionService< E >[]	split (int n)
CollectionService< E >	threadSafe ()
Object[]	toArray ()
FastCollection< E >	addAll (E... elements)
FastCollection< E >	addAll (FastCollection<? extends E > that)
void	perform (Consumer<? extends Collection< E >> action)
void	perform (Consumer< T > action, T part)
void	update (Consumer< CollectionService< E >> action, CollectionService< E > view)
void	update (Consumer<? extends Collection< E >> action)
void	update (Consumer< T > action, T part)
FastCollection< E >	atomic ()
FastCollection< E >	shared ()
FastCollection< E >	parallel ()
FastCollection< E >	sequential ()
FastCollection< E >	unmodifiable ()
FastCollection< E >	filtered (Predicate<? super E > filter)
FastCollection< E >	sorted ()
FastCollection< E >	sorted (Comparator<? super E > cmp)
FastCollection< E >	reversed ()
FastCollection< E >	distinct ()
void	forEach (final Consumer<? super E > consumer)
boolean	removeIf (final Predicate<? super E > filter)
E	reduce (Reducer< E > reducer)
E	min ()
E	max ()
String	toString ()

Protected Member Functions
CollectionService< E >	cloneTarget ()
CollectionService< E >	target ()
CollectionService< E >	service ()

Static Protected Member Functions
static< E > CollectionService< E >	serviceOf (FastCollection< E > collection)

Protected Attributes
ReadWriteLockImpl	lock

Package Functions
public< T > T[]	toArray (T[] a)
public< R > FastCollection< R >	mapped (Function<? super E, ? extends R > function)
public< T extends E > T	any (Class< T > type)
public< T extends Collection< E > > Immutable< T >	toImmutable ()

Private Attributes
CollectionService< E >	target

Static Private Attributes
static final long	serialVersionUID = 0x600L

Detailed Description

A shared view over a collection (reads-write locks).

Definition at line 21 of file SharedCollectionImpl.java.

Constructor & Destructor Documentation

SharedCollectionImpl() [1/2]

javolution.util.internal.collection.SharedCollectionImpl< E >.SharedCollectionImpl

(

CollectionService< E >

target

)

Definition at line 59 of file SharedCollectionImpl.java.

                                                             {
        this(target, new ReadWriteLockImpl());
    }

References javolution.util.internal.collection.CollectionView< E >.target.

SharedCollectionImpl() [2/2]

javolution.util.internal.collection.SharedCollectionImpl< E >.SharedCollectionImpl	(	CollectionService< E >	target,
		ReadWriteLockImpl	lock
	)

Definition at line 63 of file SharedCollectionImpl.java.

                                    {
        super(target);
        this.lock = lock;
    }

References javolution.util.internal.collection.SharedCollectionImpl< E >.lock, and javolution.util.internal.collection.CollectionView< E >.target.

Member Function Documentation

add()

boolean javolution.util.internal.collection.SharedCollectionImpl< E >.add

(

E

element

)

Adds the specified element to this collection

Reimplemented from javolution.util.internal.collection.CollectionView< E >.

Definition at line 70 of file SharedCollectionImpl.java.

                                  {
        lock.writeLock.lock();
        try {
            return target().add(element);
        } finally {
            lock.writeLock.unlock();
        }
    }

References javolution.util.internal.collection.SharedCollectionImpl< E >.lock, javolution.util.internal.collection.ReadWriteLockImpl.WriteLock.lock(), javolution.util.internal.collection.CollectionView< E >.target, javolution.util.internal.collection.ReadWriteLockImpl.WriteLock.unlock(), and javolution.util.internal.collection.ReadWriteLockImpl.writeLock.

Here is the call graph for this function:

addAll() [1/3]

boolean javolution.util.internal.collection.SharedCollectionImpl< E >.addAll

(

Collection<? extends E >

that

)

Adds all the specified elements to this collection.

Reimplemented from javolution.util.internal.collection.CollectionView< E >.

Definition at line 80 of file SharedCollectionImpl.java.

                                                     {
        lock.writeLock.lock();
        try {
            return target().addAll(c);
        } finally {
            lock.writeLock.unlock();
        }
    }

References javolution.util.internal.collection.SharedCollectionImpl< E >.lock, javolution.util.internal.collection.ReadWriteLockImpl.WriteLock.lock(), javolution.util.internal.collection.CollectionView< E >.target, javolution.util.internal.collection.ReadWriteLockImpl.WriteLock.unlock(), and javolution.util.internal.collection.ReadWriteLockImpl.writeLock.

Here is the call graph for this function:

addAll() [2/3]

FastCollection<E> javolution.util.FastCollection< E >.addAll ( E...  elements )

inherited

Returns this collection with the specified element added.

Parameters

elements

the elements to be added.

Returns

this 

Reimplemented in javolution.util.FastTable< E >, javolution.util.FastSortedSet< E >, javolution.util.FastSet< E >, and javolution.util.FastSortedTable< E >.

Definition at line 552 of file FastCollection.java.

                                                   {
        for (E e : elements) {
            add(e);
        }
        return this;
    }

addAll() [3/3]

FastCollection<E> javolution.util.FastCollection< E >.addAll ( FastCollection<? extends E >  that )

inherited

Returns this collection with the specified collection's elements added in sequence.

Reimplemented in javolution.util.FastTable< E >, javolution.util.FastSortedSet< E >, javolution.util.FastSet< E >, and javolution.util.FastSortedTable< E >.

Definition at line 564 of file FastCollection.java.

                                                                      {
        addAll((Collection<? extends E>) that);
        return this;
    }

any()

public<T extends E> T javolution.util.FastCollection< E >.any ( Class< T >  type )

packageinherited

Returns any non-null element of the specified type (convenience method).

Parameters

type	the element type searched for.

Returns

reduce(Reducers.any(type)) 

See also

Reducers::any

Definition at line 515 of file FastCollection.java.

                                              {
        return (T) reduce((Reducer<E>) Reducers.any(type));
    }

References javolution.util.function.Reducers.any().

Here is the call graph for this function:

atomic()

FastCollection<E> javolution.util.FastCollection< E >.atomic ( )

inherited

Returns an atomic view over this collection. All operations that write or access multiple elements in the collection (such as addAll(), retainAll()) are atomic. Iterators on atomic collections are thread-safe (no ConcurrentModificationException possible).

Reimplemented in javolution.util.FastTable< E >, javolution.util.FastSet< E >, javolution.util.FastSortedTable< E >, and javolution.util.FastSortedSet< E >.

Definition at line 187 of file FastCollection.java.

                                      {
        return new AtomicCollectionImpl<E>(service());
    }

clear()

void javolution.util.internal.collection.SharedCollectionImpl< E >.clear

(

)

Removes all elements from this collection.

Reimplemented from javolution.util.internal.collection.CollectionView< E >.

Definition at line 90 of file SharedCollectionImpl.java.

                        {
        lock.writeLock.lock();
        try {
            target().clear();
        } finally {
            lock.writeLock.unlock();
        }
    }

References javolution.util.internal.collection.SharedCollectionImpl< E >.lock, javolution.util.internal.collection.ReadWriteLockImpl.WriteLock.lock(), javolution.util.internal.collection.CollectionView< E >.target, javolution.util.internal.collection.ReadWriteLockImpl.WriteLock.unlock(), and javolution.util.internal.collection.ReadWriteLockImpl.writeLock.

Here is the call graph for this function:

clone()

SharedCollectionImpl<E> javolution.util.internal.collection.SharedCollectionImpl< E >.clone

(

)

Returns a copy of this collection; updates of the copy should not impact the original.

Reimplemented from javolution.util.internal.collection.CollectionView< E >.

Definition at line 100 of file SharedCollectionImpl.java.

                                           {
        lock.readLock.lock();
        try {
            SharedCollectionImpl<E> copy = (SharedCollectionImpl<E>) super
                    .clone();
            copy.lock = new ReadWriteLockImpl(); // No need to share the same lock.
            return copy;
        } finally {
            lock.readLock.unlock();
        }
    }

References javolution.util.internal.collection.ReadWriteLockImpl.ReadLock.lock(), javolution.util.internal.collection.SharedCollectionImpl< E >.lock, javolution.util.internal.collection.ReadWriteLockImpl.readLock, and javolution.util.internal.collection.ReadWriteLockImpl.ReadLock.unlock().

Here is the call graph for this function:

cloneTarget()

CollectionService<E> javolution.util.internal.collection.SharedCollectionImpl< E >.cloneTarget ( )

protected

Returns a clone copy of target.

Definition at line 266 of file SharedCollectionImpl.java.

                                                 {
        try {
            return target().clone();
        } catch (CloneNotSupportedException e) {
            throw new Error("Cannot happen since target is Cloneable.");
        }
    }

References javolution.util.internal.collection.CollectionView< E >.target.

Referenced by javolution.util.internal.collection.SharedCollectionImpl< E >.IteratorImpl.IteratorImpl().

Here is the caller graph for this function:

comparator()

Equality<? super E> javolution.util.internal.collection.SharedCollectionImpl< E >.comparator

(

)

Returns the comparator uses by this collection for equality and/or ordering if this collection is sorted.

Reimplemented from javolution.util.internal.collection.CollectionView< E >.

Definition at line 113 of file SharedCollectionImpl.java.

                                            {
        return target().comparator();
    }

References javolution.util.internal.collection.CollectionView< E >.target.

contains()

boolean javolution.util.internal.collection.SharedCollectionImpl< E >.contains

(

Object

searched

)

Indicates if this collection contains the specified element.

Reimplemented from javolution.util.internal.collection.CollectionView< E >.

Definition at line 118 of file SharedCollectionImpl.java.

                                      {
        lock.readLock.lock();
        try {
            return target().contains(o);
        } finally {
            lock.readLock.unlock();
        }
    }

References javolution.util.internal.collection.ReadWriteLockImpl.ReadLock.lock(), javolution.util.internal.collection.SharedCollectionImpl< E >.lock, javolution.util.internal.collection.ReadWriteLockImpl.readLock, javolution.util.internal.collection.CollectionView< E >.target, and javolution.util.internal.collection.ReadWriteLockImpl.ReadLock.unlock().

Here is the call graph for this function:

containsAll()

boolean javolution.util.internal.collection.SharedCollectionImpl< E >.containsAll

(

Collection<?>

that

)

Indicates if this collection contains all the specified elements.

Reimplemented from javolution.util.internal.collection.CollectionView< E >.

Definition at line 128 of file SharedCollectionImpl.java.

                                                {
        lock.readLock.lock();
        try {
            return target().containsAll(c);
        } finally {
            lock.readLock.unlock();
        }
    }

References javolution.util.internal.collection.ReadWriteLockImpl.ReadLock.lock(), javolution.util.internal.collection.SharedCollectionImpl< E >.lock, javolution.util.internal.collection.ReadWriteLockImpl.readLock, javolution.util.internal.collection.CollectionView< E >.target, and javolution.util.internal.collection.ReadWriteLockImpl.ReadLock.unlock().

Here is the call graph for this function:

distinct()

FastCollection<E> javolution.util.FastCollection< E >.distinct ( )

inherited

Returns a view exposing only distinct elements (it does not iterate twice over the same elements). Adding elements already in the collection through this view has no effect. If this collection is initially empty, using a distinct view to add new elements ensures that this collection has no duplicate.

Definition at line 293 of file FastCollection.java.

                                        {
        return new DistinctCollectionImpl<E>(service());
    }

equals()

boolean javolution.util.internal.collection.SharedCollectionImpl< E >.equals

(

Object

obj

)

Compares the specified object with this collection for equality. This method follows the Collection#equals(Object) specification if this collection comparator is Equalities#STANDARD (default). Otherwise, only collections using the same comparator can be considered equals.

Parameters

obj	the object to be compared for equality with this collection

Returns

true if both collections are considered equals; false otherwise.

Reimplemented from javolution.util.internal.collection.CollectionView< E >.

Definition at line 138 of file SharedCollectionImpl.java.

                                    {
        lock.readLock.lock();
        try {
            return target().equals(o);
        } finally {
            lock.readLock.unlock();
        }
    }

References javolution.util.internal.collection.ReadWriteLockImpl.ReadLock.lock(), javolution.util.internal.collection.SharedCollectionImpl< E >.lock, javolution.util.internal.collection.ReadWriteLockImpl.readLock, javolution.util.internal.collection.CollectionView< E >.target, and javolution.util.internal.collection.ReadWriteLockImpl.ReadLock.unlock().

Here is the call graph for this function:

filtered()

FastCollection<E> javolution.util.FastCollection< E >.filtered ( Predicate<? super E >  filter )

inherited

Returns a view exposing only the elements matching the specified filter. Adding elements not matching the specified filter has no effect. If this collection is initially empty, using a filtered view to add new elements ensure that this collection has only elements satisfying the filter predicate.

Reimplemented in javolution.util.FastSet< E >.

Definition at line 250 of file FastCollection.java.

                                                                   {
        return new FilteredCollectionImpl<E>(service(), filter);
    }

forEach()

void javolution.util.FastCollection< E >.forEach ( final Consumer<? super E >  consumer )

inherited

Iterates over all this collection elements applying the specified consumer (convenience method). Iterations are performed concurrently if the collection is parallel.

Parameters

consumer

the functional consumer applied to the collection elements.

Definition at line 346 of file FastCollection.java.

                                                            {
        perform(new Consumer<Collection<E>>() {
            public void accept(Collection<E> view) {
                Iterator<E> it = view.iterator();
                while (it.hasNext()) {
                    consumer.accept(it.next());
                }
            }
        });
    }

References javolution.util.function.Consumer< T >.accept().

Here is the call graph for this function:

hashCode()

int javolution.util.internal.collection.SharedCollectionImpl< E >.hashCode

(

)

Returns the hash code of this collection. This method follows the Collection#hashCode() specification if this collection comparator is Equalities#STANDARD.

Returns

this collection hash code.

Reimplemented from javolution.util.internal.collection.CollectionView< E >.

Definition at line 148 of file SharedCollectionImpl.java.

                          {
        lock.readLock.lock();
        try {
            return target().hashCode();
        } finally {
            lock.readLock.unlock();
        }
    }

References javolution.util.internal.collection.ReadWriteLockImpl.ReadLock.lock(), javolution.util.internal.collection.SharedCollectionImpl< E >.lock, javolution.util.internal.collection.ReadWriteLockImpl.readLock, javolution.util.internal.collection.CollectionView< E >.target, and javolution.util.internal.collection.ReadWriteLockImpl.ReadLock.unlock().

Here is the call graph for this function:

isEmpty()

boolean javolution.util.internal.collection.SharedCollectionImpl< E >.isEmpty

(

)

Indicates if this collection is empty.

Reimplemented from javolution.util.internal.collection.CollectionView< E >.

Definition at line 158 of file SharedCollectionImpl.java.

                             {
        lock.readLock.lock();
        try {
            return target().isEmpty();
        } finally {
            lock.readLock.unlock();
        }
    }

References javolution.util.internal.collection.ReadWriteLockImpl.ReadLock.lock(), javolution.util.internal.collection.SharedCollectionImpl< E >.lock, javolution.util.internal.collection.ReadWriteLockImpl.readLock, javolution.util.internal.collection.CollectionView< E >.target, and javolution.util.internal.collection.ReadWriteLockImpl.ReadLock.unlock().

Here is the call graph for this function:

iterator()

Iterator<E> javolution.util.internal.collection.SharedCollectionImpl< E >.iterator

(

)

Returns an iterator over this collection elements. For shared/atomic collections the iterator is immune to concurrent modifications. In other words the elements iterated over may or may not reflect the current state of the collection.

Reimplemented from javolution.util.internal.collection.CollectionView< E >.

Reimplemented in javolution.util.internal.table.SharedTableImpl< E >.

Definition at line 168 of file SharedCollectionImpl.java.

                                  {
        return new IteratorImpl();
    }

mapped()

public<R> FastCollection<R> javolution.util.FastCollection< E >.mapped ( Function<? super E, ? extends R >  function )

packageinherited

Returns a view exposing elements through the specified mapping function. The returned view does not allow new elements to be added.

Definition at line 258 of file FastCollection.java.

                                                       {
        return new MappedCollectionImpl<E, R>(service(), function);
    }

Referenced by javolution.xml.internal.stream.EntitiesImpl.setEntitiesMapping().

Here is the caller graph for this function:

max()

E javolution.util.FastCollection< E >.max ( )

inherited

Returns the largest element of this collection using this collection comparator (convenience method). Returns

null 

if this collection is empty.

Returns

reduce(Reducers.max(comparator())) 

See also

Reducers::max

Definition at line 541 of file FastCollection.java.

                   {
        return reduce(Reducers.max(comparator()));
    }

References javolution.util.function.Reducers.max().

Here is the call graph for this function:

min()

E javolution.util.FastCollection< E >.min ( )

inherited

Returns the smallest element of this collection using this collection comparator (convenience method). Returns

null 

if this collection is empty.

Returns

reduce(Reducers.min(comparator())) 

See also

Reducers::min

Definition at line 528 of file FastCollection.java.

                   {
        return reduce(Reducers.min(comparator()));
    }

References javolution.util.function.Reducers.min().

Here is the call graph for this function:

parallel()

FastCollection<E> javolution.util.FastCollection< E >.parallel ( )

inherited

Returns a parallel collection. Parallel collections affect only closure-based operations, all others operations behaving the same. Parallel actions are performed concurrently using Javolution ConcurrentContext. The number of parallel views is derived from the context concurrency (

number of parallel views = concurrency + 1 

). Parallel views do not require this collection to be thread-safe (internal synchronization).

See also

#perform(Consumer)

#update(Consumer)

#forEach(Consumer)

#removeIf(Predicate)

#reduce(Reducer)

Definition at line 222 of file FastCollection.java.

                                        {
        return new ParallelCollectionImpl<E>(service());
    }

perform() [1/3]

void javolution.util.internal.collection.SharedCollectionImpl< E >.perform	(	Consumer< CollectionService< E >>	action,
		CollectionService< E >	view
	)

Reimplemented from javolution.util.internal.collection.CollectionView< E >.

Definition at line 173 of file SharedCollectionImpl.java.

                                       {
        lock.readLock.lock();
        try {
            target().perform(action, view);
        } finally {
            lock.readLock.unlock();
        }
    }

References javolution.util.internal.collection.ReadWriteLockImpl.ReadLock.lock(), javolution.util.internal.collection.SharedCollectionImpl< E >.lock, javolution.util.internal.collection.ReadWriteLockImpl.readLock, javolution.util.internal.collection.CollectionView< E >.target, and javolution.util.internal.collection.ReadWriteLockImpl.ReadLock.unlock().

Here is the call graph for this function:

perform() [2/3]

void javolution.util.function.Splittable< T >.perform ( Consumer< T >  action, T  part  )

inherited

Executes a read-only action on the specified part of this object.

Parameters

action	the read-only action.
part	this object or a part of it.

Exceptions

UnsupportedOperationException

if the action tries to update the specified part.

perform() [3/3]

void javolution.util.FastCollection< E >.perform ( Consumer<? extends Collection< E >>  action )

inherited

Executes the specified read-only action on this collection. That logic may be performed concurrently on sub-collections if this collection is parallel.

Parameters

action

the read-only action.

Exceptions

UnsupportedOperationException	if the action tries to update this collection and this collection is thread-safe.
ClassCastException	if the action type is not compatible with this collection (e.g. action on set and this is a list).

See also

#update(Consumer)

Definition at line 315 of file FastCollection.java.

                                                                  {
        service().perform((Consumer<CollectionService<E>>) action, service());
    }

reduce()

E javolution.util.FastCollection< E >.reduce ( Reducer< E >  reducer )

inherited

Performs a reduction of the elements of this collection using the specified reducer. This may not involve iterating over all the collection elements, for example the reducers: Reducers#any, Reducers#and and Reducers#or may stop iterating early. Reduction is performed concurrently if this collection is parallel.

Parameters

reducer

the collection reducer.

Returns

the reduction result.

Definition at line 396 of file FastCollection.java.

                                        {
        perform(reducer);
        return reducer.get();
    }

remove()

boolean javolution.util.internal.collection.SharedCollectionImpl< E >.remove

(

Object

searched

)

Removes the specified element from this collection.

Reimplemented from javolution.util.internal.collection.CollectionView< E >.

Definition at line 184 of file SharedCollectionImpl.java.

                                    {
        lock.writeLock.lock();
        try {
            return target().remove(o);
        } finally {
            lock.writeLock.unlock();
        }
    }

References javolution.util.internal.collection.SharedCollectionImpl< E >.lock, javolution.util.internal.collection.ReadWriteLockImpl.WriteLock.lock(), javolution.util.internal.collection.CollectionView< E >.target, javolution.util.internal.collection.ReadWriteLockImpl.WriteLock.unlock(), and javolution.util.internal.collection.ReadWriteLockImpl.writeLock.

Referenced by javolution.util.internal.collection.SharedCollectionImpl< E >.IteratorImpl.remove().

Here is the call graph for this function:

Here is the caller graph for this function:

removeAll()

boolean javolution.util.internal.collection.SharedCollectionImpl< E >.removeAll

(

Collection<?>

that

)

Removes all the specified element from this collection.

Reimplemented from javolution.util.internal.collection.CollectionView< E >.

Definition at line 194 of file SharedCollectionImpl.java.

                                              {
        lock.writeLock.lock();
        try {
            return target().removeAll(c);
        } finally {
            lock.writeLock.unlock();
        }
    }

References javolution.util.internal.collection.SharedCollectionImpl< E >.lock, javolution.util.internal.collection.ReadWriteLockImpl.WriteLock.lock(), javolution.util.internal.collection.CollectionView< E >.target, javolution.util.internal.collection.ReadWriteLockImpl.WriteLock.unlock(), and javolution.util.internal.collection.ReadWriteLockImpl.writeLock.

Here is the call graph for this function:

removeIf()

boolean javolution.util.FastCollection< E >.removeIf ( final Predicate<? super E >  filter )

inherited

Removes from this collection all the elements matching the specified functional predicate (convenience method). Removals are performed concurrently if this collection is parallel and atomically if this collection is atomic.

Parameters

filter

a predicate returning true for elements to be removed.

Returns

true 

if at least one element has been removed;

false 

otherwise.

Definition at line 368 of file FastCollection.java.

                                                               {
        final boolean[] removed = new boolean[1];
        update(new Consumer<Collection<E>>() {
            public void accept(Collection<E> view) {
                Iterator<E> it = view.iterator();
                while (it.hasNext()) {
                    if (filter.test(it.next())) {
                        it.remove(); // Ok mutable iteration.
                        removed[0] = true;
                    }
                }
            }
        });
        return removed[0];
    }

retainAll()

boolean javolution.util.internal.collection.SharedCollectionImpl< E >.retainAll

(

Collection<?>

that

)

Removes all the elements except those in the specified collection.

Reimplemented from javolution.util.internal.collection.CollectionView< E >.

Definition at line 204 of file SharedCollectionImpl.java.

                                              {
        lock.writeLock.lock();
        try {
            return target().retainAll(c);
        } finally {
            lock.writeLock.unlock();
        }
    }

References javolution.util.internal.collection.SharedCollectionImpl< E >.lock, javolution.util.internal.collection.ReadWriteLockImpl.WriteLock.lock(), javolution.util.internal.collection.CollectionView< E >.target, javolution.util.internal.collection.ReadWriteLockImpl.WriteLock.unlock(), and javolution.util.internal.collection.ReadWriteLockImpl.writeLock.

Here is the call graph for this function:

reversed()

FastCollection<E> javolution.util.FastCollection< E >.reversed ( )

inherited

Returns a view exposing elements in reverse iterative order.

Reimplemented in javolution.util.FastTable< E >.

Definition at line 282 of file FastCollection.java.

                                        {
        return new ReversedCollectionImpl<E>(service());
    }

sequential()

FastCollection<E> javolution.util.FastCollection< E >.sequential ( )

inherited

Returns a sequential view of this collection. Using this view, all closure-based iterations are performed sequentially.

Definition at line 230 of file FastCollection.java.

                                          {
        return new SequentialCollectionImpl<E>(service());
    }

service()

CollectionService<E> javolution.util.internal.collection.CollectionView< E >.service ( )

protectedinherited

Returns the service implementation of this collection (for sub-classes).

Reimplemented from javolution.util.FastCollection< E >.

Definition at line 274 of file CollectionView.java.

                                             {
        return this;
    }

serviceOf()

static <E> CollectionService<E> javolution.util.FastCollection< E >.serviceOf ( FastCollection< E >  collection )

staticprotectedinherited

Returns the service implementation of any fast collection (for sub-classes).

Definition at line 647 of file FastCollection.java.

                                          {
        return collection.service();
    }

References javolution.util.FastCollection< E >.service().

Here is the call graph for this function:

shared()

FastCollection<E> javolution.util.FastCollection< E >.shared ( )

inherited

Returns a thread-safe view over this collection. The shared view allows for concurrent read as long as there is no writer. The default implementation is based on readers-writers locks giving priority to writers. Iterators on shared collections are thread-safe (no ConcurrentModificationException possible).

Reimplemented in javolution.util.FastTable< E >, javolution.util.FastSet< E >, javolution.util.FastSortedTable< E >, and javolution.util.FastSortedSet< E >.

Definition at line 201 of file FastCollection.java.

                                      {
        return new SharedCollectionImpl<E>(service());
    }

size()

int javolution.util.internal.collection.SharedCollectionImpl< E >.size

(

)

Returns the size of this collection.

Reimplemented from javolution.util.internal.collection.CollectionView< E >.

Definition at line 214 of file SharedCollectionImpl.java.

                      {
        lock.readLock.lock();
        try {
            return target().size();
        } finally {
            lock.readLock.unlock();
        }
    }

References javolution.util.internal.collection.ReadWriteLockImpl.ReadLock.lock(), javolution.util.internal.collection.SharedCollectionImpl< E >.lock, javolution.util.internal.collection.ReadWriteLockImpl.readLock, javolution.util.internal.collection.CollectionView< E >.target, and javolution.util.internal.collection.ReadWriteLockImpl.ReadLock.unlock().

Here is the call graph for this function:

sorted() [1/2]

FastCollection<E> javolution.util.FastCollection< E >.sorted ( )

inherited

Returns a view exposing elements sorted according to the collection order.

Definition at line 267 of file FastCollection.java.

                                      {
        return new SortedCollectionImpl<E>(service(), comparator());
    }

Referenced by javolution.util.internal.collection.SortedCollectionImpl< E >.IteratorImpl.IteratorImpl().

Here is the caller graph for this function:

sorted() [2/2]

FastCollection<E> javolution.util.FastCollection< E >.sorted ( Comparator<? super E >  cmp )

inherited

Returns a view exposing elements sorted according to the specified comparator.

Definition at line 275 of file FastCollection.java.

                                                               {
        return new SortedCollectionImpl<E>(service(), cmp);
    }

split()

CollectionService<E> [] javolution.util.internal.collection.SharedCollectionImpl< E >.split

(

int

n

)

Returns

n 

distinct parts of this object. This method may return an array of size less than

n 

(e.g. an array of size one if this object cannot split).

Parameters

n	the number of parts.

Returns

the distinct parts (or views) for this object.

Exceptions

IllegalArgumentException

if n <= 1

Reimplemented from javolution.util.internal.collection.CollectionView< E >.

Reimplemented in javolution.util.internal.table.SharedTableImpl< E >.

Definition at line 225 of file SharedCollectionImpl.java.

                                               { // Shares the same locks.
        CollectionService<E>[] tmp;
        lock.readLock.lock();
        try {
            tmp = target().split(n);
        } finally {
            lock.readLock.unlock();
        }
        CollectionService<E>[] result = new CollectionService[tmp.length];
        for (int i = 0; i < tmp.length; i++) {
            result[i] = new SharedCollectionImpl<E>(tmp[i], lock);
        }
        return result;
    }

References javolution.util.internal.collection.ReadWriteLockImpl.ReadLock.lock(), javolution.util.internal.collection.SharedCollectionImpl< E >.lock, javolution.util.internal.collection.ReadWriteLockImpl.readLock, javolution.util.internal.collection.CollectionView< E >.target, and javolution.util.internal.collection.ReadWriteLockImpl.ReadLock.unlock().

Here is the call graph for this function:

target()

CollectionService<E> javolution.util.internal.collection.CollectionView< E >.target ( )

protectedinherited

Returns the actual target

Reimplemented in javolution.util.internal.table.SharedTableImpl< E >, javolution.util.internal.table.TableView< E >, javolution.util.internal.table.AtomicTableImpl< E >, javolution.util.internal.set.sorted.SharedSortedSetImpl< E >, javolution.util.internal.table.sorted.SortedTableView< E >, javolution.util.internal.set.sorted.UnmodifiableSortedSetImpl< E >, javolution.util.internal.set.sorted.SortedSetView< E >, javolution.util.internal.table.sorted.SharedSortedTableImpl< E >, javolution.util.internal.table.sorted.AtomicSortedTableImpl< E >, javolution.util.internal.set.SetView< E >, and javolution.util.internal.table.sorted.UnmodifiableSortedTableImpl< E >.

Definition at line 279 of file CollectionView.java.

                                            {
        return target;
    }

threadSafe()

CollectionService<E> javolution.util.internal.collection.SharedCollectionImpl< E >.threadSafe

(

)

Returns a thread-safe version of this service (used during parallel updates).

Reimplemented from javolution.util.internal.collection.CollectionView< E >.

Reimplemented in javolution.util.internal.table.SharedTableImpl< E >, javolution.util.internal.set.sorted.SharedSortedSetImpl< E >, javolution.util.internal.table.sorted.SharedSortedTableImpl< E >, and javolution.util.internal.set.SharedSetImpl< E >.

Definition at line 241 of file SharedCollectionImpl.java.

                                             {
        return this;
    }

toArray() [1/2]

Object [] javolution.util.internal.collection.SharedCollectionImpl< E >.toArray

(

)

Returns an array holding this collection elements.

Reimplemented from javolution.util.internal.collection.CollectionView< E >.

Definition at line 246 of file SharedCollectionImpl.java.

                              {
        lock.readLock.lock();
        try {
            return target().toArray();
        } finally {
            lock.readLock.unlock();
        }
    }

References javolution.util.internal.collection.ReadWriteLockImpl.ReadLock.lock(), javolution.util.internal.collection.SharedCollectionImpl< E >.lock, javolution.util.internal.collection.ReadWriteLockImpl.readLock, javolution.util.internal.collection.CollectionView< E >.target, and javolution.util.internal.collection.ReadWriteLockImpl.ReadLock.unlock().

Here is the call graph for this function:

toArray() [2/2]

public<T> T [] javolution.util.internal.collection.SharedCollectionImpl< E >.toArray ( T[]  array )

package

Returns the specified array holding this collection elements if enough capacity.

Reimplemented from javolution.util.internal.collection.CollectionView< E >.

Definition at line 256 of file SharedCollectionImpl.java.

                                  {
        lock.readLock.lock();
        try {
            return target().toArray(a);
        } finally {
            lock.readLock.unlock();
        }
    }

References javolution.util.internal.collection.ReadWriteLockImpl.ReadLock.lock(), javolution.util.internal.collection.SharedCollectionImpl< E >.lock, javolution.util.internal.collection.ReadWriteLockImpl.readLock, javolution.util.internal.collection.CollectionView< E >.target, and javolution.util.internal.collection.ReadWriteLockImpl.ReadLock.unlock().

Here is the call graph for this function:

toImmutable()

public<T extends Collection<E> > Immutable<T> javolution.util.FastCollection< E >.toImmutable ( )

packageinherited

Returns an immutable reference over this collection. The immutable value is an unmodifiable view of this collection. The caller must guarantees that the original collection is never going to be updated (e.g. there is no reference left of the original collection).

Definition at line 585 of file FastCollection.java.

                                                                {
        return new Immutable<T>() {
            @SuppressWarnings("unchecked")
            final T value = (T) unmodifiable();
 
            @Override
            public T value() {
                return value;
            }
 
        };
    }

toString()

String javolution.util.FastCollection< E >.toString ( )

inherited

Returns the string representation of this collection using its default format.

Definition at line 634 of file FastCollection.java.

                             {
        return TextContext.getFormat(FastCollection.class).format(this);
    }

References javolution.text.TextContext.getFormat().

Here is the call graph for this function:

unmodifiable()

FastCollection<E> javolution.util.FastCollection< E >.unmodifiable ( )

inherited

Returns an unmodifiable view over this collection. Any attempt to modify the collection through this view will result into a java.lang.UnsupportedOperationException being raised.

Reimplemented in javolution.util.FastTable< E >, javolution.util.FastSet< E >, javolution.util.FastSortedTable< E >, and javolution.util.FastSortedSet< E >.

Definition at line 239 of file FastCollection.java.

                                            {
        return new UnmodifiableCollectionImpl<E>(service());
    }

update() [1/3]

void javolution.util.internal.collection.CollectionView< E >.update ( Consumer< CollectionService< E >>  action, CollectionService< E >  view  )

inherited

Reimplemented in javolution.util.internal.collection.ParallelCollectionImpl< E >, javolution.util.internal.collection.AtomicCollectionImpl< E >, and javolution.util.internal.collection.SequentialCollectionImpl< E >.

Definition at line 266 of file CollectionView.java.

                                                                                         {
        if (target == null) {
            action.accept(view);
        } else {
            target.perform(action, view);
        }
    }

update() [2/3]

void javolution.util.function.Splittable< T >.update ( Consumer< T >  action, T  part  )

inherited

Executes an update action on the specified part of this object. Any change to the part is reflected in the whole (this object).

Parameters

action	the action authorized to update this object part.
part	this object or a part of it.

update() [3/3]

void javolution.util.FastCollection< E >.update ( Consumer<? extends Collection< E >>  action )

inherited

Executes the specified update action on this collection. That logic may be performed concurrently on sub-collections if this collection is parallel. For atomic collections the update is atomic (either concurrent readers see the full result of the action or nothing).

Parameters

action

the update action.

Exceptions

ClassCastException

if the action type is not compatible with this collection (e.g. action on set and this is a list).

See also

#perform(Consumer)

Definition at line 334 of file FastCollection.java.

                                                                 {
        service().update((Consumer<CollectionService<E>>) action, service());
    }

Referenced by javolution.util.FastTable< javolution.xml.internal.stream.XMLStreamReaderImpl >.sort().

Here is the caller graph for this function:

Member Data Documentation

lock

ReadWriteLockImpl javolution.util.internal.collection.SharedCollectionImpl< E >.lock

protected

Definition at line 57 of file SharedCollectionImpl.java.

Referenced by javolution.util.internal.table.SharedTableImpl< E >.add(), javolution.util.internal.collection.SharedCollectionImpl< E >.add(), javolution.util.internal.table.SharedTableImpl< E >.addAll(), javolution.util.internal.collection.SharedCollectionImpl< E >.addAll(), javolution.util.internal.table.SharedTableImpl< E >.addFirst(), javolution.util.internal.table.sorted.SharedSortedTableImpl< E >.addIfAbsent(), javolution.util.internal.table.SharedTableImpl< E >.addLast(), javolution.util.internal.collection.SharedCollectionImpl< E >.clear(), javolution.util.internal.collection.SharedCollectionImpl< E >.clone(), javolution.util.internal.collection.SharedCollectionImpl< E >.contains(), javolution.util.internal.collection.SharedCollectionImpl< E >.containsAll(), javolution.util.internal.collection.SharedCollectionImpl< E >.equals(), javolution.util.internal.set.sorted.SharedSortedSetImpl< E >.first(), javolution.util.internal.table.SharedTableImpl< E >.get(), javolution.util.internal.table.SharedTableImpl< E >.getFirst(), javolution.util.internal.table.SharedTableImpl< E >.getLast(), javolution.util.internal.collection.SharedCollectionImpl< E >.hashCode(), javolution.util.internal.table.SharedTableImpl< E >.indexOf(), javolution.util.internal.collection.SharedCollectionImpl< E >.isEmpty(), javolution.util.internal.collection.SharedCollectionImpl< E >.IteratorImpl.IteratorImpl(), javolution.util.internal.set.sorted.SharedSortedSetImpl< E >.last(), javolution.util.internal.table.SharedTableImpl< E >.lastIndexOf(), javolution.util.internal.table.SharedTableImpl< E >.offerFirst(), javolution.util.internal.table.SharedTableImpl< E >.offerLast(), javolution.util.internal.table.SharedTableImpl< E >.peekFirst(), javolution.util.internal.table.SharedTableImpl< E >.peekLast(), javolution.util.internal.collection.SharedCollectionImpl< E >.perform(), javolution.util.internal.table.SharedTableImpl< E >.pollFirst(), javolution.util.internal.table.SharedTableImpl< E >.pollLast(), javolution.util.internal.table.sorted.SharedSortedTableImpl< E >.positionOf(), javolution.util.internal.collection.SharedCollectionImpl< E >.remove(), javolution.util.internal.table.SharedTableImpl< E >.remove(), javolution.util.internal.collection.SharedCollectionImpl< E >.removeAll(), javolution.util.internal.table.SharedTableImpl< E >.removeFirst(), javolution.util.internal.table.SharedTableImpl< E >.removeFirstOccurrence(), javolution.util.internal.table.SharedTableImpl< E >.removeLast(), javolution.util.internal.table.SharedTableImpl< E >.removeLastOccurrence(), javolution.util.internal.collection.SharedCollectionImpl< E >.retainAll(), javolution.util.internal.table.SharedTableImpl< E >.set(), javolution.util.internal.collection.SharedCollectionImpl< E >.SharedCollectionImpl(), javolution.util.internal.collection.SharedCollectionImpl< E >.size(), javolution.util.internal.collection.SharedCollectionImpl< E >.split(), and javolution.util.internal.collection.SharedCollectionImpl< E >.toArray().

serialVersionUID

final long javolution.util.internal.collection.SharedCollectionImpl< E >.serialVersionUID = 0x600L

staticprivate

Definition at line 56 of file SharedCollectionImpl.java.

target

CollectionService<E> javolution.util.internal.collection.CollectionView< E >.target

privateinherited

Reimplemented in javolution.util.internal.table.SharedTableImpl< E >, javolution.util.internal.table.TableView< E >, javolution.util.internal.table.AtomicTableImpl< E >, javolution.util.internal.set.sorted.SharedSortedSetImpl< E >, javolution.util.internal.table.sorted.SortedTableView< E >, javolution.util.internal.set.sorted.UnmodifiableSortedSetImpl< E >, javolution.util.internal.set.sorted.SortedSetView< E >, javolution.util.internal.table.sorted.SharedSortedTableImpl< E >, javolution.util.internal.table.sorted.AtomicSortedTableImpl< E >, javolution.util.internal.set.SetView< E >, and javolution.util.internal.table.sorted.UnmodifiableSortedTableImpl< E >.

Definition at line 33 of file CollectionView.java.

Referenced by javolution.util.internal.collection.SequentialCollectionImpl< E >.add(), javolution.util.internal.collection.ParallelCollectionImpl< E >.add(), javolution.util.internal.collection.ReversedCollectionImpl< E >.add(), javolution.util.internal.collection.AtomicCollectionImpl< E >.add(), javolution.util.internal.collection.DistinctCollectionImpl< E >.add(), javolution.util.internal.collection.SortedCollectionImpl< E >.add(), javolution.util.internal.collection.SharedCollectionImpl< E >.add(), javolution.util.internal.collection.FilteredCollectionImpl< E >.add(), javolution.util.internal.collection.AtomicCollectionImpl< E >.addAll(), javolution.util.internal.collection.SharedCollectionImpl< E >.addAll(), javolution.util.internal.collection.AtomicCollectionImpl< E >.AtomicCollectionImpl(), javolution.util.internal.set.AtomicSetImpl< E >.AtomicSetImpl(), javolution.util.internal.set.sorted.AtomicSortedSetImpl< E >.AtomicSortedSetImpl(), javolution.util.internal.collection.SequentialCollectionImpl< E >.clear(), javolution.util.internal.collection.ParallelCollectionImpl< E >.clear(), javolution.util.internal.collection.ReversedCollectionImpl< E >.clear(), javolution.util.internal.collection.DistinctCollectionImpl< E >.clear(), javolution.util.internal.collection.SortedCollectionImpl< E >.clear(), javolution.util.internal.collection.SharedCollectionImpl< E >.clear(), javolution.util.internal.collection.CollectionView< R >.clone(), javolution.util.internal.collection.AtomicCollectionImpl< E >.cloneTarget(), javolution.util.internal.collection.SharedCollectionImpl< E >.cloneTarget(), javolution.util.internal.collection.CollectionView< R >.CollectionView(), javolution.util.internal.collection.SequentialCollectionImpl< E >.comparator(), javolution.util.internal.collection.ParallelCollectionImpl< E >.comparator(), javolution.util.internal.collection.UnmodifiableCollectionImpl< E >.comparator(), javolution.util.internal.collection.ReversedCollectionImpl< E >.comparator(), javolution.util.internal.collection.DistinctCollectionImpl< E >.comparator(), javolution.util.internal.collection.FilteredCollectionImpl< E >.comparator(), javolution.util.internal.collection.SharedCollectionImpl< E >.comparator(), javolution.util.internal.collection.SequentialCollectionImpl< E >.contains(), javolution.util.internal.collection.ParallelCollectionImpl< E >.contains(), javolution.util.internal.collection.UnmodifiableCollectionImpl< E >.contains(), javolution.util.internal.collection.ReversedCollectionImpl< E >.contains(), javolution.util.internal.collection.DistinctCollectionImpl< E >.contains(), javolution.util.internal.collection.FilteredCollectionImpl< E >.contains(), javolution.util.internal.collection.SortedCollectionImpl< E >.contains(), javolution.util.internal.collection.SharedCollectionImpl< E >.contains(), javolution.util.internal.collection.SharedCollectionImpl< E >.containsAll(), javolution.util.internal.collection.DistinctCollectionImpl< E >.DistinctCollectionImpl(), javolution.util.internal.collection.SharedCollectionImpl< E >.equals(), javolution.util.internal.collection.FilteredCollectionImpl< E >.FilteredCollectionImpl(), javolution.util.internal.set.FilteredSetImpl< E >.FilteredSetImpl(), javolution.util.internal.collection.SharedCollectionImpl< E >.hashCode(), javolution.util.internal.collection.SequentialCollectionImpl< E >.isEmpty(), javolution.util.internal.collection.ParallelCollectionImpl< E >.isEmpty(), javolution.util.internal.collection.UnmodifiableCollectionImpl< E >.isEmpty(), javolution.util.internal.collection.ReversedCollectionImpl< E >.isEmpty(), javolution.util.internal.collection.DistinctCollectionImpl< E >.isEmpty(), javolution.util.internal.collection.SortedCollectionImpl< E >.isEmpty(), javolution.util.internal.collection.SharedCollectionImpl< E >.isEmpty(), javolution.util.internal.collection.SequentialCollectionImpl< E >.iterator(), javolution.util.internal.collection.ParallelCollectionImpl< E >.iterator(), javolution.util.internal.collection.ReversedCollectionImpl< E >.IteratorImpl.IteratorImpl(), javolution.util.internal.collection.SortedCollectionImpl< E >.IteratorImpl.IteratorImpl(), javolution.util.internal.collection.FilteredCollectionImpl< E >.IteratorImpl.IteratorImpl(), javolution.util.internal.collection.ParallelCollectionImpl< E >.ParallelCollectionImpl(), javolution.util.internal.collection.ParallelCollectionImpl< E >.perform(), javolution.util.internal.collection.CollectionView< R >.perform(), javolution.util.internal.collection.SharedCollectionImpl< E >.perform(), javolution.util.internal.collection.ReversedCollectionImpl< E >.IteratorImpl.remove(), javolution.util.internal.collection.SortedCollectionImpl< E >.IteratorImpl.remove(), javolution.util.internal.collection.SequentialCollectionImpl< E >.remove(), javolution.util.internal.collection.ParallelCollectionImpl< E >.remove(), javolution.util.internal.collection.ReversedCollectionImpl< E >.remove(), javolution.util.internal.collection.FilteredCollectionImpl< E >.remove(), javolution.util.internal.collection.SortedCollectionImpl< E >.remove(), javolution.util.internal.collection.AtomicCollectionImpl< E >.remove(), javolution.util.internal.collection.SharedCollectionImpl< E >.remove(), javolution.util.internal.collection.AtomicCollectionImpl< E >.removeAll(), javolution.util.internal.collection.SharedCollectionImpl< E >.removeAll(), javolution.util.internal.collection.AtomicCollectionImpl< E >.retainAll(), javolution.util.internal.collection.SharedCollectionImpl< E >.retainAll(), javolution.util.internal.collection.ReversedCollectionImpl< E >.ReversedCollectionImpl(), javolution.util.internal.collection.SequentialCollectionImpl< E >.SequentialCollectionImpl(), javolution.util.internal.collection.SharedCollectionImpl< E >.SharedCollectionImpl(), javolution.util.internal.set.SharedSetImpl< E >.SharedSetImpl(), javolution.util.internal.collection.SequentialCollectionImpl< E >.size(), javolution.util.internal.collection.UnmodifiableCollectionImpl< E >.size(), javolution.util.internal.collection.ParallelCollectionImpl< E >.size(), javolution.util.internal.collection.ReversedCollectionImpl< E >.size(), javolution.util.internal.collection.SortedCollectionImpl< E >.size(), javolution.util.internal.collection.SharedCollectionImpl< E >.size(), javolution.util.internal.collection.SortedCollectionImpl< E >.SortedCollectionImpl(), javolution.util.internal.collection.CollectionView< R >.split(), javolution.util.internal.collection.SharedCollectionImpl< E >.split(), javolution.util.internal.collection.CollectionView< R >.target(), javolution.util.internal.collection.AtomicCollectionImpl< E >.targetView(), javolution.util.internal.collection.SharedCollectionImpl< E >.toArray(), javolution.util.internal.collection.UnmodifiableCollectionImpl< E >.UnmodifiableCollectionImpl(), javolution.util.internal.set.UnmodifiableSetImpl< E >.UnmodifiableSetImpl(), javolution.util.internal.collection.ParallelCollectionImpl< E >.update(), javolution.util.internal.collection.AtomicCollectionImpl< E >.update(), and javolution.util.internal.collection.CollectionView< R >.update().

---

The documentation for this class was generated from the following file:

• SharedCollectionImpl.java