Module is.codion.common.reactive

Package is.codion.common.reactive.value

Interface ValueSet<T>

Type Parameters:

T - the value type

All Superinterfaces:

Iterable<T>, Observable<Set<T>>, ObservableValueCollection<T,Set<T>>, Observer<Set<T>>, Value<Set<T>>, ValueCollection<T,Set<T>>

public interface ValueSet<T>
extends ValueCollection<T,Set<T>>

An observable wrapper for an orderered Set of values.

A factory for ValueSet instances.

All implementations are thread-safe and support concurrent access.

This set maintains item ordering and can be sorted via ValueCollection.sort(Comparator), but note that sorting does not trigger change events, since item ordering does not factor into Set equality.

Nested Class Summary

Nested Classes

Modifier and Type	Interface	Description
static interface	ValueSet.Builder<T>	Builds a ValueSet instance.

Nested classes/interfaces inherited from interface is.codion.common.reactive.value.Value

Value.BuilderFactory, Value.Notify, Value.Validator<T>

Method Summary

Modifier and Type	Method	Description
static <T> ValueSet.Builder<T>	builder()	Creates a new ValueSet.Builder instance.
static <T> ValueSet.Builder<T>	builder(Collection<T> values)	Creates a new ValueSet.Builder instance.
ObservableValueSet<T>	observable()	Returns an ObservableValueCollection notified each time this value changes.
static <T> ValueSet<T>	valueSet()	Creates a new empty ValueSet, using Value.Notify.CHANGED.
static <T> ValueSet<T>	valueSet(Collection<T> values)	Creates a new ValueSet, using Value.Notify.CHANGED.

Methods inherited from interface java.lang.Iterable

forEach, iterator, spliterator

Methods inherited from interface is.codion.common.reactive.observer.Observable

addConsumer, addListener, addWeakConsumer, addWeakListener, getOrThrow, getOrThrow, is, isNot, isNull, observer, removeConsumer, removeListener, removeWeakConsumer, removeWeakListener, when, when

Methods inherited from interface is.codion.common.reactive.value.ObservableValueCollection

contains, containsAll, containsNone, containsOnly, isEmpty, size

Methods inherited from interface is.codion.common.reactive.value.Value

addValidator, clear, link, link, map, removeValidator, set, unlink, unlink, validate

Methods inherited from interface is.codion.common.reactive.value.ValueCollection

add, addAll, addAll, get, isNullable, optional, remove, removeAll, removeAll, set, sort, value

Method Details

observable

ObservableValueSet<T> observable()

Description copied from interface: ValueCollection

Returns an ObservableValueCollection notified each time this value changes.

Specified by:

observable in interface Value<T>

Specified by:

observable in interface ValueCollection<T,Set<T>>

Returns:

an ObservableValueCollection for this value

valueSet

static <T> ValueSet<T> valueSet()

Creates a new empty ValueSet, using Value.Notify.CHANGED.

Type Parameters:

T - the value type

Returns:

a new ValueSet

valueSet

static <T> ValueSet<T> valueSet(Collection<T> values)

Creates a new ValueSet, using Value.Notify.CHANGED.

Type Parameters:

T - the value type

Parameters:

values - the initial values, may not be null

Returns:

a new ValueSet

Throws:

NullPointerException - in case values is null

builder

static <T> ValueSet.Builder<T> builder()

Creates a new ValueSet.Builder instance.

Type Parameters:

T - the value set type

Returns:

a new builder

builder

static <T> ValueSet.Builder<T> builder(Collection<T> values)

Creates a new ValueSet.Builder instance.

Type Parameters:

T - the value set type

Parameters:

values - the initial values, may not be null

Returns:

a new builder

Throws:

NullPointerException - in case values is null