org.apache.brooklyn.util.collections

Class CollectionMerger.Builder

java.lang.Object

org.apache.brooklyn.util.collections.CollectionMerger.Builder

Enclosing class:

CollectionMerger

public static class CollectionMerger.Builder
extends java.lang.Object

Constructor Summary

Constructors

Constructor and Description
Builder()

Method Summary

Modifier and Type	Method and Description
CollectionMerger	build()
CollectionMerger.Builder	deep(boolean val) Sets effectively infinite depth(int) (the default)
CollectionMerger.Builder	depth(int val) Depth 1 means a shallow copy - i.e.
CollectionMerger.Builder	mergeNestedLists(java.util.function.BiFunction<java.util.Collection<?>,java.util.Collection<?>,java.util.Collection<?>> listMergeFunction) Defines a function to use to determine the result when lists or sets need merging.
CollectionMerger.Builder	mergeNestedLists(boolean val) By default lists will not be merged, and either the first or second will be kept depending on preferSecondOnConflict(boolean).
CollectionMerger.Builder	mergeNestedMaps(boolean val) Deprecated. since 1.0, never did anything
CollectionMerger.Builder	preferSecondOnConflict(boolean val) defaults to false, so if there is an unmergeable conflict, e.g.

Methods inherited from class java.lang.Object

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

Constructor Detail

Builder

public Builder()

Method Detail

deep

public CollectionMerger.Builder deep(boolean val)

Sets effectively infinite depth(int) (the default)

depth

public CollectionMerger.Builder depth(int val)

Depth 1 means a shallow copy - i.e. only looking one layer down (e.g. at the values within the top-level map). Depth 2 would mean going one-deep into the values inside the top-level map/list/set. Default is infinite. s * By default, depth only applies to nested maps. One needs to set mergeNestedLists(boolean) for it to do this to nested iterables.

mergeNestedMaps

@Deprecated
public CollectionMerger.Builder mergeNestedMaps(boolean val)

Deprecated. since 1.0, never did anything

mergeNestedLists

public CollectionMerger.Builder mergeNestedLists(boolean val)

By default lists will not be merged, and either the first or second will be kept depending on preferSecondOnConflict(boolean). Set this to true to cause lists in the second merge argument to be appended to lists in the first, or false for the default behaviour. For more complex behaviours use mergeNestedLists(BiFunction).

mergeNestedLists

public CollectionMerger.Builder mergeNestedLists(java.util.function.BiFunction<java.util.Collection<?>,java.util.Collection<?>,java.util.Collection<?>> listMergeFunction)

Defines a function to use to determine the result when lists or sets need merging.

preferSecondOnConflict

public CollectionMerger.Builder preferSecondOnConflict(boolean val)

defaults to false, so if there is an unmergeable conflict, e.g. two strings, the first will be kept

build

public CollectionMerger build()