Key1Collection.Builder (Brownies-Collections 0.9.23 API)

java.lang.Object
- org.magicwerk.brownies.collections.KeyCollectionImpl.BuilderImpl<E>
- - org.magicwerk.brownies.collections.Key1Collection.Builder<E,K>

Direct Known Subclasses:

Key1Set.Builder

Enclosing class:

Key1Collection<E,K>
```
public static class Key1Collection.Builder<E,K>
extends KeyCollectionImpl.BuilderImpl<E>
```
Builder to construct Key1Collection instances.

Nested Class Summary
- Nested classes/interfaces inherited from class org.magicwerk.brownies.collections.KeyCollectionImpl.BuilderImpl
  KeyCollectionImpl.BuilderImpl.KeyMapBuilder<E,K>

Constructor Summary

Constructors
Constructor and Description

Builder()
Default constructor.

Constructors
Constructor and Description
`Builder()` Default constructor.

Method Summary

All Methods Instance Methods Concrete Methods
Modifier and Type	Method and Description
`Key1Collection<E,K>`	`build()`
`Key1Collection.Builder<E,K>`	`withAfterDeleteTrigger(java.util.function.Consumer<E> trigger)` Specify delete trigger.
`Key1Collection.Builder<E,K>`	`withAfterInsertTrigger(java.util.function.Consumer<E> trigger)` Specify insert trigger.
`Key1Collection.Builder<E,K>`	`withBeforeDeleteTrigger(java.util.function.Consumer<E> trigger)` Specify delete trigger.
`Key1Collection.Builder<E,K>`	`withBeforeInsertTrigger(java.util.function.Consumer<E> trigger)` Specify insert trigger.
`Key1Collection.Builder<E,K>`	`withCapacity(int capacity)` Specify initial capacity.
`Key1Collection.Builder<E,K>`	`withConstraint(java.util.function.Predicate<E> constraint)` Specify element constraint.
`Key1Collection.Builder<E,K>`	`withContent(java.util.Collection<? extends E> elements)` Specify elements added to the collection upon creation.
`Key1Collection.Builder<E,K>`	`withContent(E... elements)` Specify elements added to the collection upon creation.
`Key1Collection.Builder<E,K>`	`withElemDuplicates(boolean allowDuplicates)` Specify whether duplicates are allowed or not.
`Key1Collection.Builder<E,K>`	`withElemDuplicates(boolean allowDuplicates, boolean allowDuplicatesNull)` Specify whether duplicates are allowed or not.
`Key1Collection.Builder<E,K>`	`withElemNull(boolean allowNull)` Specifies whether null elements are allowed or not.
`Key1Collection.Builder<E,K>`	`withElemSet()` Add element map (with ident mapper).
`Key1Collection.Builder<E,K>`	`withElemSort(boolean sort)` Specify that the element set should be sorted using the natural comparator.
`Key1Collection.Builder<E,K>`	`withElemSort(java.util.Comparator<? super E> comparator)` Set comparator to use for sorting the element set.
`Key1Collection.Builder<E,K>`	`withElemSort(java.util.Comparator<? super E> comparator, boolean sortNullsFirst)` Set comparator to use for sorting the element set.
`Key1Collection.Builder<E,K>`	`withKey1Duplicates(boolean allowDuplicates)` Specify whether duplicates are allowed or not.
`Key1Collection.Builder<E,K>`	`withKey1Duplicates(boolean allowDuplicates, boolean allowDuplicatesNull)` Specify whether duplicates are allowed or not.
`Key1Collection.Builder<E,K>`	`withKey1Map(java.util.function.Function<? super E,K> mapper)` Add key map.
`Key1Collection.Builder<E,K>`	`withKey1Null(boolean allowNull)` Specify whether null elements are allowed or not.
`Key1Collection.Builder<E,K>`	`withKey1Sort(boolean sort)` Set comparator to use for sorting the key map.
`Key1Collection.Builder<E,K>`	`withKey1Sort(java.util.Comparator<? super K> comparator)` Set comparator to use for sorting the key map.
`Key1Collection.Builder<E,K>`	`withKey1Sort(java.util.Comparator<? super K> comparator, boolean sortNullsFirst)` Set comparator to use for sorting the key map.
`Key1Collection.Builder<E,K>`	`withMaxSize(int maxSize)` Specify maximum size of collection.
`Key1Collection.Builder<E,K>`	`withNull(boolean allowNull)` Specifies whether null elements are allowed or not.
`Key1Collection.Builder<E,K>`	`withOrderByElem(boolean orderBy)` Specifies that the collection will have the order of the element set.
`Key1Collection.Builder<E,K>`	`withOrderByKey1(boolean orderBy)` Specifies that the collection will have the order of the key map.
`Key1Collection.Builder<E,K>`	`withPrimaryElem()` Specify the element to be a primary key.
`Key1Collection.Builder<E,K>`	`withPrimaryKey1Map(java.util.function.Function<? super E,K> mapper)` Specify this key to be a primary key.
`Key1Collection.Builder<E,K>`	`withSetBehavior(boolean setBehavior)` Specifies that the collection behaves like a `Set` on adding elements, i.e.
`Key1Collection.Builder<E,K>`	`withUniqueElem()` Specify the element to be a unique key.
`Key1Collection.Builder<E,K>`	`withUniqueKey1Map(java.util.function.Function<? super E,K> mapper)` Specify this key to be a unique key.

