Module is.codion.common.core

Package is.codion.common.state

Interface State

All Superinterfaces:

Consumer<Boolean>, EventObserver<Boolean>, StateObserver, Supplier<Boolean>, Value<Boolean>, ValueObserver<Boolean>

public interface State
extends StateObserver, Value<Boolean>

A class encapsulating a boolean state, non-nullable with null values translated to false.

 State state = State.state();

 StateObserver observer = state.observer();

 observer.addConsumer(this::onStateChange);

 state.set(true);
 state.set(false);
 state.clear(); //translates to false
 

A factory for State instances.

See Also:

• state()
• builder()

Nested Class Summary

Nested Classes

Modifier and Type	Interface	Description
static interface	State.Builder	Builds a State instance.
static interface	State.Combination	A state which combines a number of states, either ANDing or ORing those together when determining its own state.
static interface	State.Group	A State.Group deactivates all other states when a state in the group is activated.

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

Value.Notify, Value.Validator<T>

Method Summary

Modifier and Type	Method	Description
static State.Combination	and(StateObserver... stateObservers)	Creates a new State.Combination instance using Conjunction.AND.
static State.Combination	and(Collection<? extends StateObserver> stateObservers)	Creates a new State.Combination instance using Conjunction.AND.
static State.Builder	builder()
static State.Builder	builder(boolean value)
static State.Combination	combination(Conjunction conjunction, StateObserver... stateObservers)	Creates a new State.Combination instance.
static State.Combination	combination(Conjunction conjunction, Collection<? extends StateObserver> stateObservers)	Creates a new State.Combination instance.
static State.Group	group(State... states)	Creates a new State.Group instance, which guarantees that only a single state within the group is active at a time
static State.Group	group(Collection<State> states)	Creates a new State.Group instance, which guarantees that only a single state within the group is active at a time
StateObserver	observer()	Returns a StateObserver notified each time the state changes
static State.Combination	or(StateObserver... stateObservers)	Creates a new State.Combination instance using Conjunction.OR.
static State.Combination	or(Collection<? extends StateObserver> stateObservers)	Creates a new State.Combination instance using Conjunction.OR.
static State	state()	Creates a new 'false' State instance.
static State	state(boolean value)	Creates a new State instance.

Methods inherited from interface java.util.function.Consumer

andThen

Methods inherited from interface is.codion.common.event.EventObserver

addConsumer, addListener, addWeakConsumer, addWeakListener, removeConsumer, removeListener, removeWeakConsumer, removeWeakListener

Methods inherited from interface is.codion.common.state.StateObserver

not

Methods inherited from interface java.util.function.Supplier

get

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

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

Methods inherited from interface is.codion.common.value.ValueObserver

isEqualTo, isNotEqualTo, isNotNull, isNull, isNullable, optional

Method Details

observer

StateObserver observer()

Returns a StateObserver notified each time the state changes

Specified by:

observer in interface Value<Boolean>

Returns:

a StateObserver notified each time the state changes

state

static State state()

Creates a new 'false' State instance.

Returns:

a new State instance

state

static State state(boolean value)

Creates a new State instance.

Parameters:

value - the initial state value

Returns:

a new State instance

builder

static State.Builder builder()

Returns:

a new State.Builder instance

builder

static State.Builder builder(boolean value)

Parameters:

value - the initial value

Returns:

a new State.Builder instance

combination

static State.Combination combination(Conjunction conjunction,
 StateObserver... stateObservers)

Creates a new State.Combination instance.

Parameters:

conjunction - the conjunction to use

stateObservers - the state observers to base this state combination on

Returns:

a new State.Combination instance

combination

static State.Combination combination(Conjunction conjunction,
 Collection<? extends StateObserver> stateObservers)

Creates a new State.Combination instance.

Parameters:

conjunction - the conjunction to use

stateObservers - the state observers to base this state combination on

Returns:

a new State.Combination instance

and

static State.Combination and(StateObserver... stateObservers)

Creates a new State.Combination instance using Conjunction.AND.

Parameters:

stateObservers - the state observers to base this state combination on

Returns:

a new State.Combination instance

and

static State.Combination and(Collection<? extends StateObserver> stateObservers)

Creates a new State.Combination instance using Conjunction.AND.

Parameters:

stateObservers - the state observers to base this state combination on

Returns:

a new State.Combination instance

or

static State.Combination or(StateObserver... stateObservers)

Creates a new State.Combination instance using Conjunction.OR.

Parameters:

stateObservers - the state observers to base this state combination on

Returns:

a new State.Combination instance

or

static State.Combination or(Collection<? extends StateObserver> stateObservers)

Creates a new State.Combination instance using Conjunction.OR.

Parameters:

stateObservers - the state observers to base this state combination on

Returns:

a new State.Combination instance

group

static State.Group group(State... states)

Creates a new State.Group instance, which guarantees that only a single state within the group is active at a time

Parameters:

states - the states to add to the group initially, not required

Returns:

a new State.Group instance

See Also:

• State.Group

group

static State.Group group(Collection<State> states)

Creates a new State.Group instance, which guarantees that only a single state within the group is active at a time

Parameters:

states - the states to add to the group initially

Returns:

a new State.Group instance

See Also:

• State.Group