最近發現這篇文章挺多人看的，也挺多人有疑問，我很想幫你們解答，但是很無奈，這篇文章只是我當時在自學時看的一個教程的記錄，當時對JBPM也沒有深入去學習，並且到現在也已經快4年了，這期間我都沒用過JBPM，因此JBPM的東西我也忘得差不多了。慶幸的是我把當時看的教程儲存了下來，因此如果對此文章有疑問的可以直接看我下面連結的教程。另外，通過我分享的視訊大家也能看到這是一個OA教程，我當時剛入門自學Java時就看過這個教程，我自己覺得是一個很不錯的教程，特別適合新手，因此如果你想要關於這個OA教程的其他內容，可以在文章下面留下你的郵箱或者私信我，我看到後會把教程連結發給你。    

作者更新於2018-02-10

工作流視訊教程：連結：https://pan.baidu.com/s/1bqf6kaz 密碼：thlt

概念：

流程圖的組成：

a. 活動 Activity / 節點 Node

b. 流轉 Transition / 連線（單向箭頭）

c. 事件

1.流轉(Transition)

a) 一般情況一個活動中可以指定一個或多個Transition

i. 開始活動(Start)中只能有一個Transition。

ii. 結束活動(End)中沒有Transition。

iii. 其他活動中有一條或多條Transition

b) 如果Transition只有一個，則可以不指定名稱（名稱是null）；如果有多個，則要分別指定唯一的名稱。

2.活動(Activity)

a) 流轉控制活動(預定義活動)

i. start開始活動

代表流程的開始邊界，一個流程有且只能有一個Start活動。開始活動只能指定一個Transition。在流程例項啟動後，會 自動的使用這個唯一的Transition離開開始活動，到一下個活動。

ii. end/end-error/end-cancel(結束活動)

代表流程的結束邊界，可以有多個，也可以沒有。如果有多個，則到達任一個結束活動，整個流程就都結束了；如果沒 有，則到達最後那個沒有Transition的活動，流程就結束了。

iii. state狀態活動

作用：等待。可以使用signal使其結束等待，並向後執行一步。

iv. task任務活動

-->

個人任務的分配

1. 使用流程變數：assignee="#{manager}"

2. AssignmentHandler：assignable.setAssignee(userId); // 指定當前任務的辦理人(分配任務)

a) 需要在.jbdl.xml的<task>元素中寫

<assignment-handler class="cn.grace.AssignmentHandlerImpl"/>

b) 指定的AssignmentHandlerImpl類要實現AssignmentHandler介面

c) 在AssignmentHandlerImpl類中可以使用assignable.setAssignee(userId)，分配個人任務。

3. TaskService.assignTask(taskId, userId)// 把指定的任務分配給指定的人

processEngine.getTaskService().assignTask(taskId, userId);

-->組任務的分配

1.  使用流程變數：assignee="#{userIdsString}" // 要是String型的變數，多個候選人之前用','隔開

2. AssignmentHandler：assignable.addCandidateUser(userId);// 新增組任務的候選人

a) 需要在.jbdl.xml的<task>元素中寫

<assignment-handler class="cn.grace.GroupTaskAssignmentHandlerImpl"/>

b) 指定的AssignmentHandlerImpl類要實現AssignmentHandler介面

c) 在AssignmentHandlerImpl類中可以使用assignable.addCandidateUser(userId)，新增組任務候選人。

3. TaskService.addTaskParticipatingUser(taskId,userId,Participation.CANDIDATE);//新增組任務的候選人 

v. Decision判斷活動

1. 使用expression，如：expr="#{'to state2'}"

2. 使用Handler，在Handler Class裡配置指定的DecisionHandlerImpl類的路徑

DecisionHandlerImpl.java

public class DecisionHandlerImpl implements DecisionHandler {

	// 計算離開當前節點用的Transition的名稱並返回
	@Override
	public String decide(OpenExecution execution) {
		System.out.println("DecisionHandlerImpl.decide()");
		// 獲取業務資料
		Integer days = (Integer) execution.getVariable("請假天數");
		// 選擇Transition
		if (days > 7) {
			return "to 總經理審批";
		} else {
			return "to end1";
		}
	}
}

ProcessTest.java

@Test
public void test() {
	// 1，部署流程定義
	InputStream in = this.getClass().getResourceAsStream("test.jpdl.xml"); // 當前類所在包中的檔案
	processEngine.getRepositoryService()//
			.createDeployment()//
			.addResourceFromInputStream("test.jpdl.xml", in)//
			.deploy();

	// 2，啟動流程例項
	Map<String, Object> variables = new HashMap<String, Object>();
	// variables.put("請假天數", 10);啟動流程例項後,進行到to 總經理審批環節。
	variables.put("請假天數", 3);//啟動流程例項後,進行到to end1環節。
	ProcessInstance pi = processEngine.getExecutionService().startProcessInstanceByKey("test", variables);
}

此時，如果variables.put("請假天數", 3);啟動流程例項後,進行到to end1環節。

此時，如果variables.put("請假天數", 10);啟動流程例項後,進行到to 總經理審批環節。

3. 如果同時配置了expression與Handler，則expression有效，忽略Handler。

vi. fork、join分支/聚合活動