Methods inherited from class org.magicwerk.brownies.collections.KeyCollectionImpl.BuilderImpl
withElemCount, withKey2Duplicates, withKey2Duplicates, withKey2Null, withKey2Sort, withKeyDuplicates, withKeyMap, withKeyNull, withKeySort, withKeySort, withKeySort, withListBig, withListType, withOrderByElem, withOrderByKey, withOrderByKey, withOrderByKey1, withOrderByKey2, withOrderByKey2, withPrimaryKeyMap, withUniqueKeyMap, withWindowSize

Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

- Constructor Detail
  - Builder
```
public Builder()
```
    Default constructor.
- Method Detail
  - build
```
public Key1Collection<E,K> build()
```
    Returns:
    
    created collection
  - withNull
```
public Key1Collection.Builder<E,K> withNull(boolean allowNull)
```
    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 as KeyCollectionImpl.BuilderImpl.withElemNull(boolean) does.
    
    Overrides:
    
    withNull in class KeyCollectionImpl.BuilderImpl<E>
    
    Parameters:
    
    allowNull - true to allow null elements (default), false to disallow
    
    Returns:
    
    this (fluent interfaces)
  - withConstraint
```
public Key1Collection.Builder<E,K> withConstraint(java.util.function.Predicate<E> constraint)
```
    Description copied from class: KeyCollectionImpl.BuilderImpl
    
    Specify element constraint.
    
    Overrides:
    
    withConstraint in class KeyCollectionImpl.BuilderImpl<E>
    
    Parameters:
    
    constraint - constraint element must satisfy, null for none (default)
    
    Returns:
    
    this (fluent interface)
  - withBeforeInsertTrigger
```
public Key1Collection.Builder<E,K> withBeforeInsertTrigger(java.util.function.Consumer<E> trigger)
```
    Description copied from class: KeyCollectionImpl.BuilderImpl
    
    Specify insert trigger.
    
    Overrides:
    
    withBeforeInsertTrigger in class KeyCollectionImpl.BuilderImpl<E>
    
    Parameters:
    
    trigger - insert trigger method, null for none (default)
    
    Returns:
    
    this (fluent interface)
  - withAfterInsertTrigger
```
public Key1Collection.Builder<E,K> withAfterInsertTrigger(java.util.function.Consumer<E> trigger)
```
    Description copied from class: KeyCollectionImpl.BuilderImpl
    
    Specify insert trigger.
    
    Overrides:
    
    withAfterInsertTrigger in class KeyCollectionImpl.BuilderImpl<E>
    
    Parameters:
    
    trigger - insert trigger method, null for none (default)
    
    Returns:
    
    this (fluent interface)
  - withBeforeDeleteTrigger
