Class KeyList.Builder<E>
java.lang.Object
org.magicwerk.brownies.collections.KeyCollectionImpl.BuilderImpl<E>
org.magicwerk.brownies.collections.KeyList.Builder<E>
Builder to construct KeyList instances.
-
Nested Class Summary
Nested classes/interfaces inherited from class org.magicwerk.brownies.collections.KeyCollectionImpl.BuilderImpl
KeyCollectionImpl.BuilderImpl.KeyMapBuilder<E,
K> -
Field Summary
Fields inherited from class org.magicwerk.brownies.collections.KeyCollectionImpl.BuilderImpl
afterDeleteTrigger, afterInsertTrigger, allowNullElem, array, beforeDeleteTrigger, beforeInsertTrigger, capacity, collection, constraint, count, keyColl, keyList, keyMapBuilders, maxSize, movingWindow, setBehavior, useBigList
-
Constructor Summary
Constructors -
Method Summary
Modifier and TypeMethodDescriptionbuild()
Create collection with specified options.withAfterDeleteTrigger
(Consumer<E> trigger) Specify delete trigger.withAfterInsertTrigger
(Consumer<E> trigger) Specify insert trigger.withBeforeDeleteTrigger
(Consumer<E> trigger) Specify delete trigger.withBeforeInsertTrigger
(Consumer<E> trigger) Specify insert trigger.withCapacity
(int capacity) Specify initial capacity.withConstraint
(Predicate<E> constraint) Specify element constraint.withContent
(E... elements) Specify elements added to the collection upon creation.withContent
(Collection<? extends E> elements) Specify elements added to the collection upon creation.withElemDuplicates
(boolean allowDuplicates) Specify whether duplicates are allowed or not.withElemDuplicates
(boolean allowDuplicates, boolean allowDuplicatesNull) Specify whether duplicates are allowed or not.withElemNull
(boolean allowNull) Specifies whether null elements are allowed or not.Add element map (with ident mapper).withElemSort
(boolean sort) Specify that the element set should be sorted using the natural comparator.withElemSort
(Comparator<? super E> comparator) Set comparator to use for sorting the element set.withElemSort
(Comparator<? super E> comparator, boolean sortNullsFirst) Set comparator to use for sorting the element set.withListBig
(boolean bigList) Specify whether list should be stored in an instance of BigList or GapList.withListType
(Class<?> type) Specifies that the list will store its elements as primitive type.withMaxSize
(int maxSize) Specify maximum size of collection.withNull
(boolean allowNull) Specifies whether null elements are allowed or not.withOrderByElem
(boolean orderBy) Specifies that the collection will have the order of the element set.withOrderByElem
(Class<?> type) Specifies that the list will have the order of the element set.Specify the element to be a primary key.Specify the element to be a unique key.withWindowSize
(int maxSize) Specify maximum window size of collection.Methods inherited from class org.magicwerk.brownies.collections.KeyCollectionImpl.BuilderImpl
build, buildKeyMap, getKeyMapBuilder, hasElemMapBuilder, init, init, initKeyMapBuilder, initList, isFalse, isTrue, withElemCount, withKey1Duplicates, withKey1Duplicates, withKey1Null, withKey1Sort, withKey2Duplicates, withKey2Duplicates, withKey2Null, withKey2Sort, withKeyDuplicates, withKeyMap, withKeyNull, withKeySort, withKeySort, withKeySort, withOrderByKey, withOrderByKey, withOrderByKey1, withOrderByKey1, withOrderByKey2, withOrderByKey2, withPrimaryKeyMap, withSetBehavior, withUniqueKeyMap
-
Constructor Details
-
Builder
public Builder()Default constructor. -
Builder
Private constructor used if extending KeyList.- Parameters:
keyList
- key list
-
-
Method Details
-
withNull
Description copied from class:KeyCollectionImpl.BuilderImpl
Specifies whether null elements are allowed or not. A null element will have null keys. This method does not implicitly create an element set, where asKeyCollectionImpl.BuilderImpl.withElemNull(boolean)
does.- Overrides:
withNull
in classKeyCollectionImpl.BuilderImpl<E>
- Parameters:
allowNull
- true to allow null elements (default), false to disallow- Returns:
- this (fluent interfaces)
-
withConstraint
Description copied from class:KeyCollectionImpl.BuilderImpl
Specify element constraint.- Overrides:
withConstraint
in classKeyCollectionImpl.BuilderImpl<E>
- Parameters:
constraint
- constraint element must satisfy, null for none (default)- Returns:
- this (fluent interface)
-
withBeforeInsertTrigger
Description copied from class:KeyCollectionImpl.BuilderImpl
Specify insert trigger.- Overrides:
withBeforeInsertTrigger
in classKeyCollectionImpl.BuilderImpl<E>
- Parameters:
trigger
- insert trigger method, null for none (default)- Returns:
- this (fluent interface)
-
withAfterInsertTrigger
Description copied from class:KeyCollectionImpl.BuilderImpl
Specify insert trigger.- Overrides:
withAfterInsertTrigger
in classKeyCollectionImpl.BuilderImpl<E>
- Parameters:
trigger
- insert trigger method, null for none (default)- Returns:
- this (fluent interface)
-
withBeforeDeleteTrigger
Description copied from class:KeyCollectionImpl.BuilderImpl
Specify delete trigger.- Overrides:
withBeforeDeleteTrigger
in classKeyCollectionImpl.BuilderImpl<E>
- Parameters:
trigger
- delete trigger method, null for none (default)- Returns:
- this (fluent interface)
-
withAfterDeleteTrigger
Description copied from class:KeyCollectionImpl.BuilderImpl
Specify delete trigger.- Overrides:
withAfterDeleteTrigger
in classKeyCollectionImpl.BuilderImpl<E>
- Parameters:
trigger
- delete trigger method, null for none (default)- Returns:
- this (fluent interface)
-
withCapacity
Description copied from class:KeyCollectionImpl.BuilderImpl
Specify initial capacity.- Overrides:
withCapacity
in classKeyCollectionImpl.BuilderImpl<E>
- Parameters:
capacity
- initial capacity- Returns:
- this (fluent interface)
-
withContent
Description copied from class:KeyCollectionImpl.BuilderImpl
Specify elements added to the collection upon creation.- Overrides:
withContent
in classKeyCollectionImpl.BuilderImpl<E>
- Parameters:
elements
- initial elements- Returns:
- this (fluent interface)
-
withContent
Description copied from class:KeyCollectionImpl.BuilderImpl
Specify elements added to the collection upon creation.- Overrides:
withContent
in classKeyCollectionImpl.BuilderImpl<E>
- Parameters:
elements
- initial elements- Returns:
- this (fluent interface)
-
withMaxSize
Description copied from class:KeyCollectionImpl.BuilderImpl
Specify maximum size of collection. If an attempt is made to add more elements, an exception is thrown.- Overrides:
withMaxSize
in classKeyCollectionImpl.BuilderImpl<E>
- Parameters:
maxSize
- maximum size- Returns:
- this (fluent interface)
-
withWindowSize
Description copied from class:KeyCollectionImpl.BuilderImpl
Specify maximum window size of collection. If an attempt is made to add and additional element, the first element is removed.- Overrides:
withWindowSize
in classKeyCollectionImpl.BuilderImpl<E>
- Parameters:
maxSize
- maximum window size- Returns:
- this (fluent interface)
-
withListBig
Description copied from class:KeyCollectionImpl.BuilderImpl
Specify whether list should be stored in an instance of BigList or GapList.- Overrides:
withListBig
in classKeyCollectionImpl.BuilderImpl<E>
- Parameters:
bigList
- true to store list content in an instance of BigList, false for GapList- Returns:
- this (fluent interface)
-
withListType
Description copied from class:KeyCollectionImpl.BuilderImpl
Specifies that the list will store its elements as primitive type.- Overrides:
withListType
in classKeyCollectionImpl.BuilderImpl<E>
- Parameters:
type
- primitive type to use for list- Returns:
- this (fluent interface)
-
withElemSet
Description copied from class:KeyCollectionImpl.BuilderImpl
Add element map (with ident mapper).- Overrides:
withElemSet
in classKeyCollectionImpl.BuilderImpl<E>
- Returns:
- this (fluent interface)
-
withOrderByElem
Description copied from class:KeyCollectionImpl.BuilderImpl
Specifies that the collection will have the order of the element set. The element set must be sorted, if no sort order has been defined, the natural comparator will be used. If the set allows null values, the used comparator will sort them last.- Overrides:
withOrderByElem
in classKeyCollectionImpl.BuilderImpl<E>
- Parameters:
orderBy
- if true the collection will have the order of the element set (default is false, only one key map or the element set can have the order by option set)- Returns:
- this (fluent interface)
-
withOrderByElem
Description copied from class:KeyCollectionImpl.BuilderImpl
Specifies that the list will have the order of the element set. The set will store values of the primitive type specified likeint
. The set will be sorted using the natural comparator and no null values are allowed.- Overrides:
withOrderByElem
in classKeyCollectionImpl.BuilderImpl<E>
- Parameters:
type
- primitive type to use for key map (only one key map or the element set can have the order by option set)- Returns:
- this (fluent interface)
-
withElemNull
Description copied from class:KeyCollectionImpl.BuilderImpl
Specifies whether null elements are allowed or not. A null element will have null keys. This method does implicitly create an element set, where asKeyCollectionImpl.BuilderImpl.withNull(boolean)
does not.- Overrides:
withElemNull
in classKeyCollectionImpl.BuilderImpl<E>
- Parameters:
allowNull
- true to allow null elements, false to disallow (default is true)- Returns:
- this (fluent interfaces)
-
withElemDuplicates
Description copied from class:KeyCollectionImpl.BuilderImpl
Specify whether duplicates are allowed or not. This method does implicitly create an element set.- Overrides:
withElemDuplicates
in classKeyCollectionImpl.BuilderImpl<E>
- Parameters:
allowDuplicates
- true to allow duplicates (default is true)- Returns:
- this (fluent interfaces)
-
withElemDuplicates
Description copied from class:KeyCollectionImpl.BuilderImpl
Specify whether duplicates are allowed or not. This method does implicitly create an element set.- Overrides:
withElemDuplicates
in classKeyCollectionImpl.BuilderImpl<E>
- Parameters:
allowDuplicates
- true to allow duplicates (default is true)allowDuplicatesNull
- true to allow duplicate null values (default is true)- Returns:
- this (fluent interfaces)
-
withElemSort
Description copied from class:KeyCollectionImpl.BuilderImpl
Specify that the element set should be sorted using the natural comparator. If the collection supports null values, they are sorted last. This method does implicitly create an element set. Note that this does not automatically sort the collection itself, call a withOrderBy method for this.- Overrides:
withElemSort
in classKeyCollectionImpl.BuilderImpl<E>
- Parameters:
sort
- true to sorted, false for unsorted (default is false)- Returns:
- this (fluent interface)
-
withElemSort
Description copied from class:KeyCollectionImpl.BuilderImpl
Set comparator to use for sorting the element set. If the collection allows null values, the comparator must be able to compare null values. If the comparator does not support null values, use withElemSort(Comparator, boolean) to explicitly specify how null values should be sorted. This method does implicitly create an element set. Note that this does not automatically sort the collection itself, call a withOrderBy method for this.- Overrides:
withElemSort
in classKeyCollectionImpl.BuilderImpl<E>
- Parameters:
comparator
- comparator to use for sorting (null for natural comparator)- Returns:
- this (fluent interface)
-
withElemSort
Description copied from class:KeyCollectionImpl.BuilderImpl
Set comparator to use for sorting the element set. This method should be used if the collection can contain null values, but the comparator is not able to handle them. The parameter sortNullsFirst determine how the null values should be sorted. This method does implicitly create an element set.- Overrides:
withElemSort
in classKeyCollectionImpl.BuilderImpl<E>
- Parameters:
comparator
- comparator to use for sortingsortNullsFirst
- true to sort null values first, false for last- Returns:
- this (fluent interface)
-
withPrimaryElem
Description copied from class:KeyCollectionImpl.BuilderImpl
Specify the element to be a primary key. This is identical to callingwithElemNull(false) and withElemDuplicates(false)
.- Overrides:
withPrimaryElem
in classKeyCollectionImpl.BuilderImpl<E>
- Returns:
- this (fluent interface)
-
withUniqueElem
Description copied from class:KeyCollectionImpl.BuilderImpl
Specify the element to be a unique key. This is identical to callingwithElemNull(true) and withElemDuplicates(false, true)
.- Overrides:
withUniqueElem
in classKeyCollectionImpl.BuilderImpl<E>
- Returns:
- this (fluent interface)
-
build
Create collection with specified options.- Returns:
- created collection
-