# compileflow
**Repository Path**: gitxuchang/compileflow
## Basic Information
- **Project Name**: compileflow
- **Description**: compileflow是一个非常轻量、高性能、可集成、可扩展的流程引擎
- **Primary Language**: Java
- **License**: Apache-2.0
- **Default Branch**: master
- **Homepage**: https://www.oschina.net/p/compileflow
- **GVP Project**: No
## Statistics
- **Stars**: 0
- **Forks**: 50
- **Created**: 2022-09-04
- **Last Updated**: 2022-09-04
## Categories & Tags
**Categories**: Uncategorized
**Tags**: None
## README
# compileflow
📖 查看 [📖 英文版文档](README.md).
[](https://github.com/alibaba/compileflow/actions/workflows/ci.yaml)
[](https://ci.appveyor.com/project/oldratlee/compileflow)
[](https://search.maven.org/artifact/com.alibaba.compileflow/compileflow)
[](https://github.com/alibaba/compileflow/releases)
[](https://openjdk.java.net/)
[](https://www.apache.org/licenses/LICENSE-2.0.html)
[](https://github.com/alibaba/compileflow/stargazers)
[](https://github.com/alibaba/compileflow/fork)
[](https://github.com/alibaba/compileflow/issues)
[](https://github.com/alibaba/compileflow/graphs/contributors)
## 1. `compileflow`是什么
`compileflow`是一个非常轻量、高性能、可集成、可扩展的流程引擎。
`compileflow Process`引擎是淘宝工作流`TBBPM`引擎之一，是专注于纯内存执行，无状态的流程引擎，通过将流程文件转换生成`java`代码编译执行，简洁高效。当前是阿里业务中台交易等多个核心系统的流程引擎。
`compileflow`能让开发人员通过流程编辑器设计自己的业务流程，将复杂的业务逻辑可视化，为业务设计人员与开发工程师架起了一座桥梁。
## 2. Design Intention
1. 希望为业务开发提供端至端，从设计至实现的业务流程解决方案。
2. 提供多种流程引擎，实现从战略至商业能力，商业能力至业务流程，业务流程至系统，并最终实现业务的可视化全局架构。
3. 设计高效的执行引擎，实现对服务的快速组合或扩展，提升`idea`至`value`的研发响应与交互速度。
## 3. Features
1. 高性能：通过将流程文件转换生成`java`代码编译执行，简洁高效。
2. 丰富的应用场景：在阿里巴巴中台解决方案中广泛使用，支撑了导购、交易、履约、资金等多个业务场景。
3. 可集成：轻量、简洁的设计使得可以极其方便地集成到各个解决方案和业务场景中。
4. 完善的插件支持：流程设计目前有`IntelliJ IDEA`、`Eclipse`插件支持，可以在流程设计中实时动态生成`java`代码并预览，所见即所得。
5. 支持流程设计图导出`svg`文件和单元测试代码。
## 4. Quick Start
### Step1: 下载安装`IntelliJ IDEA`插件(可选)
插件下载地址：https://github.com/alibaba/compileflow-idea-designer
*安装说明：请使用`IntelliJ IDEA`本地安装方法进行安装，重新启动`IntelliJ IDEA`就会生效。*
### Step2: 引入`POM`文件
```xml
com.alibaba.compileflow
compileflow
1.2.0
```
可以在 [search.maven.org](https://search.maven.org/artifact/com.alibaba.compileflow/compileflow) 查看可用的版本。
**注意**: `compileflow`仅支持`JDK 1.8`及以上版本。
### Step3: 流程设计
下面以ktv demo为例，通过demo的演示和实践了解节点及属性的配置和`API`的使用。
demo描述：N个人去ktv唱歌，每人唱首歌，ktv消费原价为30元/人，如果总价超过300打九折，小于300按原价付款。
#### S3.1
创建`bpm`文件，如下图：
*注：`bpm`文件路径要和`code`保持一致，在文件加载模式下流程引擎执行时会根据`code`找到文件。*
#### S3.2
通过插件进行流程设计或者直接编写流程`xml`文件。
#### S3.3 调用流程
编写如下单元测试：
```java
public void testProcessEngine() {
final String code = "bpm.ktv.ktvExample";
final Map context = new HashMap<>();
final List pList = new ArrayList<>();
pList.add("wuxiang");
pList.add("xuan");
pList.add("yusu");
context.put("pList", pList);
final ProcessEngine processEngine = ProcessEngineFactory.getProcessEngine();
final TbbpmModel tbbpmModel = processEngine.load(code);
final OutputStream outputStream = TbbpmModelConverter.getInstance().convertToStream(tbbpmModel);
System.out.println(outputStream);
System.out.println(processEngine.getTestCode(code));
processEngine.preCompile(code);
System.out.println(processEngine.start(code, context));
}
```
**_`compileflow`原生只支持淘宝`BPM`规范，为兼容`BPMN 2.0`规范，做了一定适配，但仅支持部分`BPMN 2.0`元素，如需其他元素支持，可在原来基础上扩展。_**
## 5. 更多资料
* [DEMO快速开始](https://github.com/alibaba/compileflow/wiki/%E5%BF%AB%E9%80%9F%E5%BC%80%E5%A7%8BDEMO)
* [原始淘宝BPM规范详细说明](https://github.com/alibaba/compileflow/wiki/%E5%8D%8F%E8%AE%AE%E8%AF%A6%E8%A7%A3)
## 6. 欢迎加入`compileflow`开发群
1. 请钉钉联系 @余苏 @徐工 @梵度 @哲良 @无相
## Known Users
如果您在使用，请让我们知道，您的使用对我们非常重要。请在下面链接的issue中回复：https://github.com/alibaba/compileflow/issues/9
