Reopen a todo #2

Closed
codeliner opened this Issue May 4, 2015 · 0 comments

Comments

Projects
None yet
1 participant
@codeliner
Member

codeliner commented May 4, 2015

Depends on #1

Step By Step Guide

  1. Create a dedicated command for the action called ReopenTodo and put it into the todo command folder
  2. Create a command handler for the new command
    • Create a factory for the command handler and put it here
    • The command handler needs to fetch an existing Todo from the TodoList so inject the TodoList as dependency into the command handler using the factory
    • Make the command handler available in the container by using the command handler FQCN as service name and point it to the factory. See configuration for the PostTodoCommandHandler as an example
  3. Now you can route the command to its handler
    • Route the http request representing the command to the Commanding\API.
      You can do this in the routes configuration.
    • The API will translate the request into a command message and dispatch the message on the command bus. The command bus is responsible to locate and invoke the responsible command handler. To do so the command bus also need some route information.
  4. In the command handler you should load the effected Todo from the TodoList
  5. The Todo aggregate root is responsible for handling the action so it needs a new method.
    • In the method the Todo should check it's current status. Only if it is done it can be marked as open again otherwise it should throw an exception
    • If the precondition is met the Todo should not change it's state directly but instead record a new domain event called TodoWasReopened
    • Add a state changing method in the Todo aggregate root based on the new event. Call the method whenTodoWasReopened and require the recorded event as a input parameter then change the TodoStatus to open
  6. The same event needs also be handled by a projector so that the read model gets updated. You already know how to route a command message to a handler. Now do the same for the event and route it to a projector which updates the read model table.

Bonus Points: Write at least one unit test which covers that a done Todo can change its state to open again and records a TodoWasReopened event to track the change.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment