https://github.com/mapteb/simple-state-machine

A simple Java state machine for Spring Boot projects
https://github.com/mapteb/simple-state-machine

finite-state-machine fsm java spring-boot state-machine statechart statemachine

Last synced: about 2 months ago
JSON representation

A simple Java state machine for Spring Boot projects

• Host: GitHub
• URL: https://github.com/mapteb/simple-state-machine
• Owner: mapteb
• Created: 2019-07-24T20:11:19.000Z (about 5 years ago)
• Default Branch: master
• Last Pushed: 2024-07-16T11:32:36.000Z (2 months ago)
• Last Synced: 2024-07-16T14:18:10.817Z (2 months ago)
• Topics: finite-state-machine, fsm, java, spring-boot, state-machine, statechart, statemachine
• Language: Java
• Homepage:
• Size: 15.2 MB
• Stars: 37
• Watchers: 5
• Forks: 26
• Open Issues: 1
• Metadata Files:
  • Readme: README.md

Awesome Lists containing this project

README

        
# simple-state-machine

A refactored versin of this exists in the [branch](https://github.com/mapteb/simple-state-machine/tree/refactor-1).

A simple state machine for Spring Boot projects

After importing into an IDE like STS can be run as Spring Boot application.

This project contains a framework and an illustration of the usage of the framework for a sample project like online order processing.

## Usage Workflow

|Initial State |Pre-event |   Processor    |        Post-event  |  Final State  |

| --- | --- | --- | --- | --- |  

|DEFAULT    ->|  submit ->| orderProcessor() ->| orderCreated   -> |PMTPENDING |

|PMTPENDING -> | pay    ->| paymentProcessor() ->| paymentError   -> |PMTPENDING |

|PMTPENDING ->|  pay    ->| paymentProcessor() ->| paymentSuccess ->| COMPLETED |

1. To use this framework first create a state transitions table like above.

2. Then implement the interfaces ProcessState and ProcessEvent.

See OrderState and OrderEvent classes for examples

3. Identify a primary key for the process. For the order process it would be orderId, for a time sheet application it would be userId-week-ending-date etc.

4. Implement the StateTransitionsManager. See the OrderStateTransitionsManager class for an example.

5. Implement the Processor class. See the OrderProcessor and the PaymentProcessor classes for examples.

6. Create a controller class. See the OrderController for an example.

### Unit Testing

Unit tests can be run using the "\gradlew test" command.

### Integration Testing

The application can be run using the ".\gradlew bootRun" command. For the order sample considered in this project, the following two APIs are created to test the order process:

 

1. User request to create an order. This API is implemented as GET so it can be tested quickly in the browser.

http://localhost:8080/order << creates an order and returns an orderId. Selected product ids are not included in this demo example  >>

2. User makes a payment. This API is also implemented as GET so it can be tested quickly in the browser.

http://localhost:8080/order/cart?payment=123&orderId=123 << where orderId is the UUID returned by the first API. Payment value less than 1.00 is considered for the error transition >>

<< for quick testing in a browser both of the above are implemented as GET APIs >>

When the above APIs are called the console log displays the state transitions that reflect the above table. (Note: payment=0 is used to mock payment error in this example)

## Related Projects

The ideas used in this project can also be adopted in Angular projects. See, for instance, https://github.com/mapteb/framework-for-angular-development