https://github.com/j-easy/easy-flows

The simple, stupid workflow engine for Java
https://github.com/j-easy/easy-flows

java workflow workflow-engine

Last synced: 3 months ago
JSON representation

The simple, stupid workflow engine for Java

• Host: GitHub
• URL: https://github.com/j-easy/easy-flows
• Owner: j-easy
• Created: 2017-05-18T19:07:19.000Z (over 7 years ago)
• Default Branch: master
• Last Pushed: 2023-09-13T15:09:21.000Z (about 1 year ago)
• Last Synced: 2024-06-28T10:36:34.424Z (5 months ago)
• Topics: java, workflow, workflow-engine
• Language: Java
• Homepage: https://github.com/j-easy/easy-flows/wiki
• Size: 184 KB
• Stars: 629
• Watchers: 39
• Forks: 212
• Open Issues: 6
• Metadata Files:
  • Readme: README.md

Awesome Lists containing this project

README

        
***



    Easy Flows


    The simple, stupid workflow engine for Java™





[![MIT license](http://img.shields.io/badge/license-MIT-brightgreen.svg?style=flat)](http://opensource.org/licenses/MIT)

[![Build Status](https://github.com/j-easy/easy-flows/workflows/Java%20CI/badge.svg)](https://github.com/j-easy/easy-flows/actions)

[![Maven Central](https://maven-badges.herokuapp.com/maven-central/org.jeasy/easy-flows/badge.svg?style=flat)](http://search.maven.org/#artifactdetails|org.jeasy|easy-flows|0.3|)

[![Javadoc](https://www.javadoc.io/badge/org.jeasy/easy-flows.svg)](http://www.javadoc.io/doc/org.jeasy/easy-flows)



***

## Latest news

* 08/10/2020: Easy Flows 0.3 has been released with a number of new features and improvements. You can find all details in the release notes [here](https://github.com/j-easy/easy-flows/releases).

## What is Easy Flows?

Easy Flows is a workflow engine for Java. It provides simple APIs and building blocks to make it easy to create and run composable workflows.

A unit of work in Easy Flows is represented by the `Work` interface. A work flow is represented by the `WorkFlow` interface.

Easy Flows provides 4 implementations of the `WorkFlow` interface:



    



Those are the only basic flows you need to know to start creating workflows with Easy Flows.

You don't need to learn a complex notation or concepts, just a few natural APIs that are easy to think about.

## How does it work?

First let's write some work:

```java

class PrintMessageWork implements Work {

    private String message;

    public PrintMessageWork(String message) {

        this.message = message;

    }

    public String getName() {

        return "print message work";

    }

    public WorkReport execute(WorkContext workContext) {

        System.out.println(message);

        return new DefaultWorkReport(WorkStatus.COMPLETED, workContext);

    }

}

```

This unit of work prints a given message to the standard output. Now let's suppose we want to create the following workflow:

1. print "foo" three times

2. then print "hello" and "world" in parallel

3. then if both "hello" and "world" have been successfully printed to the console, print "ok", otherwise print "nok"

This workflow can be illustrated as follows:



    



* `flow1` is a `RepeatFlow` of `work1` which is printing "foo" three times

* `flow2` is a `ParallelFlow` of `work2` and `work3` which respectively print "hello" and "world" in parallel

* `flow3` is a `ConditionalFlow`. It first executes `flow2` (a workflow is also a work), then if `flow2` is completed, it executes `work4`, otherwise `work5` which respectively print "ok" and "nok"

* `flow4` is a `SequentialFlow`. It executes `flow1` then `flow3` in sequence.

With Easy Flows, this workflow can be implemented with the following snippet:

```java

PrintMessageWork work1 = new PrintMessageWork("foo");

PrintMessageWork work2 = new PrintMessageWork("hello");

PrintMessageWork work3 = new PrintMessageWork("world");

PrintMessageWork work4 = new PrintMessageWork("ok");

PrintMessageWork work5 = new PrintMessageWork("nok");

ExecutorService executorService = Executors.newFixedThreadPool(2);

WorkFlow workflow = aNewSequentialFlow() // flow 4

        .execute(aNewRepeatFlow() // flow 1

                    .named("print foo 3 times")

                    .repeat(work1)

                    .times(3)

                    .build())

        .then(aNewConditionalFlow() // flow 3

                .execute(aNewParallelFlow() // flow 2

                            .named("print 'hello' and 'world' in parallel")

                            .execute(work2, work3)

                            .with(executorService)

                            .build())

                .when(WorkReportPredicate.COMPLETED)

                .then(work4)

                .otherwise(work5)

                .build())

        .build();

WorkFlowEngine workFlowEngine = aNewWorkFlowEngine().build();

WorkContext workContext = new WorkContext();

WorkReport workReport = workFlowEngine.run(workflow, workContext);

executorService.shutdown();

```

This is not a very useful workflow, but just to give you an idea about how to write workflows with Easy Flows.

You can find more details about all of this in the [wiki](https://github.com/j-easy/easy-flows/wiki).

## Why Easy Flows?

Easy Flows was created due to the lack of a simple open source workflow engine that can orchestrate `Callable/Runnable` Java objects.

Why every single workflow engine out there is trying to implement BPMN? There is nothing wrong with BPMN, but it is not easy

( [538 pages specification??](http://www.omg.org/spec/BPMN/2.0/PDF) ). Same thing for [BPEL](http://docs.oasis-open.org/wsbpel/2.0/OS/wsbpel-v2.0-OS.pdf)..

There are currently good workflow engines, but since they try to implement BPMN, they are not easy to use and are often misused.

Most of BPMN concepts are not essential to many applications, and building such applications on top of a heavy engine is not efficient.

Easy Flows tries to provide a simple alternative with natural APIs that are easy to think about along with basic flows that most small/medium sized

 applications would require. If your business process requires a A0 paper to be drawn down, Easy Flows is probably not the right choice for you.

## Contribution

You are welcome to contribute to the project with pull requests on GitHub.

If you found a bug or want to request a feature, please use the [issue tracker](https://github.com/j-easy/easy-flows/issues).

## Awesome contributors

* [jaredculp](https://github.com/jaredculp)

* [zhhaojie](https://github.com/zhhaojie)

Thank you for your contributions!

## License

Easy Flows is released under the terms of the MIT license:

```

The MIT License (MIT)

Copyright (c) 2020 Mahmoud Ben Hassine ([email protected])

Permission is hereby granted, free of charge, to any person obtaining a copy

of this software and associated documentation files (the "Software"), to deal

in the Software without restriction, including without limitation the rights

to use, copy, modify, merge, publish, distribute, sublicense, and/or sell

copies of the Software, and to permit persons to whom the Software is

furnished to do so, subject to the following conditions:

The above copyright notice and this permission notice shall be included in

all copies or substantial portions of the Software.

THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR

IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,

FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE

AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER

LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,

OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN

THE SOFTWARE.

```