Package org.cyclops.cyclopscore.ingredient.collection

Class IngredientCollectionMultiClassified<T,M>

java.lang.Object

org.cyclops.cyclopscore.ingredient.collection.IngredientCollectionAdapter<T,M>

org.cyclops.cyclopscore.ingredient.collection.IngredientCollectionMultiClassified<T,M>

Type Parameters:

T - An instance type.

M - The matching condition parameter.

All Implemented Interfaces:

Iterable<T>, IIngredientCollection<T,M>, IIngredientCollectionLike<T,M,T>, IIngredientCollectionLikeMultiClassifiedTrait<T,M,T,IngredientCollectionSingleClassified<T,M,?,?>>, IIngredientCollectionMutable<T,M>

public class IngredientCollectionMultiClassified<T,M>
extends IngredientCollectionAdapter<T,M>
implements IIngredientCollectionMutable<T,M>, IIngredientCollectionLikeMultiClassifiedTrait<T,M,T,IngredientCollectionSingleClassified<T,M,?,?>>

An ingredient collection that classifies instances in smaller collections based on all category type of a component type. This allows instances to be looked up or removed more efficiently when the used match condition is compatible with the identifying match condition of category types.

Nested Class Summary

Nested classes/interfaces inherited from interface org.cyclops.cyclopscore.ingredient.collection.IIngredientCollectionLikeMultiClassifiedTrait

IIngredientCollectionLikeMultiClassifiedTrait.RemoveCallbackIterator<T,M,I,L extends IIngredientCollectionLike<T,M,I>>

Constructor Summary

Constructors

Constructor	Description
IngredientCollectionMultiClassified(IngredientComponent<T,M> component, Supplier<IIngredientCollectionMutable<T,M>> collectionCreator)

Method Summary

Modifier and Type	Method	Description
boolean	add(T instance)	Add the given instance to the collection.
boolean	addAllThreaded(ExecutorService executorService, Iterable<? extends T> instances)	A multi-threaded addAll implementation.
void	clear()	Clears this collection of all instances.
boolean	contains(T instance)	Check if this collection contains the given instance.
boolean	contains(T instance, M matchCondition)	Check if this collection contains the given instance under the given match conditions.
int	count(T instance, M matchCondition)	Count the number of occurrences of the given instance under the given match conditions.
boolean	equals(Object obj)	Check if this collection equals the given object.
Map<IngredientComponentCategoryType<T,M,?>,IngredientCollectionSingleClassified<T,M,?,?>>	getClassifiedCollections()
Iterator<T>	iterator()
Iterator<T>	iterator(T instance, M matchCondition)	An iterator over this collection over all occurrences of the given instance under the given match conditions.
boolean	remove(T instance)	Remove the given instance from the collection.
int	removeAll(T instance, M matchCondition)	Remove all occurrences of the given instance under the given match conditions.
void	removeInstance(IngredientCollectionSingleClassified<T,M,?,?> collection, T iterableInstance)	Remove the given instance from the given collection-like.
int	size()

Methods inherited from class org.cyclops.cyclopscore.ingredient.collection.IngredientCollectionAdapter

getComponent, hashCode, toString

Methods inherited from class java.lang.Object

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

Methods inherited from interface org.cyclops.cyclopscore.ingredient.collection.IIngredientCollection

containsAll, containsAll, parallelStream, spliterator, stream, toArray

Methods inherited from interface org.cyclops.cyclopscore.ingredient.collection.IIngredientCollectionLike

getComponent, hashCode, isEmpty, toString

Methods inherited from interface org.cyclops.cyclopscore.ingredient.collection.IIngredientCollectionLikeMultiClassifiedTrait

getBestClassifiedCollection, getFirstMatchingCategory, getFirstSingleClassified

Methods inherited from interface org.cyclops.cyclopscore.ingredient.collection.IIngredientCollectionMutable

addAll, removeAll, removeAll

Methods inherited from interface java.lang.Iterable

forEach

Constructor Details

IngredientCollectionMultiClassified

public IngredientCollectionMultiClassified(IngredientComponent<T,M> component,
 Supplier<IIngredientCollectionMutable<T,M>> collectionCreator)

Method Details

add

public boolean add(T instance)

Description copied from interface: IIngredientCollectionMutable

Add the given instance to the collection.

Specified by:

add in interface IIngredientCollectionMutable<T,M>

Parameters:

instance - An instance.

Returns:

If the collection was changed due to this addition. This can be false in the case of sets in which each instance can only exists once.

addAllThreaded

public boolean addAllThreaded(@Nullable
 ExecutorService executorService,
 Iterable<? extends T> instances)

A multi-threaded addAll implementation. This will create workers for adding the given instances to all classified collections.