public class ProcessTest {

	private ProcessEngine processEngine = Configuration.getProcessEngine();

	@Test
	public void test() {
		// 1，部署流程定義
		InputStream in = this.getClass().getResourceAsStream("test.jpdl.xml"); // 當前類所在包中的檔案
		processEngine.getRepositoryService()//
				.createDeployment()//
				.addResourceFromInputStream("test.jpdl.xml", in)//
				.deploy();

		// 2，啟動流程例項
		ProcessInstance pi = processEngine.getExecutionService().startProcessInstanceByKey("test");
		System.out.println("processInstanceId = " + pi.getId());
		System.out.println("當前正在執行的活動：" + pi.findActiveActivityNames());
	}
}

輸出結果為：

processInstanceId = test.330007

當前正在執行的活動：[匯款, 發貨]

可以看出，匯款和發貨同時執行中。並且，只有當2條路線都到join活動，流程才會繼續往後執行。

b) 自定義活動(custom)

i. 在<custom>元素中指定class屬性為指定的類ExternalActivityBehaviourImpl

ii. 這個類要實現ExternalActivityBehaviour介面，其中有兩個方法：

1. execute(ActivityExecution)：節點的功能程式碼

2. signal(ActivityExecution, String, Map)：在當前節點等待時，外部發訊號時的行為

3. 在execute()方法中，可以呼叫以下方法對流程進行控制

a) ActivityExecution.waitForSignal()：在當前節點等待。

b) ActivityExecution.takeDefaultTransition()：使用預設的Transition離開，當前節點中定義的第一個為預設的。

c) ActivityExecution.take(String transitionName)：使用指定的Transition離開

d) ActivityExecution.end()：結束流程例項

4. 也可以實現ActivityBehaviour介面，只有一個方法execute(ActivityExecution)，這樣就不能等待，否則signal時會有類轉換異常。

public class ExternalActivityBehaviourImpl implements ExternalActivityBehaviour {

	// 到達這個活動時執行的方法
	@Override
	public void execute(ActivityExecution execution) throws Exception {
		System.out.println("已傳送資訊.");//此處寫自己要執行的事件

		// 預設是執行完程式碼後離開當前活動，不會執行signal方法,也可以寫如下程式碼
		// execution.takeDefaultTransition(); // 離開當前活動

		// // 使用指定名稱的Transition離開當前活動
		// execution.take(transitionName);

		// 執行完後不要離開，而是要等待外部呼叫signal()方法時才離開
		execution.waitForSignal();
	}

	// 呼叫signal()方法離開當前節點前執行的方法（如果在execute()中直接離開當前節點了，這個方法就不會被執行）
	@Override
	public void signal(ActivityExecution execution, String signalName, Map<String, ?> parameters) throws Exception {
		System.out.println("ExternalActivityBehaviourImpl.signal()");
	}
}

3.事件

a) 在根元素中，或在節點元素中，使用<on event="">元素指定事件，其中event屬性代表事件的型別。

b) 在<on>中用子元素<event-listener class="EventListenerImpl" />，指定處理的類，要求指定的類要實現EventListener介面

c) 事件型別：

i. <on>元素放在根元素（<process>）中，可以指定event為start或end，表示流程的開始與結束。

ii. <on>元素放在節點元素中，可以指定event為start或end，表示節點的進入與離開

iii. 在Start節點中只有end事件，在End節點中只有start事件。

iv. 在<transition>元素中直接寫<event-listener class="">，就是配置事件。（因為在這裡只有一個事件，所以不用寫on與型別）

v. 在<task>元素中還可以配置assign事件，是在分配任務時觸發的。

<?xml version="1.0" encoding="UTF-8"?>

<process name="test" xmlns="http://jbpm.org/4.4/jpdl">

	<!-- 流程例項的啟動事件 -->
	<on event="start">
		<event-listener class="cn.grace.EventListenerImpl"></event-listener>
	</on>
	<!-- 流程例項的結束事件 -->
	<on event="end">
		<event-listener class="cn.grace.EventListenerImpl"></event-listener>
	</on>

	<start name="start1" g="86,69,7,1">
		<!-- 開始活動中只有離開活動的事件 -->
		<on event="end">
			<event-listener class="cn.grace.EventListenerImpl"></event-listener>
		</on>
		<transition name="to task1" to="task1" g="-53,-17" />
	</start>

	<task name="task1" g="61,171,92,52" assignee="張三">
		<!-- 進入活動的事件 -->
		<on event="start">
			<event-listener class="cn.grace.EventListenerImpl"></event-listener>
		</on>
		<!--離開活動的事件 -->
		<on event="end">
			<event-listener class="cn.grace.EventListenerImpl"></event-listener>
		</on>
		<transition name="to end1" to="end1" g="-47,-17" />
	</task>

	<end name="end1" g="86,272,48,48">
		<!-- 結束活動中只有進入活動的事件 -->
		<on event="start">
			<event-listener class="cn.grace.EventListenerImpl"></event-listener>
		</on>
	</end>
</process>

根據上述.jpdl.xml和對應的.png圖，啟動流程例項會執行3次EventListenerImpl事件，結束流程例項也會執行3次EventListenerImpl事件。