de.team33.patterns.collection.ceres

Class Collecting

java.lang.Object

de.team33.patterns.collection.ceres.Collecting

public final class Collecting
extends Object

Additional convenience methods to deal with Collections.

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static class	Collecting.Builder<E,C extends Collection<E>> Builder implementation to build target instances of Collection.
static class	Collecting.Charger<E,C extends Collection<E>> Charger implementation to charge target instances of Collection.
static interface	Collecting.Setup<E,C extends Collection<E>,S extends Collecting.Setup<E,C,S>> Utility interface to set up a target instance of Collection.

Method Summary

Modifier and Type	Method and Description
static <E,C extends Collection<E>> C	add(C subject, E element) Just like subject.add(element), but returns the subject.
static <E,C extends Collection<E>> C	add(C subject, E element0, E element1, E... more) Similar to add(Collection, Object), but allows to add two or more elements at once.
static <E,C extends Collection<E>> C	addAll(C subject, Collection<? extends E> elements) Just like subject.addAll(elements), but returns the subject.
static <E,C extends Collection<E>> C	addAll(C subject, E[] elements) Similar to addAll(Collection, Collection), but takes an array as second argument.
static <E,C extends Collection<E>> C	addAll(C subject, Iterable<? extends E> elements) Similar to addAll(Collection, Collection), but takes an Iterable as second argument.
static <E,C extends Collection<E>> C	addAll(C subject, Iterator<? extends E> elements) Similar to addAll(Collection, Collection), but takes an Iterator as second argument.
static <E,C extends Collection<E>> C	addAll(C subject, Stream<? extends E> elements) Similar to addAll(Collection, Collection), but takes a Stream as second argument.
static <E,C extends Collection<E>> Collecting.Builder<E,C>	builder(Supplier<C> newTarget) Returns a new Collecting.Builder for target instances as supplied by the given Supplier.
static <E,C extends Collection<E>> Collecting.Charger<E,C>	charger(C target) Returns a new Collecting.Charger for a given target instance.
static <C extends Collection<?>> C	clear(C subject) Just like subject.clear(), but returns the subject.
static boolean	contains(Collection<?> subject, Object element) Just like subject.contains(element).
static boolean	contains(Collection<?> subject, Object element0, Object element1, Object... more) Similar to contains(Collection, Object), but allows to test two or more elements.
static boolean	containsAll(Collection<?> subject, Collection<?> elements) Just like subject.containsAll(elements), but returns the subject.
static boolean	containsAll(Collection<?> subject, Iterable<?> elements) Similar to containsAll(Collection, Collection), but takes an Iterable as second argument.
static boolean	containsAll(Collection<?> subject, Iterator<?> elements) Similar to containsAll(Collection, Collection), but takes an Iterator as second argument.
static boolean	containsAll(Collection<?> subject, Object[] elements) Similar to containsAll(Collection, Collection), but takes an array as second argument.
static boolean	containsAll(Collection<?> subject, Stream<?> elements) Similar to containsAll(Collection, Collection), but takes a Stream as second argument.
static <E> Collection<E>	proxy(Collection<E> subject) Supplies a proxy for a given subject that may be used to implement some Collection-specific methods, e.g.: Collection.toArray() Collection.toArray(Object[]) Object.toString() ...
static <E> List<E>	proxy(List<E> subject) Supplies a proxy for a given subject that may be used to implement some List-specific methods, e.g.: List.toArray() List.toArray(Object[]) Object.toString() List.equals(Object) List.hashCode() ...
static <E> Set<E>	proxy(Set<E> subject) Supplies a proxy for a given subject that may be used to implement some Set-specific methods, e.g.: Set.toArray() Set.toArray(Object[]) Object.toString() Set.equals(Object) Set.hashCode() ...
static <C extends Collection<?>> C	remove(C subject, Object element) Similar to subject.remove(element), but returns the subject.
static <C extends Collection<?>> C	remove(C subject, Object element0, Object element1, Object... more) Similar to remove(Collection, Object), but allows to remove two or more elements.
static <C extends Collection<?>> C	removeAll(C subject, Collection<?> elements) Just like subject.removeAll(elements), but returns the subject.
static <C extends Collection<?>> C	removeAll(C subject, Iterable<?> elements) Similar to removeAll(Collection, Collection), but takes an Iterable as second argument.
static <C extends Collection<?>> C	removeAll(C subject, Iterator<?> elements) Similar to removeAll(Collection, Collection), but takes an Iterator as second argument.
static <C extends Collection<?>> C	removeAll(C subject, Object[] elements) Similar to removeAll(Collection, Collection), but takes an array as second argument.
static <C extends Collection<?>> C	removeAll(C subject, Stream<?> elements) Similar to removeAll(Collection, Collection), but takes a Stream as second argument.
static <E,C extends Collection<E>> C	removeIf(C subject, Predicate<? super E> filter) Just like subject.removeIf(filter), but returns the subject.
static <C extends Collection<?>> C	retainAll(C subject, Collection<?> elements) Just like subject.retainAll(elements), but returns the subject.
static <C extends Collection<?>> C	retainAll(C subject, Iterable<?> elements) Similar to retainAll(Collection, Collection), but takes an Iterable as second argument.
static <C extends Collection<?>> C	retainAll(C subject, Iterator<?> elements) Similar to retainAll(Collection, Collection), but takes an Iterator as second argument.
static <C extends Collection<?>> C	retainAll(C subject, Object[] elements) Similar to retainAll(Collection, Collection), but takes an array as second argument.
static <C extends Collection<?>> C	retainAll(C subject, Stream<?> elements) Similar to retainAll(Collection, Collection), but takes a Stream as second argument.

Methods inherited from class java.lang.Object

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

Method Detail

add

public static <E,C extends Collection<E>> C add(C subject,
                                                E element)

Just like subject.add(element), but returns the subject.

Throws:

UnsupportedOperationException - if Collection.add(Object) is not supported by the subject.

NullPointerException - if subject is null or ...

NullPointerException - if the specified element is null and the subject does not permit null elements.

ClassCastException - if the class of the specified element prevents it from being added to the subject (may occur only if used raw or forced in a mismatched class context).

IllegalArgumentException - if some property of the element prevents it from being added to the subject.

IllegalStateException - if the element cannot be added at this time due to the subject's insertion restrictions (if any).

See Also:

Collection.add(Object), add(Collection, Object, Object, Object[]), addAll(Collection, Collection), addAll(Collection, Iterable), addAll(Collection, Iterator), addAll(Collection, Stream), addAll(Collection, Object[])

add

@SafeVarargs
public static <E,C extends Collection<E>> C add(C subject,
                                                             E element0,
                                                             E element1,
                                                             E... more)

Similar to add(Collection, Object), but allows to add two or more elements at once.

Throws:

UnsupportedOperationException - if Collection.add(Object) is not supported by the subject.

NullPointerException - if subject is null or ...

NullPointerException - if the array of more elements is null or ...

NullPointerException - if any of the specified elements is null and the subject does not permit null elements.

ClassCastException - if the class of the specified elements prevents them from being added to the subject (may occur only if used raw or forced in a mismatched class context).

IllegalArgumentException - if some property of some elements prevents them from being added to the subject.

IllegalStateException - if the elements cannot be added at this time due to the subject's insertion restrictions (if any).

See Also:

Collection.add(Object), add(Collection, Object), addAll(Collection, Collection), addAll(Collection, Iterable), addAll(Collection, Iterator), addAll(Collection, Stream), addAll(Collection, Object[])

addAll

public static <E,C extends Collection<E>> C addAll(C subject,
                                                   Collection<? extends E> elements)

Just like subject.addAll(elements), but returns the subject.

Throws:

UnsupportedOperationException - if Collection.addAll(Collection) is not supported by the subject.

NullPointerException - if subject is null or ...

NullPointerException - if the Collection of elements is null or ...

NullPointerException - if any of the specified elements is null and the subject does not permit null elements.

ClassCastException - if the class of the elements prevents them from being added to the subject (may occur only if used raw or forced in a mismatched class context).

