Package akka.persistence.typed.javadsl

Class CommandHandlerBuilderByState<Command,Event,S extends State,State>

java.lang.Object

akka.persistence.typed.javadsl.CommandHandlerBuilderByState<Command,Event,S,State>

public final class CommandHandlerBuilderByState<Command,Event,S extends State,State>
extends java.lang.Object

Method Summary

Modifier and Type	Method	Description
CommandHandler<Command,Event,State>	build()	Builds and returns a handler from the appended states.
static <Command,Event,S extends State,State> CommandHandlerBuilderByState<Command,Event,S,State>	builder(java.lang.Class<S> stateClass)
static <Command,Event,State> CommandHandlerBuilderByState<Command,Event,State,State>	builder(java.util.function.Predicate<State> statePredicate)
CommandHandler<Command,Event,State>	onAnyCommand(java.util.function.BiFunction<S,Command,Effect<Event,State>> handler)	Matches any command.
CommandHandler<Command,Event,State>	onAnyCommand(java.util.function.Function<Command,Effect<Event,State>> handler)	Matches any command.
CommandHandler<Command,Event,State>	onAnyCommand(java.util.function.Supplier<Effect<Event,State>> handler)	Matches any command.
<C extends Command> CommandHandlerBuilderByState<Command,Event,S,State>	onCommand(java.lang.Class<C> commandClass, java.util.function.BiFunction<S,C,Effect<Event,State>> handler)	Matches commands that are of the given commandClass or subclass thereof
<C extends Command> CommandHandlerBuilderByState<Command,Event,S,State>	onCommand(java.lang.Class<C> commandClass, java.util.function.Function<C,Effect<Event,State>> handler)	Matches commands that are of the given commandClass or subclass thereof.
<C extends Command> CommandHandlerBuilderByState<Command,Event,S,State>	onCommand(java.lang.Class<C> commandClass, java.util.function.Supplier<Effect<Event,State>> handler)	Matches commands that are of the given commandClass or subclass thereof.
CommandHandlerBuilderByState<Command,Event,S,State>	onCommand(java.util.function.Predicate<Command> predicate, java.util.function.BiFunction<S,Command,Effect<Event,State>> handler)	Matches any command which the given predicate returns true for.
CommandHandlerBuilderByState<Command,Event,S,State>	onCommand(java.util.function.Predicate<Command> predicate, java.util.function.Function<Command,Effect<Event,State>> handler)	Matches any command which the given predicate returns true for.
<S2 extends State> CommandHandlerBuilderByState<Command,Event,S2,State>	orElse(CommandHandlerBuilderByState<Command,Event,S2,State> other)	Compose this builder with another builder.

Methods inherited from class java.lang.Object

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

Method Detail

builder

public static <Command,Event,S extends State,State> CommandHandlerBuilderByState<Command,Event,S,State> builder(java.lang.Class<S> stateClass)

Parameters:

stateClass - The handlers defined by this builder are used when the state is an instance of the stateClass

Returns:

A new, mutable, CommandHandlerBuilderByState

builder

public static <Command,Event,State> CommandHandlerBuilderByState<Command,Event,State,State> builder(java.util.function.Predicate<State> statePredicate)

Parameters:

statePredicate - The handlers defined by this builder are used when the statePredicate is true, useful for example when state type is an Optional

Returns:

A new, mutable, CommandHandlerBuilderByState

onCommand

public CommandHandlerBuilderByState<Command,Event,S,State> onCommand(java.util.function.Predicate<Command> predicate,
                                                                                       java.util.function.BiFunction<S,Command,Effect<Event,State>> handler)

Matches any command which the given predicate returns true for.

Note: command handlers are selected in the order they are added. Once a matching is found, it's selected for handling the command and no further lookup is done. Therefore you must make sure that their matching conditions don't overlap, otherwise you risk to 'shadow' part of your command handlers.

onCommand

public CommandHandlerBuilderByState<Command,Event,S,State> onCommand(java.util.function.Predicate<Command> predicate,
                                                                                       java.util.function.Function<Command,Effect<Event,State>> handler)

Matches any command which the given predicate returns true for.

Use this when the State is not needed in the handler, otherwise there is an overloaded method that pass the state in a BiFunction.

Note: command handlers are selected in the order they are added. Once a matching is found, it's selected for handling the command and no further lookup is done. Therefore you must make sure that their matching conditions don't overlap, otherwise you risk to 'shadow' part of your command handlers.

onCommand

