當(dāng)前位置：首頁 > 编程资源 > 编程问答 >内容正文

编程问答

activiti 部署流程图后中文乱码

發(fā)布時(shí)間：2023/11/30 编程问答 29 豆豆

生活随笔收集整理的這篇文章主要介紹了 activiti 部署流程图后中文乱码小編覺得挺不錯(cuò)的,現(xiàn)在分享給大家,幫大家做個(gè)參考.

Activiti工作流引擎使用

1.簡(jiǎn)單介工作流引擎與Activiti

對(duì)于工作流引擎的解釋請(qǐng)參考百度百科：工作流引擎

1.1 我與工作流引擎

在第一家公司工作的時(shí)候主要任務(wù)就是開發(fā)OA系統(tǒng)，當(dāng)然基本都是有工作流的支持，不過當(dāng)時(shí)使用的工作流引擎是公司一些牛人開發(fā)的（據(jù)說是用一個(gè)開源的引擎修改的），名稱叫CoreFlow；功能相對(duì)Activiti來說比較弱，但是能滿足日常的使用，當(dāng)然也有不少的問題所以后來我們只能修改引擎的代碼打補(bǔ)丁。

現(xiàn)在是我工作的第二家公司，因?yàn)橐_發(fā)ERP、OA等系統(tǒng)需要使用工作流，在項(xiàng)目調(diào)研階段我先搜索資料選擇使用哪個(gè)開源工作流引擎，最終確定了Activiti5并基于公司的架構(gòu)做了一些DEMO。

回到頂部

1.2 Activiti與JBPM5？

對(duì)于Activiti、jBPM4、jBPM5我們應(yīng)該如何選擇，在InfoQ上有一篇文章寫的很好，從大的層面比較各個(gè)引擎之間的差異，請(qǐng)參考文章：縱觀jBPM：從jBPM3到j(luò)BPM5以及Activiti5

回到頂部

1.3 Activiti資料

官網(wǎng)：http://www.activiti.org/
下載：http://www.activiti.org/download.html
版本：Activiti的版本是從5開始的，因?yàn)锳ctiviti是使用jBPM4的源碼；版本發(fā)布：兩個(gè)月發(fā)布一次。
Eclipse Plugin:?http://activiti.org/designer/update/
Activit中文群：5435716

2.初次使用遇到問題收集

因?yàn)锳ctiviti剛剛退出不久所以資料比較空缺，中文資料更是少的可憐，所以開始的時(shí)候一頭霧水（雖然之前用過工作流，但是感覺差距很多），而且官方的手冊(cè)還不是很全面；所以我把我在學(xué)習(xí)使用的過程遇到的一些疑問都羅列出來分享給大家；以下幾點(diǎn)是我遇到和想到的，如果你還有什么疑問可以在評(píng)論中和我交流再補(bǔ)充。

回到頂部

2.1 部署流程圖后中文亂碼

亂碼是一直纏繞著國(guó)人的問題，之前各個(gè)技術(shù)、工具出現(xiàn)亂碼的問題寫過很多文章，這里也不例外……，Activiti的亂碼問題在流程圖中。

流程圖的亂碼如下圖所示：

解決辦法有兩種：

2.1.1 修改源代碼方式

修改源碼

org.activiti.engine.impl.bpmn.diagram.ProcessDiagramCanvas

在構(gòu)造方法

public ProcessDiagramCanvas(int width, int height) 中有一行代碼是設(shè)置字體的，默認(rèn)是用?Arial?字體，這就是亂碼產(chǎn)生的原因，把字改為本地的中文字體即可，例如：

Font font = new Font("WenQuanYi Micro Hei", Font.BOLD, 11);

當(dāng)然如果你有配置文件讀取工具那么可以設(shè)置在*.properties文件中，我就是這么做的：

Font font = new Font(PropertyFileUtil.get("activiti.diagram.canvas.font"), Font.BOLD, 11);

2.1.2 使用壓縮包方式部署

Activiti支持部署*.bpmn20.xml、bar、zip格式的流程定義。

使用Activit Deisigner工具設(shè)計(jì)流程圖的時(shí)候會(huì)有三個(gè)類型的文件:

.activiti設(shè)計(jì)工具使用的文件
.bpmn20.xml設(shè)計(jì)工具自動(dòng)根據(jù).activiti文件生成的xml文件
.png流程圖圖片

解決辦法就是把xml文件和圖片文件同時(shí)部署，因?yàn)樵趩为?dú)部署xml文件的時(shí)候Activiti會(huì)自動(dòng)生成一張流程圖的圖片文件，但是這樣在使用的時(shí)候坐標(biāo)和圖片對(duì)應(yīng)不起來……

所以把xml和圖片同時(shí)部署的時(shí)候Activiti自動(dòng)關(guān)聯(lián)xml和圖片，當(dāng)需要獲取圖片的時(shí)候直接返回部署時(shí)壓縮包里面的圖片文件，而不是Activiti自動(dòng)生成的圖片文件

2.1.2.1 使用工具打包Bar文件

右鍵項(xiàng)目名稱然后點(diǎn)擊“Create deployment artifacts”，會(huì)在src目錄中創(chuàng)建deployment文件夾，里面包含*.bar文件.

2.1.2.2 使用Ant腳本打包Zip文件

這也是我們采用的辦法，你可以手動(dòng)選擇xml和png打包成zip格式的文件，也可以像我們一樣采用ant target的方式打包這兩個(gè)文件。

<?xml version="1.0" encoding="UTF-8"?> <project name="foo"><property name="workflow.definition" value="foo-common-core/src/main/resources/diagrams" /><property name="workflow.deployments" value="foo-common-core/src/main/resources/deployments" /><target name="workflow.package.oa.leave"><echo>打包流程定義及流程圖::OA-請(qǐng)假</echo><zip destfile="${workflow.deployments}/oa/leave.zip" basedir="${workflow.definition}/oa/leave" update="true"includes="*.xml,*.png" /></target> </project>

這樣當(dāng)修改流程定義文件后只要運(yùn)行ant命令就可以打包了：

ant workflow.package.oa.leave

現(xiàn)在部署bar或者zip文件查看流程圖圖片就不是亂碼了，而是你的壓縮包里面的png文件。

回到頂部

2.2 使用引擎提供的Form還是自定義業(yè)務(wù)Form

2.2.1 引擎提供的Form

定義表單的方式在每個(gè)Task標(biāo)簽中定義extensionElements和activiti:formProperty即可，到達(dá)這個(gè)節(jié)點(diǎn)的時(shí)候可以通過API讀取表單元素。

Activiti官方的例子使用的就是在流程定義中設(shè)置每一個(gè)節(jié)點(diǎn)顯示什么樣的表單哪些字段需要顯示、哪些字段只讀、哪些字段必填。

但是這種方式僅僅適用于比較簡(jiǎn)單的流程，對(duì)于稍微復(fù)雜或者頁面需要業(yè)務(wù)邏輯的判斷的情況就不適用了。

對(duì)于數(shù)據(jù)的保存都是在引擎的表中，不利于和其他表的關(guān)聯(lián)、對(duì)整個(gè)系統(tǒng)的規(guī)劃也不利！

2.2.2 自定義業(yè)務(wù)Form

這種方式應(yīng)該是大家用的最多的了，因?yàn)橐话愕臉I(yè)務(wù)系統(tǒng)業(yè)務(wù)邏輯都會(huì)比較復(fù)雜，而且數(shù)據(jù)庫(kù)中很多表都會(huì)有依賴關(guān)系，表單中有很多狀態(tài)判斷。

例如我們的系統(tǒng)適用jQuery UI作為UI，有很多javascript代碼，頁面的很多操作需要特殊處理（例如：多個(gè)選項(xiàng)的互斥、每個(gè)節(jié)點(diǎn)根據(jù)類型和操作人顯示不同的按鈕）；基本每個(gè)公司都有一套自己的UI風(fēng)格，要保持多個(gè)系統(tǒng)的操作習(xí)慣一致只能使用自定義表單才能滿足。

回到頂部

2.3 業(yè)務(wù)和流程的關(guān)聯(lián)方式

這個(gè)問題在群里面很多人都問過，這也是我剛剛開始迷惑的地方；

