gmorel/state-workflow-demo

, _(*1)

State Workflow Demo

Helping you implementing a complex yet easily maintainable workflow.

Keywords : State Design Pattern, Workflow, Finite State Machine, Symfony2, _(*2)

A demonstration project for StateWorkflowBundle., _(*3)

, _(*4)

Context

A Booking Entity being first incomplete, then waiting for payment, then paid then to delete or cancelled. - State : BookingStateInterface instance - Transition : BookingStateInterface method, _(*5)

State declaration

The following States are all implementing BookingStateInterface - StateIncomplete - StateCancelled - StateWaitingPayment - StatePaid - StateToDelete, _(*6)

Default transitions - disabled

All available transitions are defined in BookingStateInterface, _(*7)

interface BookingStateInterface extends StateInterface
{
    public function setBookingAsWaitingForPayment(HasStateInterface $booking);
    public function setBookingAsPaid(HasStateInterface $booking);
    public function cancelBooking(HasStateInterface $booking);
    public function setBookingToBeDeleted(HasStateInterface $booking);
}

All States are implementing AbstractBookingState. Hence all transitions are disabled by default because of, _(*8)

throw $this->buildUnsupportedTransitionException(__METHOD__, $booking);

Enabled transitions

Transitions are enabled when a BookingStateInterface transition method is overridden., _(*9)

public function setBookingAsPaid(HasStateInterface $booking)
{
    $newState = $this->getStateFromStateId(StatePaid::KEY, __METHOD__, $booking);
    if ($newState) {
        $booking->changeState($this->getStateWorkflow(), $newState);

        // Implement necessary relevant transition here
    }

    return $newState;
}

Inside these transition methods you can do what ever your want. And since each State is a service. You can inject whatever you want. - Log - Event Sourcing - Assertion - Send mail - etc.., _(*10)

Examples

Here is the generated Workflow Specification generated using the SpecGen command CLI sf spec-gen:state-workflow:generate-specifications : - Simple workflow demo.booking_engine.state_workflow.html - More complex workflow demo.quote_engine.state_workflow.html, _(*11)

Cytoscape generates the workflow layout randomly. If the layout doesn't suit well, refresh. Don't hesitate to drag and drop., _(*12)