```
public Key1Collection.Builder<E,K> withBeforeDeleteTrigger(java.util.function.Consumer<E> trigger)
```
    Description copied from class: KeyCollectionImpl.BuilderImpl
    
    Specify delete trigger.
    
    Overrides:
    
    withBeforeDeleteTrigger in class KeyCollectionImpl.BuilderImpl<E>
    
    Parameters:
    
    trigger - delete trigger method, null for none (default)
    
    Returns:
    
    this (fluent interface)
  - withAfterDeleteTrigger
```
public Key1Collection.Builder<E,K> withAfterDeleteTrigger(java.util.function.Consumer<E> trigger)
```
    Description copied from class: KeyCollectionImpl.BuilderImpl
    
    Specify delete trigger.
    
    Overrides:
    
    withAfterDeleteTrigger in class KeyCollectionImpl.BuilderImpl<E>
    
    Parameters:
    
    trigger - delete trigger method, null for none (default)
    
    Returns:
    
    this (fluent interface)
  - withCapacity
```
public Key1Collection.Builder<E,K> withCapacity(int capacity)
```
    Description copied from class: KeyCollectionImpl.BuilderImpl
    
    Specify initial capacity.
    
    Overrides:
    
    withCapacity in class KeyCollectionImpl.BuilderImpl<E>
    
    Parameters:
    
    capacity - initial capacity
    
    Returns:
    
    this (fluent interface)
  - withContent
```
public Key1Collection.Builder<E,K> withContent(java.util.Collection<? extends E> elements)
```
    Description copied from class: KeyCollectionImpl.BuilderImpl
    
    Specify elements added to the collection upon creation.
    
    Overrides:
    
    withContent in class KeyCollectionImpl.BuilderImpl<E>
    
    Parameters:
    
    elements - initial elements
    
    Returns:
    
    this (fluent interface)
  - withContent
```
public Key1Collection.Builder<E,K> withContent(E... elements)
```
    Description copied from class: KeyCollectionImpl.BuilderImpl
    
    Specify elements added to the collection upon creation.
    
    Overrides:
    
    withContent in class KeyCollectionImpl.BuilderImpl<E>
    
    Parameters:
    
    elements - initial elements
    
    Returns:
    
    this (fluent interface)
  - withMaxSize
```
public Key1Collection.Builder<E,K> withMaxSize(int maxSize)
```
    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 class KeyCollectionImpl.BuilderImpl<E>
    
    Parameters:
    
    maxSize - maximum size
    
    Returns:
    
    this (fluent interface)
  - withSetBehavior
```
public Key1Collection.Builder<E,K> withSetBehavior(boolean setBehavior)
```
    Description copied from class: KeyCollectionImpl.BuilderImpl
    
    Specifies that the collection behaves like a Set on adding elements, i.e. if an element cannot be added due to duplicate or other constraints, no exception is thrown.
    
    Overrides:
    
    withSetBehavior in class KeyCollectionImpl.BuilderImpl<E>
    
    Parameters:
    
    setBehavior - true to define set behavior (default is false)
    
    Returns:
    
    this (fluent interface)
  - withElemSet
```
public Key1Collection.Builder<E,K> withElemSet()
```
    Description copied from class: KeyCollectionImpl.BuilderImpl
    
    Add element map (with ident mapper).
    
    Overrides:
    
    withElemSet in class KeyCollectionImpl.BuilderImpl<E>
    
    Returns:
    
    this (fluent interface)
  - withOrderByElem
```
public Key1Collection.Builder<E,K> withOrderByElem(boolean orderBy)
```
    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 class KeyCollectionImpl.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)
  - withElemNull
```
public Key1Collection.Builder<E,K> withElemNull(boolean allowNull)
```
    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 as KeyCollectionImpl.BuilderImpl.withNull(boolean) does not.
    
    Overrides:
    
    withElemNull in class KeyCollectionImpl.BuilderImpl<E>
    
    Parameters:
    
    allowNull - true to allow null elements, false to disallow (default is true)
    
    Returns:
    
    this (fluent interfaces)
  - withElemDuplicates
```
public Key1Collection.Builder<E,K> withElemDuplicates(boolean allowDuplicates)
```
    Description copied from class: KeyCollectionImpl.BuilderImpl
    
    Specify whether duplicates are allowed or not. This method does implicitly create an element set.
    
    Overrides:
    
    withElemDuplicates in class KeyCollectionImpl.BuilderImpl<E>
    
    Parameters:
    
    allowDuplicates - true to allow duplicates (default is true)
    
    Returns:
    
    this (fluent interfaces)
  - withElemDuplicates