后來看了以下API發(fā)現(xiàn)RuntimeService有兩個(gè)方法：

回到頂部

2.3.1 startProcessInstanceByKey

javadoc對(duì)其說明：

1 2	startProcessInstanceByKey(String processDefinitionKey, Map variabes) ??????????Starts a?new process instance in the latest version of the process definition with the given key

其中businessKey就是業(yè)務(wù)ID，例如要申請(qǐng)請(qǐng)假，那么先填寫登記信息，然后（保存+啟動(dòng)流程），因?yàn)檎?qǐng)假是單獨(dú)設(shè)計(jì)的數(shù)據(jù)表，所以保存后得到實(shí)體ID就可以把它傳給processInstanceBusinessKey方法啟動(dòng)流程。當(dāng)需要根據(jù)businessKey查詢流程的時(shí)候就可以通過API查詢:

1	runtimeService.createProcessInstanceQuery().processInstanceBusinessKey(processInstanceBusinessKey, processDefinitionKey);

建議數(shù)據(jù)庫(kù)冗余設(shè)計(jì)：在業(yè)務(wù)表設(shè)計(jì)的時(shí)候添加一列：PROCESS_INSTANCE_ID varchar2(64)，在流程啟動(dòng)之后把流程ID更新到業(yè)務(wù)表中，這樣不管從業(yè)務(wù)還是流程都可以查詢到對(duì)方！

特別說明：?此方法啟動(dòng)時(shí)自動(dòng)選擇最新版本的流程定義。

回到頂部

2.3.2 startProcessInstanceById

javadoc對(duì)其說明：

1 2	startProcessInstanceById(String processDefinitionId, String businessKey, Map variables) ??????????Starts a?new process instance in the exactly specified version of the process definition with the given id.

processDefinitionId：這個(gè)參數(shù)的值可以通過repositoryService.createProcessDefinitionQuery()方法查詢，對(duì)應(yīng)數(shù)據(jù)庫(kù)：ACT_RE_PROCDEF；每次部署一次流程定義就會(huì)添加一條數(shù)據(jù)，同名的版本號(hào)累加。

特別說明：?此可以指定不同版本的流程定義，讓用戶多一層選擇。

回到頂部

2.3.3 如何選擇

建議使用startProcessInstanceByKey，特殊情況需要使用以往的版本選擇使用startProcessInstanceById。

回到頂部

2.4 同步用戶數(shù)據(jù)

這個(gè)問題也是比較多的人詢問過，Activiti支持對(duì)任務(wù)分配到：指定人、指定組、兩者組合，而這些人和組的信息都保存在ACT_ID..表中，有自己的用戶和組(角色)管理讓很多人不知所措了；原因是因?yàn)槊總€(gè)系統(tǒng)都會(huì)存在一個(gè)權(quán)限管理模塊（維護(hù)：用戶、部門、角色、授權(quán)），不知道該怎么和Activiti同步。

2.4.1 建議處理方式

