目錄
activiti工作流demo,數據庫使用mysql,spring + mybatis + activiti。適合入門學習使用,把系統跑起來,流程走一遍,看數據庫內表數據的變化。
一、spring整合activiti
- pom.xml
<properties>
<activiti.version>5.22.0</activiti.version>
<spring.version>4.3.23.RELEASE</spring.version>
<jackson.version>2.7.5</jackson.version>
</properties>
<dependencies>
<dependency>
<groupId>com.fasterxml.jackson.core</groupId>
<artifactId>jackson-databind</artifactId>
<version>${jackson.version}</version>
</dependency>
<dependency>
<groupId>org.activiti</groupId>
<artifactId>activiti-modeler</artifactId>
<version>${activiti.version}</version>
</dependency>
<dependency>
<groupId>org.activiti</groupId>
<artifactId>activiti-engine</artifactId>
<version>${activiti.version}</version>
</dependency>
<dependency>
<groupId>org.activiti</groupId>
<artifactId>activiti-explorer</artifactId>
<version>${activiti.version}</version>
<exclusions>
<exclusion>
<groupId>org.vaadin.addons</groupId>
<artifactId>dcharts-widget</artifactId>
</exclusion>
</exclusions>
</dependency>
<dependency>
<groupId>org.activiti</groupId>
<artifactId>activiti-rest</artifactId>
<version>${activiti.version}</version>
</dependency>
<!--集成diagram-view跟蹤流程-->
<dependency>
<groupId>org.activiti</groupId>
<artifactId>activiti-diagram-rest</artifactId>
<version>${activiti.version}</version>
</dependency>
</dependencies>
- config.properties
#jdbc
jdbc_driverClassName=com.mysql.jdbc.Driver
jdbc_url=jdbc:mysql://127.0.0.1:3306/activiti?createDatabaseIfNotExist=true&useUnicode=true&characterEncoding=utf8
jdbc_username=root
jdbc_password=111111
validationQuery=SELECT 1
- ApplicationContext.xml
<?xml version="1.0" encoding="UTF-8"?>
<beans xmlns="http://www.springframework.org/schema/beans"
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xmlns:context="http://www.springframework.org/schema/context"
xmlns:tx="http://www.springframework.org/schema/tx"
xsi:schemaLocation="http://www.springframework.org/schema/beans
http://www.springframework.org/schema/beans/spring-beans-3.0.xsd
http://www.springframework.org/schema/context
http://www.springframework.org/schema/context/spring-context-3.0.xsd
http://www.springframework.org/schema/tx
http://www.springframework.org/schema/tx/spring-tx-3.0.xsd
">
<!-- 啓用註解 -->
<context:annotation-config />
<!-- 啓動組件掃描,排除@Controller組件,該組件由SpringMVC配置文件掃描 -->
<context:component-scan base-package="com.aaron.**.service">
<context:exclude-filter type="annotation"
expression="org.springframework.stereotype.Controller" />
</context:component-scan>
<bean id="propertyConfigurer" class="org.springframework.beans.factory.config.PropertyPlaceholderConfigurer">
<property name="locations">
<!--可以配置多個資源文件 -->
<list>
<value>classpath:config.properties</value>
</list>
</property>
<property name="fileEncoding">
<value>utf-8</value>
</property>
</bean>
<!-- 配置數據源 -->
<bean name="dataSource" class="com.alibaba.druid.pool.DruidDataSource"
init-method="init" destroy-method="close">
<property name="driverClassName" value="${jdbc_driverClassName}" />
<property name="url" value="${jdbc_url}" />
<property name="username" value="${jdbc_username}" />
<property name="password" value="${jdbc_password}" />
<!-- 初始化連接大小 -->
<property name="initialSize" value="0" />
<!-- 連接池最大使用連接數量 -->
<property name="maxActive" value="20" />
<!-- 連接池最小空閒 -->
<property name="minIdle" value="0" />
<!-- 獲取連接最大等待時間 -->
<property name="maxWait" value="60000" />
<property name="validationQuery" value="${validationQuery}" />
<property name="testOnBorrow" value="false" />
<property name="testOnReturn" value="false" />
<property name="testWhileIdle" value="true" />
<!-- 配置間隔多久才進行一次檢測,檢測需要關閉的空閒連接,單位是毫秒 -->
<property name="timeBetweenEvictionRunsMillis" value="60000" />
<!-- 配置一個連接在池中最小生存的時間,單位是毫秒 -->
<property name="minEvictableIdleTimeMillis" value="25200000" />
<!-- 打開removeAbandoned功能 -->
<property name="removeAbandoned" value="true" />
<!-- 1800秒,也就是30分鐘 -->
<property name="removeAbandonedTimeout" value="1800" />
<!-- 關閉abanded連接時輸出錯誤日誌 -->
<property name="logAbandoned" value="true" />
<!-- 監控數據庫 -->
<!-- <property name="filters" value="stat" /> -->
<property name="filters" value="mergeStat" />
</bean>
<bean id="transactionManager" class="org.springframework.jdbc.datasource.DataSourceTransactionManager">
<property name="dataSource" ref="dataSource"></property>
</bean>
<bean id="processEngineConfiguration" class="org.activiti.spring.SpringProcessEngineConfiguration">
<property name="dataSource" ref="dataSource" />
<!-- 設置建表策略,如果沒有表,自動創建表 -->
<property name="databaseSchemaUpdate" value="true" />
<property name="jobExecutorActivate" value="false"/>
<property name="history" value="full"/>
<!-- 配置事務管理器,統一事務 -->
<property name="transactionManager" ref="transactionManager" />
<property name="activityFontName" value="微軟雅黑" />
<property name="annotationFontName" value="微軟雅黑" />
<property name="labelFontName" value="微軟雅黑" />
</bean>
<!-- 創建流程引擎對象 -->
<bean id="processEngine" class="org.activiti.spring.ProcessEngineFactoryBean">
<property name="processEngineConfiguration" ref="processEngineConfiguration" />
</bean>
<!-- 由流程引擎對象,提供的方法,創建項目中使用的Activiti工作流的Service -->
<bean id="repositoryService" factory-bean="processEngine" factory-method="getRepositoryService" />
<bean id="runtimeService" factory-bean="processEngine" factory-method="getRuntimeService" />
<bean id="taskService" factory-bean="processEngine" factory-method="getTaskService" />
<bean id="historyService" factory-bean="processEngine" factory-method="getHistoryService" />
<bean id="formService" factory-bean="processEngine" factory-method="getFormService" />
<bean id="identityService" factory-bean="processEngine" factory-method="getIdentityService" />
<bean id="objectMapper" class="com.fasterxml.jackson.databind.ObjectMapper" />
<!--start mybatis配置-->
<!-- myBatis文件 -->
<bean id="sqlSessionFactory" class="org.mybatis.spring.SqlSessionFactoryBean">
<property name="dataSource" ref="dataSource" />
<property name="configLocation" value="classpath:mybatis-config.xml" />
<!-- 配置數據庫表對應的java實體類 -->
<property name="typeAliasesPackage" value="com.aaron.**.model" />
<!-- mapper掃描 -->
<property name="mapperLocations" value="classpath:com/aaron/**/*.xml" />
</bean>
<bean id="sqlSessionTemplate" class="org.mybatis.spring.SqlSessionTemplate" scope="prototype">
<constructor-arg ref="sqlSessionFactory" />
</bean>
<!--end mybatis配置-->
</beans>
- ApplicationContext-mvc.xml
<?xml version="1.0" encoding="UTF-8"?>
<beans xmlns="http://www.springframework.org/schema/beans"
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xmlns:aop="http://www.springframework.org/schema/aop"
xmlns:mvc="http://www.springframework.org/schema/mvc"
xmlns:context="http://www.springframework.org/schema/context"
xsi:schemaLocation=
"http://www.springframework.org/schema/beans
http://www.springframework.org/schema/beans/spring-beans-3.0.xsd
http://www.springframework.org/schema/mvc
http://www.springframework.org/schema/mvc/spring-mvc-3.2.xsd
http://www.springframework.org/schema/context
http://www.springframework.org/schema/context/spring-context-3.0.xsd
http://www.springframework.org/schema/aop
http://www.springframework.org/schema/aop/spring-aop-3.0.xsd"
>
<mvc:annotation-driven>
<mvc:message-converters>
<bean class="org.springframework.http.converter.StringHttpMessageConverter">
<constructor-arg value="UTF-8" />
</bean>
</mvc:message-converters>
</mvc:annotation-driven>
<mvc:default-servlet-handler/>
<!-- 掃描 -->
<context:component-scan base-package="com.aaron.**.controller">
<!--<context:exclude-filter type="annotation"
expression="org.springframework.stereotype.Service" />
<!–排除@Configuration註解,否則會被掃描到兩次–>
<context:exclude-filter type="annotation" expression="org.springframework.context.annotation.Configuration" />-->
</context:component-scan>
</beans>
- mybatis-config.xml
<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE configuration PUBLIC "-//mybatis.org//DTD SQL Map Config 3.0//EN"
"http://mybatis.org/dtd/mybatis-3-config.dtd">
<configuration>
<settings>
<setting name="cacheEnabled" value="true" /><!-- 全局映射器啓用緩存 -->
<setting name="useGeneratedKeys" value="true" />
<setting name="defaultExecutorType" value="REUSE" />
<setting name="logImpl" value="LOG4J"></setting>
<!-- map 保存 null 值 -->
<setting name="callSettersOnNulls" value="true"></setting>
<setting name="logImpl" value="Log4j"></setting>
<!--使用駝峯命名法轉換字段-->
<!--<setting name="mapUnderscoreToCamelCase" value="true" />-->
</settings>
</configuration>
二、動態創建流程
直接上代碼
@Autowired
private RepositoryService repositoryService;
@Autowired
private RuntimeService runtimeService;
@Autowired
private TaskService taskService;
/*任務節點*/
protected UserTask createUserTask(String id, String name, String candidateGroup) {
List<String> candidateGroups=new ArrayList<String>();
candidateGroups.add(candidateGroup);
UserTask userTask = new UserTask();
userTask.setName(name);
userTask.setId(id);
userTask.setCandidateGroups(candidateGroups);
return userTask;
}
/*連線*/
protected SequenceFlow createSequenceFlow(String from, String to, String name, String conditionExpression) {
SequenceFlow flow = new SequenceFlow();
flow.setSourceRef(from);
flow.setTargetRef(to);
flow.setName(name);
if(StringUtils.isNotEmpty(conditionExpression)){
flow.setConditionExpression(conditionExpression);
}
return flow;
}
/*排他網關*/
protected ExclusiveGateway createExclusiveGateway(String id) {
ExclusiveGateway exclusiveGateway = new ExclusiveGateway();
exclusiveGateway.setId(id);
return exclusiveGateway;
}
/*開始節點*/
protected StartEvent createStartEvent() {
StartEvent startEvent = new StartEvent();
startEvent.setId("startEvent");
return startEvent;
}
/*結束節點*/
protected EndEvent createEndEvent() {
EndEvent endEvent = new EndEvent();
endEvent.setId("endEvent");
return endEvent;
}
public void createProcess() throws IOException {
System.out.println(".........start...");
// 1. Build up the model from scratch
BpmnModel model = new BpmnModel();
Process process=new Process();
model.addProcess(process);
final String PROCESSID ="process01";
final String PROCESSNAME ="測試01";
process.setId(PROCESSID);
process.setName(PROCESSNAME);
process.addFlowElement(createStartEvent());
process.addFlowElement(createUserTask("task1", "節點01", "candidateGroup1"));
process.addFlowElement(createExclusiveGateway("createExclusiveGateway1"));
process.addFlowElement(createUserTask("task2", "節點02", "candidateGroup2"));
process.addFlowElement(createExclusiveGateway("createExclusiveGateway2"));
process.addFlowElement(createUserTask("task3", "節點03", "candidateGroup3"));
process.addFlowElement(createExclusiveGateway("createExclusiveGateway3"));
process.addFlowElement(createUserTask("task4", "節點04", "candidateGroup4"));
process.addFlowElement(createEndEvent());
process.addFlowElement(createSequenceFlow("startEvent", "task1", "", ""));
process.addFlowElement(createSequenceFlow("task1", "task2", "", ""));
process.addFlowElement(createSequenceFlow("task2", "createExclusiveGateway1", "", ""));
process.addFlowElement(createSequenceFlow("createExclusiveGateway1", "task1", "不通過", "${pass=='2'}"));
process.addFlowElement(createSequenceFlow("createExclusiveGateway1", "task3", "通過", "${pass=='1'}"));
process.addFlowElement(createSequenceFlow("task3", "createExclusiveGateway2", "", ""));
process.addFlowElement(createSequenceFlow("createExclusiveGateway2", "task2", "不通過", "${pass=='2'}"));
process.addFlowElement(createSequenceFlow("createExclusiveGateway2", "task4", "通過", "${pass=='1'}"));
process.addFlowElement(createSequenceFlow("task4", "createExclusiveGateway3", "", ""));
process.addFlowElement(createSequenceFlow("createExclusiveGateway3", "task3", "不通過", "${pass=='2'}"));
process.addFlowElement(createSequenceFlow("createExclusiveGateway3", "endEvent", "通過", "${pass=='1'}"));
// 2. Generate graphical information
new BpmnAutoLayout(model).execute();
// 3. Deploy the process to the engine
Deployment deployment = repositoryService.createDeployment().addBpmnModel(PROCESSID+".bpmn", model).name(PROCESSID+" Dynamic process deployment").deploy();
// 4. Start a process instance
ProcessInstance processInstance = runtimeService.startProcessInstanceByKey(PROCESSID);
// 5. Check if task is available
List<Task> tasks = taskService.createTaskQuery().processInstanceId(processInstance.getId()).list();
System.out.println(tasks.size());
// 6. Save process diagram to a file
InputStream processDiagram = repositoryService.getProcessDiagram(processInstance.getProcessDefinitionId());
FileUtils.copyInputStreamToFile(processDiagram, new File("target/"+PROCESSID+".png"));
// 7. Save resulting BPMN xml to a file
InputStream processBpmn = repositoryService.getResourceAsStream(deployment.getId(), PROCESSID+".bpmn");
FileUtils.copyInputStreamToFile(processBpmn,new File("target/"+PROCESSID+".bpmn"));
System.out.println(".........end...");
}
三、集成Activiti Modeler
- 下載源文件
activiti5.22.0源碼 - copy資源文件
解壓Activiti-master.zip,進入如下目錄
Activiti-master\modules\activiti-webapp-explorer2\src\main\webapp
複製editor-app,diagram-viewer文件夾,以及modele.html到本地項目的resources下。
3. 複製服務端文件
Activiti-master\modules\activiti-modeler\src\main\java\org\activiti\rest\editor
複製ModelEditorJsonRestResource.java,ModelSaveRestResource.java,StencilsetRestResource.java到控制層文件夾下
4. 修改editor-app/app-cfg.js文件中請求的地址
ACTIVITI.CONFIG = {
// 'contextRoot' : '/activiti-explorer/service',
'contextRoot' : '/activitidemo'
};
該請求的控制類爲ModelEditorJsonRestResource.java
@RequestMapping(value="/model/{modelId}/json", method = RequestMethod.GET, produces = "application/json")
- 拷貝stencilset.json到本地項目的resources下。
Activiti-master\modules\activiti-webapp-explorer2\src\main\resources\stencilset.json
- 跳轉方法
@Autowired
private RepositoryService repositoryService;
/**
* 新建一個空模型
*/
@RequestMapping(value = "/newModel")
public void newModel(HttpServletRequest request, HttpServletResponse response) {
//初始化一個空模型
Model model = repositoryService.newModel();
ObjectMapper objectMapper = new ObjectMapper();
//設置一些默認信息
String name = "new-process";
String description = "";
int revision = 1;
String key = "process";
try {
ObjectNode modelNode = objectMapper.createObjectNode();
modelNode.put(ModelDataJsonConstants.MODEL_NAME, name);
modelNode.put(ModelDataJsonConstants.MODEL_DESCRIPTION, description);
modelNode.put(ModelDataJsonConstants.MODEL_REVISION, revision);
model.setName(name);
model.setKey(key);
model.setMetaInfo(modelNode.toString());
repositoryService.saveModel(model);
String id = model.getId();
//完善ModelEditorSource
ObjectNode editorNode = objectMapper.createObjectNode();
editorNode.put("id", "canvas");
editorNode.put("resourceId", "canvas");
ObjectNode stencilSetNode = objectMapper.createObjectNode();
stencilSetNode.put("namespace",
"http://b3mn.org/stencilset/bpmn2.0#");
editorNode.put("stencilset", stencilSetNode);
repositoryService.addModelEditorSource(id,editorNode.toString().getBytes("utf-8"));
//跳轉到流程編輯頁面
response.sendRedirect(request.getContextPath() + "/modeler.html?modelId=" + id);
} catch (IOException e) {
e.printStackTrace();
}
}
創建一個新的空模型後帶上模型id重定向到modeler.html,編輯完成後保存即可。
四、整合diagram-viewer跟蹤流程
在第三節的基礎上做處理。
- 提取activiti-diagram-rest 包中(目錄如下)的四個文件放到controller目錄
Activiti-master\modules\activiti-diagram-rest\src\main\java\org\activiti\rest\diagram\services
- 配置監聽器,用戶處理callback回調函數
- 拷貝如下該目錄的FilterServletOutputStream.java、GenericResponseWrapper.java、JsonpCallbackFilter.java到目錄本地項目下:
Activiti-master\modules\activiti-webapp-explorer2\src\main\java\org\activiti\explorer\servlet
修改web.xml文件
<filter>
<filter-name>JSONPFilter</filter-name>
<filter-class>com.aaron.activiti.servlet.JsonpCallbackFilter</filter-class>
</filter>
<filter-mapping>
<filter-name>JSONPFilter</filter-name>
<url-pattern>/*</url-pattern>
</filter-mapping>
- 修改 diagram-viewer/index.html,把service去掉。
var baseUrl = window.document.location.protocol + "//" + window.document.location.host + "/";
var shortenedUrl = window.document.location.href.replace(baseUrl, "");
baseUrl = baseUrl + shortenedUrl.substring(0, shortenedUrl.indexOf("/"));
ActivitiRest.options = {
processInstanceHighLightsUrl: baseUrl + "/process-instance/{processInstanceId}/highlights?callback=?",
processDefinitionUrl: baseUrl + "/process-definition/{processDefinitionId}/diagram-layout?callback=?",
processDefinitionByKeyUrl: baseUrl + "/process-definition/{processDefinitionKey}/diagram-layout?callback=?"
};
- 修改 Diagram-viewer\js\ActivitiRest.js
- 在這裏要將ajax中原有的數據類型修改爲json,有三個地方需要改。
$.ajax({
url: url,
dataType: 'json',
cache: false,
……
})
- 啓動項目,顯示我的流程
http://localhost:8080/activitidemo/diagram-viewer/index.html?processDefinitionId=process:3:2527&processInstanceId=2528
五、demo源碼
六、遇到的問題
- 啓動流程後任務名稱中文亂碼,跟蹤流程時流程節點名稱亂碼
解決辦法:
- 發佈流程時指定編碼方式
Deployment deployment = repositoryService.createDeployment()
.name(modelData.getName())
.addString(processName, new String(bpmnBytes,"UTF-8")).deploy();
- 或者啓動加入啓動tomcat參數:-Dfile.encoding=“UTF-8”