Class CommandHandlerWithReplyBuilder<Command,​State>


  • public final class CommandHandlerWithReplyBuilder<Command,​State>
    extends java.lang.Object
    • Constructor Detail

      • CommandHandlerWithReplyBuilder

        public CommandHandlerWithReplyBuilder()
    • Method Detail

      • forState

        public CommandHandlerWithReplyBuilderByState<Command,​State,​State> forState​(java.util.function.Predicate<State> statePredicate)
        Use this method to define command handlers that are selected when the passed predicate holds true.

        Note: command handlers are matched 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.

        Parameters:
        statePredicate - The handlers defined by this builder are used when the statePredicate is true

        Returns:
        A new, mutable, CommandHandlerWithReplyBuilderByState
      • forState

        public <S extends StateCommandHandlerWithReplyBuilderByState<Command,​S,​State> forState​(java.lang.Class<S> stateClass,
                                                                                                             java.util.function.Predicate<S> statePredicate)
        Use this method to define command handlers that are selected when the passed predicate holds true for a given subtype of your model. Useful when the model is defined as class hierarchy.

        Note: command handlers are matched 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.

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

        Returns:
        A new, mutable, CommandHandlerWithReplyBuilderByState
      • forStateType

        public <S extends StateCommandHandlerWithReplyBuilderByState<Command,​S,​State> forStateType​(java.lang.Class<S> stateClass)
        Use this method to define command handlers for a given subtype of your model. Useful when the model is defined as class hierarchy.

        Note: command handlers are matched 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.

        Parameters:
        stateClass - The handlers defined by this builder are used when the state is an instance of the stateClass.
        Returns:
        A new, mutable, CommandHandlerWithReplyBuilderByState
      • forNullState

        public CommandHandlerWithReplyBuilderByState<Command,​State,​State> forNullState()
        The handlers defined by this builder are used when the state is null. This variant is particular useful when the empty state of your model is defined as null.

        Note: command handlers are matched 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.

        Returns:
        A new, mutable, CommandHandlerWithReplyBuilderByState
      • forNonNullState

        public CommandHandlerWithReplyBuilderByState<Command,​State,​State> forNonNullState()
        The handlers defined by this builder are used for any not null state.

        Note: command handlers are matched 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.

        Returns:
        A new, mutable, CommandHandlerWithReplyBuilderByState
      • forAnyState

        public CommandHandlerWithReplyBuilderByState<Command,​State,​State> forAnyState()
        The handlers defined by this builder are used for any state. This variant is particular useful for models that have a single type (ie: no class hierarchy).

        Note: command handlers are matched 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 forAnyState() as it will match any state. Any command handler define after it will never be reached.

        Returns:
        A new, mutable, CommandHandlerWithReplyBuilderByState