```
public Key1Collection.Builder<E,K> withElemDuplicates(boolean allowDuplicates,
                                                      boolean allowDuplicatesNull)
```
    Description copied from class: KeyCollectionImpl.BuilderImpl
    
    Specify whether duplicates are allowed or not. This method does implicitly create an element set.
    
    Overrides:
    
    withElemDuplicates in class KeyCollectionImpl.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
```
public Key1Collection.Builder<E,K> withElemSort(boolean sort)
```
    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 class KeyCollectionImpl.BuilderImpl<E>
    
    Parameters:
    
    sort - true to sorted, false for unsorted (default is false)
    
    Returns:
    
    this (fluent interface)
  - withElemSort
```
public Key1Collection.Builder<E,K> withElemSort(java.util.Comparator<? super E> comparator)
```
    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 class KeyCollectionImpl.BuilderImpl<E>
    
    Parameters:
    
    comparator - comparator to use for sorting (null for natural comparator)
    
    Returns:
    
    this (fluent interface)
  - withElemSort
```
public Key1Collection.Builder<E,K> withElemSort(java.util.Comparator<? super E> comparator,
                                                boolean sortNullsFirst)
```
    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 class KeyCollectionImpl.BuilderImpl<E>
    
    Parameters:
    
    comparator - comparator to use for sorting
    
    sortNullsFirst - true to sort null values first, false for last
    
    Returns:
    
    this (fluent interface)
  - withPrimaryElem
```
public Key1Collection.Builder<E,K> withPrimaryElem()
```
    Description copied from class: KeyCollectionImpl.BuilderImpl
    
    Specify the element to be a primary key. This is identical to calling withElemNull(false) and withElemDuplicates(false).
    
    Overrides:
    
    withPrimaryElem in class KeyCollectionImpl.BuilderImpl<E>
    
    Returns:
    
    this (fluent interface)
  - withUniqueElem
```
public Key1Collection.Builder<E,K> withUniqueElem()
```
    Description copied from class: KeyCollectionImpl.BuilderImpl
    
    Specify the element to be a unique key. This is identical to calling withElemNull(true) and withElemDuplicates(false, true).
    
    Overrides:
    
    withUniqueElem in class KeyCollectionImpl.BuilderImpl<E>
    
    Returns:
    
    this (fluent interface)
  - withKey1Map
```
public Key1Collection.Builder<E,K> withKey1Map(java.util.function.Function<? super E,K> mapper)
```
    Add key map.
    
    Parameters:
    
    mapper - mapper to use
    
    Returns:
    
    this (fluent interface)
  - withPrimaryKey1Map
```
public Key1Collection.Builder<E,K> withPrimaryKey1Map(java.util.function.Function<? super E,K> mapper)
```
    Specify this key to be a primary key. This is identical to calling withKey1Map(mapper), withKey1Null(false), and withKey1Duplicates(false).
    
    Parameters:
    
    mapper - mapper to use
    
    Returns:
    
    this (fluent interface)
  - withUniqueKey1Map
```
public Key1Collection.Builder<E,K> withUniqueKey1Map(java.util.function.Function<? super E,K> mapper)
```
    Specify this key to be a unique key. This is identical to calling withKey1Map(mapper), withKey1Null(true), and withKey1Duplicates(false, true).
    
    Parameters:
    
    mapper - mapper to use
    
    Returns:
    
    this (fluent interface)
  - withOrderByKey1
```
public Key1Collection.Builder<E,K> withOrderByKey1(boolean orderBy)
```
    Description copied from class: KeyCollectionImpl.BuilderImpl
    
    Specifies that the collection will have the order of the key map. The key map must be sorted, if no sort order has been defined, the natural comparator will be used. If the map allows null values, the used comparator will sort them last.
    
    Overrides:
    
    withOrderByKey1 in class KeyCollectionImpl.BuilderImpl<E>
    
    Parameters:
    
    orderBy - if true the collection will have the order of the key map (default is false, only one key map or the element set can have the order by option set)
    
    Returns:
    
    this (fluent interface)
  - withKey1Null