Parameters:

executorService - An optional executor service. If none is provided, a new temporary one will be created for the duration of this method call.

instances - The instances that need to be added.

Returns:

If the collection was changed due to this addition. This can be false in the case of sets in which each instance can only exists once.

remove

public boolean remove(T instance)

Description copied from interface: IIngredientCollectionMutable

Remove the given instance from the collection.

Specified by:

remove in interface IIngredientCollectionMutable<T,M>

Overrides:

remove in class IngredientCollectionAdapter<T,M>

Parameters:

instance - An instance.

Returns:

If the collection was changed due to this addition. Can be false if the collection did not contain the instance.

removeAll

public int removeAll(T instance,
 M matchCondition)

Description copied from interface: IIngredientCollectionMutable

Remove all occurrences of the given instance under the given match conditions. This instance will be compared based on the matcher from the ingredient component type using the given match condition.

Specified by:

removeAll in interface IIngredientCollectionMutable<T,M>

Overrides:

removeAll in class IngredientCollectionAdapter<T,M>

Parameters:

instance - An instance.

matchCondition - A match condition.

Returns:

The number of removed instances.

contains

public boolean contains(T instance)

Description copied from interface: IIngredientCollection

Check if this collection contains the given instance. This instance will be compared based on the matcher from the ingredient component type.

Specified by:

contains in interface IIngredientCollection<T,M>

Overrides:

contains in class IngredientCollectionAdapter<T,M>

Parameters:

instance - An instance.

Returns:

If this collection contains the given instance.

contains

public boolean contains(T instance,
 M matchCondition)

Description copied from interface: IIngredientCollection

Check if this collection contains the given instance under the given match conditions. This instance will be compared based on the matcher from the ingredient component type using the given match condition.

Specified by:

contains in interface IIngredientCollection<T,M>

Overrides:

contains in class IngredientCollectionAdapter<T,M>

Parameters:

instance - An instance.

matchCondition - A match condition.

Returns:

If this collection contains the given instance under the given match conditions.

count

public int count(T instance,
 M matchCondition)

Description copied from interface: IIngredientCollection

Count the number of occurrences of the given instance under the given match conditions. This instance will be compared based on the matcher from the ingredient component type using the given match condition.

Specified by:

count in interface IIngredientCollection<T,M>

Overrides:

count in class IngredientCollectionAdapter<T,M>

Parameters:

instance - An instance.

matchCondition - A match condition.

Returns:

The number of occurrences of the given instance under the given match conditions.

clear

public void clear()

Description copied from interface: IIngredientCollectionMutable

Clears this collection of all instances.

Specified by:

clear in interface IIngredientCollectionMutable<T,M>

size

public int size()

Specified by:

size in interface IIngredientCollectionLike<T,M,T>

Returns:

The number of instances contained in this collection.

equals

public boolean equals(Object obj)

Description copied from interface: IIngredientCollectionLike

Check if this collection equals the given object.

Specified by:

equals in interface IIngredientCollectionLike<T,M,T>

Overrides:

equals in class Object

Parameters:

obj - An object.

Returns:

True if the given object is an ingredient collection of the same type, component type and contains the same instances.

iterator

public Iterator<T> iterator()

Specified by:

iterator in interface Iterable<T>

iterator

public Iterator<T> iterator(T instance,
 M matchCondition)

Description copied from interface: IIngredientCollection

An iterator over this collection over all occurrences of the given instance under the given match conditions.

Specified by:

iterator in interface IIngredientCollection<T,M>

Specified by:

iterator in interface IIngredientCollectionLike<T,M,T>

Overrides:

iterator in class IngredientCollectionAdapter<T,M>

Parameters:

instance - An instance.

matchCondition - A match condition.

Returns:

An iterator over this collection over all occurrences of the given instance under the given match conditions.

removeInstance

public void removeInstance(IngredientCollectionSingleClassified<T,M,?,?> collection,
 T iterableInstance)

Description copied from interface: IIngredientCollectionLikeMultiClassifiedTrait

Remove the given instance from the given collection-like. This is used internally for iteration purposes.

Specified by:

removeInstance in interface IIngredientCollectionLikeMultiClassifiedTrait<T,M,T,IngredientCollectionSingleClassified<T,M,?,?>>

Parameters:

collection - A collection-like.

iterableInstance - An iterator instance.

getClassifiedCollections

public Map<IngredientComponentCategoryType<T,M,?>,IngredientCollectionSingleClassified<T,M,?,?>> getClassifiedCollections()

Specified by:

getClassifiedCollections in interface IIngredientCollectionLikeMultiClassifiedTrait<T,M,T,IngredientCollectionSingleClassified<T,M,?,?>>

Returns:

A mapping of all internal classified collections.