IllegalArgumentException - if some property of some elements prevents them from being added to the subject.

IllegalStateException - if the elements cannot be added at this time due to the subject's insertion restrictions (if any).

See Also:

Collection.addAll(Collection), add(Collection, Object), add(Collection, Object, Object, Object[]), addAll(Collection, Stream), addAll(Collection, Iterable), addAll(Collection, Iterator), addAll(Collection, Object[])

addAll

public static <E,C extends Collection<E>> C addAll(C subject,
                                                   Stream<? extends E> elements)

Similar to addAll(Collection, Collection), but takes a Stream as second argument.

Throws:

UnsupportedOperationException - if Collection.add(Object) is not supported by the subject.

NullPointerException - if subject is null or ...

NullPointerException - if the Stream of elements is null or ...

NullPointerException - if any of the streamed elements is null and the subject does not permit null elements.

ClassCastException - if the class of the elements prevents them from being added to the subject (may occur only if used raw or forced in a mismatched class context).

IllegalArgumentException - if some property of some elements prevents them from being added to the subject.

IllegalStateException - if the elements cannot be added at this time due to the subject's insertion restrictions (if any).

See Also:

Collection.add(Object), add(Collection, Object), add(Collection, Object, Object, Object[]), addAll(Collection, Collection), addAll(Collection, Iterable), addAll(Collection, Iterator), addAll(Collection, Object[])

addAll

public static <E,C extends Collection<E>> C addAll(C subject,
                                                   Iterable<? extends E> elements)

Similar to addAll(Collection, Collection), but takes an Iterable as second argument.

Throws:

UnsupportedOperationException - if Collection.add(Object) or Collection.addAll(Collection) is not supported by the subject.

NullPointerException - if subject is null or ...

NullPointerException - if the Iterable of elements is null or ...

NullPointerException - if any of the specified elements is null and the subject does not permit null elements.

ClassCastException - if the class of the elements prevents them from being added to the subject (may occur only if used raw or forced in a mismatched class context).

IllegalArgumentException - if some property of some elements prevents them from being added to the subject.

IllegalStateException - if the elements cannot be added at this time due to the subject's insertion restrictions (if any).

See Also:

Collection.add(Object), Collection.addAll(Collection), add(Collection, Object), add(Collection, Object, Object, Object[]), addAll(Collection, Collection), addAll(Collection, Stream), addAll(Collection, Iterator), addAll(Collection, Object[])

addAll

public static <E,C extends Collection<E>> C addAll(C subject,
                                                   Iterator<? extends E> elements)

Similar to addAll(Collection, Collection), but takes an Iterator as second argument.

Throws:

UnsupportedOperationException - if Collection.add(Object) is not supported by the subject.

NullPointerException - if subject is null or ...

NullPointerException - if the Iterator of elements is null or ...

NullPointerException - if any of the iterated elements is null and the subject does not permit null elements.

ClassCastException - if the class of the elements prevents them from being added to the subject (may occur only if used raw or forced in a mismatched class context).

IllegalArgumentException - if some property of some elements prevents them from being added to the subject.

IllegalStateException - if the elements cannot be added at this time due to the subject's insertion restrictions (if any).

See Also:

Collection.add(Object), add(Collection, Object), add(Collection, Object, Object, Object[]), addAll(Collection, Collection), addAll(Collection, Stream), addAll(Collection, Iterable), addAll(Collection, Object[])

addAll

public static <E,C extends Collection<E>> C addAll(C subject,
                                                   E[] elements)

Similar to addAll(Collection, Collection), but takes an array as second argument.

Throws:

UnsupportedOperationException - if Collection.addAll(Collection) is not supported by the subject.

NullPointerException - if subject is null or ...

NullPointerException - if the array of elements is null or ...

NullPointerException - if any of the specified elements is null and the subject does not permit null elements.

ClassCastException - if the class of the elements prevents them from being added to the subject (may occur only if used raw or forced in a mismatched class context).

IllegalArgumentException - if some property of some elements prevents them from being added to the subject.