public <C extends Command> CommandHandlerBuilderByState<Command,Event,S,State> onCommand(java.lang.Class<C> commandClass,
                                                                                                           java.util.function.BiFunction<S,C,Effect<Event,State>> handler)

Matches commands that are of the given commandClass or subclass thereof

Note: command handlers are selected in the order they are added. Once a matching is found, it's selected for handling the command and no further lookup is done. Therefore you must make sure that their matching conditions don't overlap, otherwise you risk to 'shadow' part of your command handlers.

onCommand

public <C extends Command> CommandHandlerBuilderByState<Command,Event,S,State> onCommand(java.lang.Class<C> commandClass,
                                                                                                           java.util.function.Function<C,Effect<Event,State>> handler)

Matches commands that are of the given commandClass or subclass thereof.

Use this when the State is not needed in the handler, otherwise there is an overloaded method that pass the state in a BiFunction.

Note: command handlers are selected in the order they are added. Once a matching is found, it's selected for handling the command and no further lookup is done. Therefore you must make sure that their matching conditions don't overlap, otherwise you risk to 'shadow' part of your command handlers.

onCommand

public <C extends Command> CommandHandlerBuilderByState<Command,Event,S,State> onCommand(java.lang.Class<C> commandClass,
                                                                                                           java.util.function.Supplier<Effect<Event,State>> handler)

Matches commands that are of the given commandClass or subclass thereof.

Use this when you just need to initialize the State without using any data from the command.

Note: command handlers are selected in the order they are added. Once a matching is found, it's selected for handling the command and no further lookup is done. Therefore you must make sure that their matching conditions don't overlap, otherwise you risk to 'shadow' part of your command handlers.

onAnyCommand

public CommandHandler<Command,Event,State> onAnyCommand(java.util.function.BiFunction<S,Command,Effect<Event,State>> handler)

Matches any command.

Use this to declare a command handler that will match any command. This is particular useful when encoding a finite state machine in which the final state is not supposed to handle any new command.

Note: command handlers are selected in the order they are added. Once a matching is found, it's selected for handling the command and no further lookup is done. Therefore you must make sure that their matching conditions don't overlap, otherwise you risk to 'shadow' part of your command handlers.

Extra care should be taken when using onAnyCommand(java.util.function.BiFunction<S,Command,akka.persistence.typed.javadsl.Effect<Event,State>>) as it will match any command. This method builds and returns the command handler since this will not let through any states to subsequent match statements.

Returns:

A CommandHandler from the appended states.

onAnyCommand

public CommandHandler<Command,Event,State> onAnyCommand(java.util.function.Function<Command,Effect<Event,State>> handler)

Matches any command.

Use this to declare a command handler that will match any command. This is particular useful when encoding a finite state machine in which the final state is not supposed to handle any new command.

Use this when you just need to return an Effect without using any data from the state.

Note: command handlers are selected in the order they are added. Once a matching is found, it's selected for handling the command and no further lookup is done. Therefore you must make sure that their matching conditions don't overlap, otherwise you risk to 'shadow' part of your command handlers.

Extra care should be taken when using onAnyCommand(java.util.function.BiFunction<S,Command,akka.persistence.typed.javadsl.Effect<Event,State>>) as it will match any command. This method builds and returns the command handler since this will not let through any states to subsequent match statements.

Returns:

A CommandHandler from the appended states.

onAnyCommand

public CommandHandler<Command,Event,State> onAnyCommand(java.util.function.Supplier<Effect<Event,State>> handler)

Matches any command.

Use this to declare a command handler that will match any command. This is particular useful when encoding a finite state machine in which the final state is not supposed to handle any new command.

Use this when you just need to return an Effect without using any data from the command or from the state.

Note: command handlers are selected in the order they are added. Once a matching is found, it's selected for handling the command and no further lookup is done. Therefore you must make sure that their matching conditions don't overlap, otherwise you risk to 'shadow' part of your command handlers.

Extra care should be taken when using onAnyCommand(java.util.function.BiFunction<S,Command,akka.persistence.typed.javadsl.Effect<Event,State>>) as it will match any command. This method builds and returns the command handler since this will not let through any states to subsequent match statements.

Returns:

A CommandHandler from the appended states.

orElse

public <S2 extends State> CommandHandlerBuilderByState<Command,Event,S2,State> orElse(CommandHandlerBuilderByState<Command,Event,S2,State> other)

Compose this builder with another builder. The handlers in this builder will be tried first followed by the handlers in other.

build

public CommandHandler<Command,Event,State> build()

Builds and returns a handler from the appended states. The returned CommandHandler will throw a MatchError if applied to a command that has no defined case.