Activiti有一個(gè)IdentityService接口，通過這個(gè)接口可以操控Activiti的ACT_ID_*表的數(shù)據(jù)，一般的做法是用業(yè)務(wù)系統(tǒng)的權(quán)限管理模塊維護(hù)用戶數(shù)據(jù)，當(dāng)進(jìn)行CRUD操作的時(shí)候在原有業(yè)務(wù)邏輯后面添加同步到Activiti的代碼；例如添加一個(gè)用戶時(shí)同步Activiti User的代碼片段：

 1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 

   /**  ?* 保存用戶信息 并且同步用戶信息到activiti的identity.User，同時(shí)設(shè)置角色  ?* @param user  ?* @param roleIds  ?*/  public  void  saveUser(User user, List<Long> roleIds,?boolean  synToActiviti) {  ????accountManager.saveEntity(user);  ????String userId = user.getId().toString();   ????if  (synToActiviti) {  ????????List<org.activiti.engine.identity.User> activitiUsers = identityService.createUserQuery().userId(userId).list();  ????????if  (activitiUsers.size() ==?1) {  ????????????//更新信息  ????????????org.activiti.engine.identity.User activitiUser = activitiUsers.get(0);  ????????????activitiUser.setFirstName(user.getName());  ????????????activitiUser.setLastName("");  ????????????activitiUser.setPassword(user.getPassword());  ????????????activitiUser.setEmail(user.getEmail());  ????????????identityService.saveUser(activitiUser);   ????????????// 刪除用戶的membership  ????????????List<Group> activitiGroups = identityService.createGroupQuery().groupMember(userId).list();  ????????????for  (Group group : activitiGroups) {  ????????????????identityService.deleteMembership(userId, group.getId());  ????????????}   ????????????// 添加membership  ????????????for  (Long roleId : roleIds) {  ????????????????Role role = roleManager.getEntity(roleId);  ????????????????identityService.createMembership(userId, role.getEnName());  ????????????}   ????????}?else  {  ????????????org.activiti.engine.identity.User newUser = identityService.newUser(userId);  ????????????newUser.setFirstName(user.getName());  ????????????newUser.setLastName("");  ????????????newUser.setPassword(user.getPassword());  ????????????newUser.setEmail(user.getEmail());  ????????????identityService.saveUser(newUser);   ????????????// 添加membership  ????????????for  (Long roleId : roleIds) {  ????????????????Role role = roleManager.getEntity(roleId);  ????????????????identityService.createMembership(userId, role.getEnName());  ????????????}  ????????}  ????}   }  

刪除操作也和這個(gè)類似！

不管從業(yè)務(wù)系統(tǒng)維護(hù)用戶還是從Activiti維護(hù)，肯定要確定一方，然后CRUD的時(shí)候同步到對(duì)方，如果需要同步多個(gè)子系統(tǒng)那么可以再調(diào)用WebService實(shí)現(xiàn)。

回到頂部

2.5 流程圖設(shè)計(jì)工具用什么

Activiti提供了兩個(gè)流程設(shè)計(jì)工具，但是面向?qū)ο蟛煌?/p>

Activiti Modeler，面向業(yè)務(wù)人員，使用開源的BPMN設(shè)計(jì)工具Signavio，使用BPMN描述業(yè)務(wù)流程圖
Eclipse Designer，面向開發(fā)人員，Eclipse的插件，可以讓開發(fā)人員定制每個(gè)節(jié)點(diǎn)的屬性（ID、Name、Listener、Attr等）

2.5.1 我們的方式

可能你會(huì)驚訝，因?yàn)槲覀儧]有使用Activiti Modeler，我們認(rèn)為用Viso已經(jīng)能表達(dá)流程圖的意思了，而且項(xiàng)目經(jīng)理也是技術(shù)出身，和開發(fā)人員也容易溝通。

目前這個(gè)項(xiàng)目是第一個(gè)使用Activiti的，開始我們?cè)谛枨笳{(diào)研階段使用Viso設(shè)計(jì)流程圖，利用泳道流程圖設(shè)計(jì)和客戶溝通，確定后由負(fù)責(zé)流程的開發(fā)人員用Eclipse Designer設(shè)計(jì)得到bpmn20.xml，最后部署。

回到頂部

2.6 Eclipse Designer存在的問題

這個(gè)插件有一個(gè)很討厭的Bug一直未修復(fù)，安裝了插件后Eclipse的復(fù)制和粘帖快捷鍵會(huì)被更換為(Ctrl+Insert、Shift+Insert)；Bug描述請(qǐng)見：

Activit Forums中報(bào)告的Bug
Jira的登記

所以最后我們只能單獨(dú)開一個(gè)安裝了Eclipse Designer的Eclipse專門用來設(shè)計(jì)流程圖，這樣就不影響正常使用Eclipse JAVAEE了。

3.配置

回到頂部

3.1 集成Spring

對(duì)于和Spring的集成Activiti做的不錯(cuò)，簡(jiǎn)單配置一些Bean代理即可實(shí)現(xiàn)，但是有兩個(gè)和事務(wù)相關(guān)的地方要提示：

配置processEngineConfiguration的時(shí)候?qū)傩?span style="padding:0px; margin:0px">transactionManager要使用和業(yè)務(wù)功能的同一個(gè)事務(wù)管理Bean，否則事務(wù)不同步。

對(duì)于實(shí)現(xiàn)了org.activiti.engine.delegate包中的接口的類需要被事務(wù)控制的實(shí)現(xiàn)類需要被Spring代理，并且添加事務(wù)的Annotation或者在xml中配置，例如:

 1 2 3 4 5 6 7 8 9 10 

   /**  ?* 創(chuàng)建繳費(fèi)流程的時(shí)候自動(dòng)創(chuàng)建實(shí)體  ?*  ?* @author HenryYan  ?*/  @Service  @Transactional  publicclass CreatePaymentProcessListener implementsExecutionListener {  ???....  }  

4.使用單元測(cè)試

單元測(cè)試均使用Spring的AbstractTransactionalJUnit4SpringContextTests作為SuperClass，并且在測(cè)試類添加：

1 2	@ContextConfiguration(locations = {?"/applicationContext-test.xml"}) @RunWith(SpringJUnit4ClassRunner.class)

雖然Activiti也提供了測(cè)試的一些超類，但是感覺不好用，所以自己封裝了一些方法。

代碼請(qǐng)轉(zhuǎn)移：https://gist.github.com/2182847

回到頂部

4.1 驗(yàn)證流程圖設(shè)計(jì)是否正確

代碼請(qǐng)轉(zhuǎn)移：https://gist.github.com/2182869

回到頂部

4.2 業(yè)務(wù)對(duì)象和流程關(guān)聯(lián)測(cè)試

代碼請(qǐng)轉(zhuǎn)移：https://gist.github.com/2182973

5.各種狀態(tài)的任務(wù)查詢以及和業(yè)務(wù)對(duì)象關(guān)聯(lián)

我們目前分為4中狀態(tài)：未簽收、辦理中、運(yùn)行中、已完成。

查詢到任務(wù)或者流程實(shí)例后要顯示在頁面，這個(gè)時(shí)候需要添加業(yè)務(wù)數(shù)據(jù)，最終結(jié)果就是業(yè)務(wù)和流程的并集，請(qǐng)參考6.2。

回到頂部

5.1 未簽收(Task)

此類任務(wù)針對(duì)于把Task分配給一個(gè)角色時(shí)，例如部門領(lǐng)導(dǎo)，因?yàn)?span style="padding:0px; margin:0px; color:rgb(64,64,64)">部門領(lǐng)導(dǎo)角色可以指定多個(gè)人所以需要先簽收再辦理，術(shù)語：搶占式

對(duì)應(yīng)的API查詢：

 1 2 3 4 5 6 7 8 9 10 

   /**  ?* 獲取未簽收的任務(wù)查詢對(duì)象  ?* @param userId??? 用戶ID  ?*/  @Transactional(readOnly =?true)  publicTaskQuery createUnsignedTaskQuery(String userId) {  ????TaskQuery taskCandidateUserQuery = taskService.createTaskQuery().processDefinitionKey(getProcessDefKey())  ????????????.taskCandidateUser(userId);  ????returntaskCandidateUserQuery;  }  

回到頂部

5.2 辦理中(Task)

此類任務(wù)數(shù)據(jù)類源有兩種:

簽收后的，5.1中簽收后就應(yīng)該為辦理中狀態(tài)
節(jié)點(diǎn)指定的是具體到一個(gè)人，而不是角色

對(duì)應(yīng)的API查詢：

 1 2 3 4 5 6 7 8 9 

   /**  ?* 獲取正在處理的任務(wù)查詢對(duì)象  ?* @param userId??? 用戶ID  ?*/  @Transactional(readOnly =?true)  publicTaskQuery createTodoTaskQuery(String userId) {  ????TaskQuery taskAssigneeQuery = taskService.createTaskQuery().processDefinitionKey(getProcessDefKey()).taskAssignee(userId);  ????returntaskAssigneeQuery;  }  

回到頂部

5.3 運(yùn)行中(ProcessInstance)

說白了就是沒有結(jié)束的流程，所有參與過的人都應(yīng)該可以看到這個(gè)實(shí)例，但是Activiti的API沒有可以通過用戶查詢的方法，這個(gè)只能自己用hack的方式處理了，我目前還沒有處理。