IllegalStateException - if the elements cannot be added at this time due to the subject's insertion restrictions (if any).

See Also:

Collection.add(Object), add(Collection, Object), add(Collection, Object, Object, Object[]), addAll(Collection, Collection), addAll(Collection, Stream), addAll(Collection, Iterable), addAll(Collection, Iterator)

clear

public static <C extends Collection<?>> C clear(C subject)

Just like subject.clear(), but returns the subject.

Throws:

NullPointerException - if subject is null.

UnsupportedOperationException - if Collection.clear() is not supported by the subject.

See Also:

Collection.clear()

remove

public static <C extends Collection<?>> C remove(C subject,
                                                 Object element)

Similar to subject.remove(element), but returns the subject.

If subject contains the element several times, each occurrence will be removed!

Avoids an unnecessary ClassCastException or NullPointerException which might be caused by Collection.remove(Object) when the subject does not support the requested element.

Throws:

UnsupportedOperationException - if Collection.removeAll(Collection) is not supported by the subject.

NullPointerException - if subject is null.

See Also:

Collection.remove(Object), Collection.removeAll(Collection), remove(Collection, Object, Object, Object...), removeAll(Collection, Collection), removeAll(Collection, Stream), removeAll(Collection, Iterable), removeAll(Collection, Iterator), removeAll(Collection, Object[])

remove

public static <C extends Collection<?>> C remove(C subject,
                                                 Object element0,
                                                 Object element1,
                                                 Object... more)

Similar to remove(Collection, Object), but allows to remove two or more elements.

If subject contains some of the elements several times, each occurrence will be removed!

Avoids an unnecessary ClassCastException or NullPointerException which might be caused by Collection.remove(Object) or Collection.removeAll(Collection) when the subject does not support some requested elements.

Throws:

NullPointerException - if subject is null or if the array of more elements is null.

UnsupportedOperationException - if Collection.removeAll(Collection) is not supported by the subject.

See Also:

Collection.remove(Object), Collection.removeAll(Collection), remove(Collection, Object), removeAll(Collection, Collection), removeAll(Collection, Stream), removeAll(Collection, Iterable), removeAll(Collection, Iterator), removeAll(Collection, Object[])

removeAll

public static <C extends Collection<?>> C removeAll(C subject,
                                                    Collection<?> elements)

Just like subject.removeAll(elements), but returns the subject.

Avoids an unnecessary ClassCastException or NullPointerException which might be caused by Collection.removeAll(Collection) when the subject does not support some requested elements.

Throws:

UnsupportedOperationException - if Collection.removeAll(Collection) is not supported by the subject.

NullPointerException - if subject is null or ...

NullPointerException - if the Collection of elements is null.

See Also:

Collection.removeAll(Collection), remove(Collection, Object), remove(Collection, Object, Object, Object...), removeAll(Collection, Stream), removeAll(Collection, Iterable), removeAll(Collection, Iterator), removeAll(Collection, Object[])

removeAll

public static <C extends Collection<?>> C removeAll(C subject,
                                                    Stream<?> elements)

Similar to removeAll(Collection, Collection), but takes a Stream as second argument.

Avoids an unnecessary ClassCastException or NullPointerException which might be caused by Collection.removeAll(Collection) when the subject does not support some requested elements.

Throws:

UnsupportedOperationException - if Collection.removeAll(Collection) is not supported by the subject.

NullPointerException - if subject is null or ...

NullPointerException - if the Stream of elements is null.

See Also:

Collection.removeAll(Collection), remove(Collection, Object), remove(Collection, Object, Object, Object...), removeAll(Collection, Collection), removeAll(Collection, Iterable), removeAll(Collection, Iterator), removeAll(Collection, Object[])

removeAll

public static <C extends Collection<?>> C removeAll(C subject,
                                                    Iterable<?> elements)

Similar to removeAll(Collection, Collection), but takes an Iterable as second argument.

Avoids an unnecessary ClassCastException or NullPointerException which might be caused by Collection.removeAll(Collection) when the subject does not support some requested elements.