```
public Key1Collection.Builder<E,K> withKey1Null(boolean allowNull)
```
    Description copied from class: KeyCollectionImpl.BuilderImpl
    
    Specify whether null elements are allowed or not. A null element will have a null key.
    
    Overrides:
    
    withKey1Null in class KeyCollectionImpl.BuilderImpl<E>
    
    Parameters:
    
    allowNull - true to allow null elements, false to disallow
    
    Returns:
    
    this (fluent interfaces)
  - withKey1Duplicates
```
public Key1Collection.Builder<E,K> withKey1Duplicates(boolean allowDuplicates)
```
    Description copied from class: KeyCollectionImpl.BuilderImpl
    
    Specify whether duplicates are allowed or not.
    
    Overrides:
    
    withKey1Duplicates in class KeyCollectionImpl.BuilderImpl<E>
    
    Parameters:
    
    allowDuplicates - true to allow duplicates
    
    Returns:
    
    this (fluent interfaces)
  - withKey1Duplicates
```
public Key1Collection.Builder<E,K> withKey1Duplicates(boolean allowDuplicates,
                                                      boolean allowDuplicatesNull)
```
    Description copied from class: KeyCollectionImpl.BuilderImpl
    
    Specify whether duplicates are allowed or not.
    
    Overrides:
    
    withKey1Duplicates in class KeyCollectionImpl.BuilderImpl<E>
    
    Parameters:
    
    allowDuplicates - true to allow duplicates
    
    allowDuplicatesNull - true to allow duplicate null values
    
    Returns:
    
    this (fluent interfaces)
  - withKey1Sort
```
public Key1Collection.Builder<E,K> withKey1Sort(boolean sort)
```
    Description copied from class: KeyCollectionImpl.BuilderImpl
    
    Set comparator to use for sorting the key map. Note that this does not automatically sort the list itself, call a withOrderBy method for this.
    
    Overrides:
    
    withKey1Sort in class KeyCollectionImpl.BuilderImpl<E>
    
    Parameters:
    
    sort - true to sort key map
    
    Returns:
    
    this (fluent interface)
  - withKey1Sort
```
public Key1Collection.Builder<E,K> withKey1Sort(java.util.Comparator<? super K> comparator)
```
    Set comparator to use for sorting the key map. Note that this does not automatically sort the collection itself, call a withOrderBy method for this.
    
    Parameters:
    
    comparator - comparator to use for sorting
    
    Returns:
    
    this (fluent interface)
  - withKey1Sort
```
public Key1Collection.Builder<E,K> withKey1Sort(java.util.Comparator<? super K> comparator,
                                                boolean sortNullsFirst)
```
    Set comparator to use for sorting the key map. Note that this does not automatically sort the collection itself, call a withOrderBy method for this.
    
    Parameters:
    
    comparator - comparator to use for sorting
    
    sortNullsFirst - true if null will be sorted first, false for last
    
    Returns:
    
    this (fluent interface)

Class Key1Collection.Builder<E,K>

Nested Class Summary

Nested classes/interfaces inherited from class org.magicwerk.brownies.collections.KeyCollectionImpl.BuilderImpl

Constructor Summary

Method Summary

Methods inherited from class org.magicwerk.brownies.collections.KeyCollectionImpl.BuilderImpl

Methods inherited from class java.lang.Object

Constructor Detail

Builder

Method Detail

build

withNull

withConstraint

withBeforeInsertTrigger

withAfterInsertTrigger

withBeforeDeleteTrigger

withAfterDeleteTrigger

withCapacity

withContent

withContent

withMaxSize

withSetBehavior

withElemSet

withOrderByElem

withElemNull

withElemDuplicates

withElemDuplicates

withElemSort

withElemSort

withElemSort

withPrimaryElem

withUniqueElem

withKey1Map

withPrimaryKey1Map

withUniqueKey1Map

withOrderByKey1

withKey1Null

withKey1Duplicates

withKey1Duplicates

withKey1Sort

withKey1Sort

withKey1Sort