從表ACT_RU_EXECUTION中查詢數(shù)據(jù)。

對(duì)應(yīng)的API查詢：

 1 2 3 4 5 6 7 8 9 10 

   /**  ?* 獲取未經(jīng)完成的流程實(shí)例查詢對(duì)象  ?* @param userId??? 用戶ID  ?*/  @Transactional(readOnly =?true)  publicProcessInstanceQuery createUnFinishedProcessInstanceQuery(String userId) {  ????ProcessInstanceQuery unfinishedQuery = runtimeService.createProcessInstanceQuery().processDefinitionKey(getProcessDefKey())  ????????????.active();  ????returnunfinishedQuery;  }  

回到頂部

5.4 已完成(HistoricProcessInstance)

已經(jīng)結(jié)束的流程實(shí)例。

從表ACT_HI_PROCINST中查詢數(shù)據(jù)。

 1 2 3 4 5 6 7 8 9 10 

   /**  ?* 獲取已經(jīng)完成的流程實(shí)例查詢對(duì)象  ?* @param userId??? 用戶ID  ?*/  @Transactional(readOnly =?true)  publicHistoricProcessInstanceQuery createFinishedProcessInstanceQuery(String userId) {  ????HistoricProcessInstanceQuery finishedQuery = historyService.createHistoricProcessInstanceQuery()  ????????????.processDefinitionKey(getProcessDefKey()).finished();  ????returnfinishedQuery;  }  

回到頂部

5.5 查詢時(shí)和業(yè)務(wù)關(guān)聯(lián)

提示：之前在業(yè)務(wù)對(duì)象添加了PROCESS_INSTANCE_ID字段

思路：現(xiàn)在可以利用這個(gè)字段查詢了，不管是Task還是ProcessInstance都可以得到流程實(shí)例ID，可以根據(jù)流程實(shí)例ID查詢實(shí)體然后把流程對(duì)象設(shè)置到實(shí)體的一個(gè)屬性中由Action或者Controller輸出到前臺(tái)。

代碼請(qǐng)參考：https://gist.github.com/2183557

6.UI及截圖

結(jié)合實(shí)際業(yè)務(wù)描述一個(gè)業(yè)務(wù)從開始到結(jié)束的過程，對(duì)于迷惑的同學(xué)看完豁然開朗了；這里使用請(qǐng)假作為例子。

回到頂部

6.1 單獨(dú)一個(gè)列表負(fù)責(zé)申請(qǐng)

這樣的好處是申請(qǐng)和流程辦理分離開處理，列表顯示未啟動(dòng)流程的請(qǐng)假記錄（數(shù)據(jù)庫(kù)PROCESS_INSTANCE_ID為空）。

申請(qǐng)界面的截圖：

回到頂部

6.2 流程狀態(tài)

回到頂部

6.3 流程跟蹤

圖片方式顯示當(dāng)前節(jié)點(diǎn)：

列表形式顯示流程流轉(zhuǎn)過程:

6.3.1 當(dāng)前節(jié)點(diǎn)定位JS

Java代碼請(qǐng)移步：https://gist.github.com/2183712

Javascript思路：先通過Ajax獲取當(dāng)前節(jié)點(diǎn)的坐標(biāo)，在指定位置添加紅色邊框，然后加載圖片。

代碼移步：https://gist.github.com/2183804

7.開啟Logger

添加log4j的jar

設(shè)置log4j.logger.java.sql=DEBUG

8.結(jié)束

之前就想寫這篇文章，現(xiàn)在終于完成了，花費(fèi)了幾個(gè)小時(shí)，希望能節(jié)省你幾天的時(shí)間。

請(qǐng)讀者仔細(xì)閱讀Activiti的用戶手冊(cè)和Javadoc。

總結(jié)

以上是生活随笔為你收集整理的activiti 部署流程图后中文乱码的全部?jī)?nèi)容，希望文章能夠幫你解決所遇到的問題。

如果覺得生活随笔網(wǎng)站內(nèi)容還不錯(cuò)，歡迎將生活随笔推薦給好友。

上一篇：基于easyui开发Web版Activi
下一篇：初识Activiti