Throws:

UnsupportedOperationException - if Collection.removeAll(Collection) is not supported by the subject.

NullPointerException - if subject is null or ...

NullPointerException - if the Iterable of elements is null.

See Also:

Collection.removeAll(Collection), remove(Collection, Object), remove(Collection, Object, Object, Object...), removeAll(Collection, Collection), removeAll(Collection, Stream), removeAll(Collection, Iterator), removeAll(Collection, Object[])

removeAll

public static <C extends Collection<?>> C removeAll(C subject,
                                                    Iterator<?> elements)

Similar to removeAll(Collection, Collection), but takes an Iterator as second argument.

Avoids an unnecessary ClassCastException or NullPointerException which might be caused by Collection.removeAll(Collection) when the subject does not support some requested elements.

Throws:

UnsupportedOperationException - if Collection.removeAll(Collection) is not supported by the subject.

NullPointerException - if subject is null or ...

NullPointerException - if the Iterator of elements is null.

See Also:

Collection.removeAll(Collection), remove(Collection, Object), remove(Collection, Object, Object, Object...), removeAll(Collection, Collection), removeAll(Collection, Iterable), removeAll(Collection, Stream), removeAll(Collection, Object[])

removeAll

public static <C extends Collection<?>> C removeAll(C subject,
                                                    Object[] elements)

Similar to removeAll(Collection, Collection), but takes an array as second argument.

Avoids an unnecessary ClassCastException or NullPointerException which might be caused by Collection.removeAll(Collection) when the subject does not support some requested elements.

Throws:

UnsupportedOperationException - if Collection.removeAll(Collection) is not supported by the subject.

NullPointerException - if subject is null or ...

NullPointerException - if the array of elements is null.

See Also:

Collection.removeAll(Collection), remove(Collection, Object), remove(Collection, Object, Object, Object...), removeAll(Collection, Collection), removeAll(Collection, Stream), removeAll(Collection, Iterable), removeAll(Collection, Iterator)

removeIf

public static <E,C extends Collection<E>> C removeIf(C subject,
                                                     Predicate<? super E> filter)

Just like subject.removeIf(filter), but returns the subject.

Throws:

UnsupportedOperationException - if Collection.removeIf(Predicate) is not supported by the subject.

NullPointerException - if subject is null or ...

NullPointerException - if the filter is null.

See Also:

Collection.removeIf(Predicate)

retainAll

public static <C extends Collection<?>> C retainAll(C subject,
                                                    Collection<?> elements)

Just like subject.retainAll(elements), but returns the subject.

Avoids an unnecessary ClassCastException or NullPointerException which might be caused by Collection.retainAll(Collection) when the subject does not support some requested elements.

Throws:

UnsupportedOperationException - if Collection.retainAll(Collection) is not supported by the subject.

NullPointerException - if subject is null or ...

NullPointerException - if the Collection of elements is null.

See Also:

Collection.retainAll(Collection), retainAll(Collection, Stream), retainAll(Collection, Iterable), retainAll(Collection, Iterator), retainAll(Collection, Object[])

retainAll

public static <C extends Collection<?>> C retainAll(C subject,
                                                    Stream<?> elements)

Similar to retainAll(Collection, Collection), but takes a Stream as second argument.

Avoids an unnecessary ClassCastException or NullPointerException which might be caused by Collection.retainAll(Collection) when the subject does not support some requested elements.

Throws:

UnsupportedOperationException - if Collection.retainAll(Collection) is not supported by the subject.

NullPointerException - if subject is null or ...

NullPointerException - if the Stream of elements is null.

See Also:

Collection.retainAll(Collection), retainAll(Collection, Collection), retainAll(Collection, Iterable), retainAll(Collection, Iterator), retainAll(Collection, Object[])

retainAll

public static <C extends Collection<?>> C retainAll(C subject,
                                                    Iterable<?> elements)

Similar to retainAll(Collection, Collection), but takes an Iterable as second argument.

Avoids an unnecessary ClassCastException or NullPointerException which might be caused by Collection.retainAll(Collection) when the subject does not support some requested elements.

