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.

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:

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:

…

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.

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?? ). Same thing for BPEL..

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.

Awesome contributors

• jaredculp
• zhhaojie

Thank you for your contributions!

License

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

…