Throws:

UnsupportedOperationException - if Collection.retainAll(Collection) is not supported by the subject.

NullPointerException - if subject is null or ...

NullPointerException - if the Iterable of elements is null.

See Also:

Collection.retainAll(Collection), retainAll(Collection, Collection), retainAll(Collection, Stream), retainAll(Collection, Iterator), retainAll(Collection, Object[])

retainAll

public static <C extends Collection<?>> C retainAll(C subject,
                                                    Iterator<?> elements)

Similar to retainAll(Collection, Collection), but takes an Iterator as second argument.

Avoids an unnecessary ClassCastException or NullPointerException which might be caused by Collection.retainAll(Collection) when the subject does not support some requested elements.

Throws:

UnsupportedOperationException - if Collection.retainAll(Collection) is not supported by the subject.

NullPointerException - if subject is null or ...

NullPointerException - if the Iterator of elements is null.

See Also:

Collection.retainAll(Collection), retainAll(Collection, Collection), retainAll(Collection, Stream), retainAll(Collection, Iterable), retainAll(Collection, Object[])

retainAll

public static <C extends Collection<?>> C retainAll(C subject,
                                                    Object[] elements)

Similar to retainAll(Collection, Collection), but takes an array as second argument.

Avoids an unnecessary ClassCastException or NullPointerException which might be caused by Collection.retainAll(Collection) when the subject does not support some requested elements.

Throws:

UnsupportedOperationException - if Collection.retainAll(Collection) is not supported by the subject.

NullPointerException - if subject is null or ...

NullPointerException - if the array of elements is null.

See Also:

Collection.retainAll(Collection), retainAll(Collection, Collection), retainAll(Collection, Stream), retainAll(Collection, Iterable), retainAll(Collection, Iterator)

contains

public static boolean contains(Collection<?> subject,
                               Object element)

Just like subject.contains(element).

Avoids an unnecessary ClassCastException or NullPointerException which might be caused by Collection.contains(Object) when the subject does not support the requested element.

Throws:

NullPointerException - if subject is null.

See Also:

Collection.contains(Object), Collection.containsAll(Collection), contains(Collection, Object, Object, Object...), containsAll(Collection, Collection), containsAll(Collection, Stream), containsAll(Collection, Iterable), containsAll(Collection, Iterator), containsAll(Collection, Object[])

contains

public static boolean contains(Collection<?> subject,
                               Object element0,
                               Object element1,
                               Object... more)

Similar to contains(Collection, Object), but allows to test two or more elements.

Avoids an unnecessary ClassCastException or NullPointerException which might be caused by Collection.containsAll(Collection) when the subject does not support some requested elements.

Throws:

NullPointerException - if subject is null or ...

NullPointerException - if the array of more elements is null.

See Also:

Collection.contains(Object), Collection.containsAll(Collection), contains(Collection, Object), containsAll(Collection, Collection), containsAll(Collection, Stream), containsAll(Collection, Iterable), containsAll(Collection, Iterator), containsAll(Collection, Object[])

containsAll

public static boolean containsAll(Collection<?> subject,
                                  Collection<?> elements)

Just like subject.containsAll(elements), but returns the subject.

Avoids an unnecessary ClassCastException or NullPointerException which might be caused by Collection.containsAll(Collection) when the subject does not support some requested elements.

Throws:

NullPointerException - if subject is null or ...

NullPointerException - if the Collection of elements is null.

See Also:

Collection.contains(Object), Collection.containsAll(Collection), contains(Collection, Object), contains(Collection, Object, Object, Object...), containsAll(Collection, Stream), containsAll(Collection, Iterable), containsAll(Collection, Iterator), containsAll(Collection, Object[])

containsAll

public static boolean containsAll(Collection<?> subject,
                                  Stream<?> elements)

Similar to containsAll(Collection, Collection), but takes a Stream as second argument.

Avoids an unnecessary ClassCastException or NullPointerException which might be caused by Collection.containsAll(Collection) when the subject does not support some requested elements.

Throws:

NullPointerException - if subject is null or ...

NullPointerException - if the Collection of elements is null.

See Also:

Collection.contains(Object), Collection.containsAll(Collection), contains(Collection, Object), contains(Collection, Object, Object, Object...), containsAll(Collection, Collection), containsAll(Collection, Iterable), containsAll(Collection, Iterator), containsAll(Collection, Object[])

containsAll

public static boolean containsAll(Collection<?> subject,
                                  Iterable<?> elements)

Similar to containsAll(Collection, Collection), but takes an Iterable as second argument.

Avoids an unnecessary ClassCastException or NullPointerException which might be caused by Collection.containsAll(Collection) when the subject does not support some requested elements.

Throws:

NullPointerException - if subject is null or ...

NullPointerException - if the Collection of elements is null.

See Also:

Collection.contains(Object), Collection.containsAll(Collection), contains(Collection, Object), contains(Collection, Object, Object, Object...), containsAll(Collection, Collection), containsAll(Collection, Stream), containsAll(Collection, Iterator), containsAll(Collection, Object[])

containsAll

public static boolean containsAll(Collection<?> subject,
                                  Iterator<?> elements)

Similar to containsAll(Collection, Collection), but takes an Iterator as second argument.

Avoids an unnecessary ClassCastException or NullPointerException which might be caused by Collection.containsAll(Collection) when the subject does not support some requested elements.

Throws:

NullPointerException - if subject is null or ...

NullPointerException - if the Collection of elements is null.

See Also:

Collection.contains(Object), Collection.containsAll(Collection), contains(Collection, Object), contains(Collection, Object, Object, Object...), containsAll(Collection, Collection), containsAll(Collection, Stream), containsAll(Collection, Iterable), containsAll(Collection, Object[])

containsAll

public static boolean containsAll(Collection<?> subject,
                                  Object[] elements)

Similar to containsAll(Collection, Collection), but takes an array as second argument.

Avoids an unnecessary ClassCastException or NullPointerException which might be caused by Collection.containsAll(Collection) when the subject does not support some requested elements.

Throws:

NullPointerException - if subject is null or ...

NullPointerException - if the Collection of elements is null.

See Also:

Collection.contains(Object), Collection.containsAll(Collection), contains(Collection, Object), contains(Collection, Object, Object, Object...), containsAll(Collection, Collection), containsAll(Collection, Stream), containsAll(Collection, Iterable), containsAll(Collection, Iterator)

proxy

public static <E> Collection<E> proxy(Collection<E> subject)

Supplies a proxy for a given subject that may be used to implement some Collection-specific methods, e.g.:

• Collection.toArray()
• Collection.toArray(Object[])
• Object.toString()
• ...

Parameters:

subject - A Collection, that at least provides independently ...

• Collection.iterator()
• Collection.size()

proxy

public static <E> List<E> proxy(List<E> subject)

Supplies a proxy for a given subject that may be used to implement some List-specific methods, e.g.:

• List.toArray()
• List.toArray(Object[])
• Object.toString()
• List.equals(Object)
• List.hashCode()
• ...

Parameters:

subject - A List, that at least provides independently ...

• List.get(int)
• List.size()

proxy

public static <E> Set<E> proxy(Set<E> subject)

Supplies a proxy for a given subject that may be used to implement some Set-specific methods, e.g.:

• Set.toArray()
• Set.toArray(Object[])
• Object.toString()
• Set.equals(Object)
• Set.hashCode()
• ...

Parameters:

subject - A Set, that at least provides independently ...

• Set.iterator()
• Set.size()

builder

public static <E,C extends Collection<E>> Collecting.Builder<E,C> builder(Supplier<C> newTarget)

Returns a new Collecting.Builder for target instances as supplied by the given Supplier.

Type Parameters:

E - The element type.

C - The final type of the target instances, at least Collection.

charger

public static <E,C extends Collection<E>> Collecting.Charger<E,C> charger(C target)

Returns a new Collecting.Charger for a given target instance.

Type Parameters:

E - The element type.

C - The final type of the target instances, at least Collection.