JBPM安装及请假流程实例

精品文档，仅供学习与交流，如有侵权请联系网站删除1、开发环境搭建1.1必须安装的软件1） jbpm-4.4.zip2） jdk 5或者更高版本3） 支持的数据库有hsqldb、mysql、oracle、postgresql、sybase，本说明以oracle作为数据库。4） GPD插件（jbpm在IDE中的流程设计器）,eclipse（建议3.6版本以上）或者myeclipse（建议8.1版本以上）安装插件所需的zip在解压后jbpm-4.4installsrcgpd中的jbpm-gpd-site.zip，本说明以eclipse3.6为例。1.2配置JBPM运行时1） 打开window preferences2） 选择 JBoss jBPM - jBPM 4 - Runtime Locations3） 点击 Add.4） 在 Add Location 对话框中，输入一个名字，比如 jbpm-4.0 然后点击 Search.5） 在 Browse For Folder 对话框中，选择你的jbpm 根目录，然后点击 OK6） 点击 OK 在 Add Location 对话框中1.3定义jBPM 用户库1） 点击窗口 - 属性（Windows - Preferences）2） 选择Java - 创建路径 - 用户类库（Java - Build Path - User Libraries）3） 点击新建（New）4） 类型名字jBPM Libraries5） 点击添加JARs（Add JARs.）6） 找到jBPM 安装程序下的lib 目录7） 选择lib 下的所有jar 文件并点击打开（Open）8） 选择jBPM Libraries 作为入口9） 重新点击添加JARs（Add JARs）10） 在jBPM 的安装程序的根目录下选择jbpm.jar 文件11） 点击打开（Open）12） 在jbpm.jar 下选择源码附件（Source attachment）作为入口13） 点击编辑（Edit）14） 在源码附件的配置（Source Attachment Configuration）对话框中，点击目录（External Folder.）15） 找到jBPM 安装程序下的src 目录16） 点击选择（Choose）17） 点击两次确定（Ok）会关闭所有对话框1.4在目录中添加jPDL4 模式如果你想直接编辑XML 源码， 最好是在你的XML 目录中指定一下模式（schema），这样当你在编辑流程源码的时候，可以更好的帮助你编写代码。1） 点击窗口 - 属性（Windows - Preferences）2） 选择XML - 目录（XML - CataLog）3） 点击添加（Add）4） 添加XML 目录（Add XML Catalog Entry）的窗口打开5） 点击map-icon 的图标下面的按钮并选择文件系统（File System）6） 在打开的对话框中， 选择jBPM 安装目录下src 文件夹中jpdl.xsd 文件7） 点击打开（Open）并且关闭所有的对话框2、实例教程讲解这节我们将使用建立一个简单请假流程项目2.1 建立项目在eclipse中新建一个Dynamic Web Project的项目jbpm4leave。2.2 加入jbpm用户库1）邮件点击新建的项目jbpm4leaveProperties2）如下图说示加入用户库2.3 加入jbpm所需要的配置文件大家可以从jbpm-4.4解压后的文件下，在路径examplessrc中找到以下文件，加入到项目工程的src中其中jbpm.hibernate.cfg.xml是配置jbpm4.4的hibernate配置文件，包括数据源的配置，和一般的hibernate.cfg.xml配置文件差不多。Jbpm.mailkit开头的文件，是用于邮件功能的配置。2.4 新建简单的请假流程1）新建一个jbpm4.4的流程定义文件右键点击srcNewOther，选择JBoss jBPM下的Jbpm 4 Process Definition，文件名写leave，版本号写4.4即可。3）用流程设计器打开新建的leave.jpdl.xml。右键点击leave.jpdl.xmlOpen WithjBPM jPDL4 Editor,，看见如下效果3）设计请假流程在这个简单的请假流程中，包含开始（start）、结束（end）、任务（task）、决策（decision）四种流程元素。流程设计如下：4）详细设计流程中的各任务节点的流转条件选中“申请”任务节点，在properties（属性）中，General标签的Name（属性值）填为“申请”，Assignment标签的Type选择 assignee（参与者，选择这个，可以指定该任务节点的直接参与者），Expression的属性值填为#owner（即指定这个任务节点的直接参与者就是这个流程的启动者）。选中“经理审批”任务节点，在properties（属性）中，General标签的Name（属性值）填为“经理审批”，Assignment标签的Type选择 candidate-groups（参与者，选择这个，可以该任务节点有某个用户组来参与），Expression的属性值填为manager（即指定这个任务节点的有manager这个用户组来完成）。“老板审批”节点同“经理审批”任务节点设置类似，只是Expression改为boss设置决策节点，选中，在属性标签General中按如下所示填写：Name（节点名称），Expression（判断表达式，其中day是在流程流转过程中的一个记录天数的属性，整个表达式的意思是天数大于3天需要老板审批，如果天数不大于3天，经理审批通过后就直接结束流程，不需要老板审批）。设计好流程后，点击保存，IDE将自动为你生成一个png的流程图片，切记不可在xml源码界面进行保存，否则会生成不完整的流程图片。在点击下方的“Source”属性，即可看到流程定义文件的xml源码一下是leave.jpdl.xml的源码： 3 ? 老板审批 : 结束 g=196,259,48,48 name=exclusive1至此工程的src文件下就有下面这些文件：2.5 发布流程Jbpm的流程发布其实很简单，只要使用jbpm已经封装好的方法进行使用，即可。我们新建一个deploy.jsp的页面用户发布流程。在此讲解使用zip文件打包发布流程。1） 将之前建立好的leave.jpdl.xml和leave.png文件，一起打包进leave.zip文件。2） deploy.jsp代码如下：Insert title hererequest.setCharacterEncoding(UTF-8);response.setCharacterEncoding(UTF-8);String deployFile = request.getParameter(processDef);if (deployFile != null & deployFile != ) /必须使用的，流程引擎ProcessEngine processEngine = Configuration.getProcessEngine();RepositoryService repositoryService = processEngine.getRepositoryService();try String file = deployFile;/将ZIP文件封转到IO流里InputStream is = new FileInputStream(new File(file);ZipInputStream zis = new ZipInputStream(is);/将ZIP流程文件发布到pvm（流程虚拟机中，他会把ZIP包中的xml文件和png图片存储到数据库中）repositoryService.createDeployment().addResourcesFromZipInputStream(zis).deploy();zis.close();is.close();out.println(发布流程成功);out.println(返回); catch (Exception e) e.printStackTrace();out.println(发布流程失败);function readFile(obj) document.getElementById(file).value = obj.value;可直接发布zip文件发布流程文件 3） 测试发布成功结果4） 查看已发布成功的流程已经有的一个查看流程的页面task-write.jsp，源码如下：String username = (String) session.getAttribute(username);/流程引擎ProcessEngine processEngine = Configuration.getProcessEngine();RepositoryService repositoryService = processEngine.getRepositoryService();/流程定义集合List pdList = repositoryService.createProcessDefinitionQuery().list();Insert title herebody font: normal 11px auto Trebuchet MS, Verdana, Arial, Helvetica,sans-serif;color: #4f6b72;background: #E6EAE9;a color: #c75f3e;#mytable padding: 0;margin: 0;caption padding: 0 0 5px 0;width: 700px;font: italic 11px Trebuchet MS, Verdana, Arial, Helvetica, sans-serif;text-align: right;th font: bold 11px Trebuchet MS, Verdana, Arial, Helvetica, sans-serif;color: #4f6b72;border-right: 1px solid #C1DAD7;border-bottom: 1px solid #C1DAD7;border-top: 1px solid #C1DAD7;letter-spacing: 2px;text-transform: uppercase;text-align: left;padding: 6px 6px 6px 12px;background: #CAE8EA;th.nobg border-top: 0;border-left: 0;border-right: 1px solid #C1DAD7;background: none;td border-right: 1px solid #C1DAD7;border-bottom: 1px solid #C1DAD7;background: #fff;font-size: 11px;padding: 6px 6px 6px 12px;color: #4f6b72;td.alt background: #F5FAFA;color: #797268;th.spec border-left: 1px solid #C1DAD7;border-top: 0;background: #fff;font: bold 10px Trebuchet MS, Verdana, Arial, Helvetica, sans-serif;th.specalt border-left: 1px solid #C1DAD7;border-top: 0;background: #f5fafa;font: bold 10px Trebuchet MS, Verdana, Arial, Helvetica, sans-serif;color: #797268;body.td font-size: 11px;流程定义流程id流程名称版本号流程删除启动流程for (ProcessDefinition pd : pdList) a href=remove.jsp?id=删除流程a href=start.jsp?id=启动流程5） 查看流程发布情况6） 流程定义所设计到的表JBPM4_DEPLOYMENTJBPM4_DEPLOYPROP/存放流程定义的版本号，使用的jbpm版本号，已经流程名JBPM4_JOB/存放timer的定义JBPM4_LOB /存放流程定义的xml和png图片文件2.6 启动流程1）启动流程，其实很简单，需要获得流程定义的ID，使用jbpm已经封装好的流程启动方法就可以了。/start.jsprequest.setCharacterEncoding(UTF-8);response.setCharacterEncoding(UTF-8);try/流程引擎ProcessEngine processEngine = Configuration.getProcessEngine();/流程实例服务ExecutionService executionService = processEngine.getExecutionService();Map map = new HashMap();/插入流程中存放的数据，这里存放流程启动者的名字，参数id是流程定义的IDmap.put(owner, session.getAttribute(username);executionService.startProcessInstanceById(request.getParameter(id), map);response.sendRedirect(task-personal-list.jsp);catch(Exception e)e.printStackTrace();2）查看代办任务/ task-personal-list.jspString username = (String) session.getAttribute(username);/流程引擎ProcessEngine processEngine = Configuration.getProcessEngine();/任务引擎TaskService taskService = processEngine.getTaskService();/当前用户代办的任务集合List taskList2 = taskService.findPersonalTasks(username);Insert title herebody font: normal 11px auto Trebuchet MS, Verdana, Arial, Helvetica,sans-serif;color: #4f6b72;background: #E6EAE9;a color: #c75f3e;#mytable padding: 0;margin: 0;caption padding: 0 0 5px 0;width: 700px;font: italic 11px Trebuchet MS, Verdana, Arial, Helvetica, sans-serif;text-align: right;th font: bold 11px Trebuchet MS, Verdana, Arial, Helvetica, sans-serif;color: #4f6b72;border-right: 1px solid #C1DAD7;border-bottom: 1px solid #C1DAD7;border-top: 1px solid #C1DAD7;letter-spacing: 2px;text-transform: uppercase;text-align: left;padding: 6px 6px 6px 12px;background: #CAE8EA;th.nobg border-top: 0;border-left: 0;border-right: 1px solid #C1DAD7;background: none;td border-right: 1px solid #C1DAD7;border-bottom: 1px solid #C1DAD7;background: #fff;font-size: 11px;padding: 6px 6px 6px 12px;color: #4f6b72;td.alt background: #F5FAFA;color: #797268;th.spec border-left: 1px solid #C1DAD7;border-top: 0;background: #fff;font: bold 10px Trebuchet MS, Verdana, Arial, Helvetica, sans-serif;th.specalt border-left: 1px solid #C1DAD7;border-top: 0;background: #f5fafa;font: bold 10px Trebuchet MS, Verdana, Arial, Helvetica, sans-serif;color: #797268;body.td font-size: 11px;个人待办任务流程ID当前节点查看详细信息查看流程图for (Task task : taskList2) ahref=?id=查看详细信息a href=view.jsp?id=查看流程图3）实现如图：/流程列表/流程启动后，成为当前用户的待办任务2.7 流程办理（申请）由于我们的流程如下，启动启动流程后，流程就进入了“申请”这个流程节点（注：流程启动后，会在流程第一个节点所有人/所有组的代办事项中找到）。所以，现在就要在申请中进行办理。由于我们在定义流程时如下定义了：定义了，“申请”这个节点是有流程启动者进行办理的，form指定办理“申请”这个节点的处理页面，用户可以自己定义处理页面。Transition指定申请流程的下一个出口。1） 在代办事项中，我们有一行如下代码：a href=?id=查看详细信息在这里会传一个任务ID，所以在request.jsp中必须要取得这个任务ID。/request.jsp源码Insert title hererequest.setCharacterEncoding(UTF-8);response.setCharacterEncoding(UTF-8); 申请 申请人： 请假时间： 请假原因： function change(obj)var reg = /1-9d*$/;if (!reg.test(obj.value) alert(天数必须为正整数!); obj.value=; obj.focus(); return false;function validate()var obj = document.getElementsByName(day)0.value;var reg = /1-9d*$/;if (!reg.test(obj) alert(天数必须为正整数!); document.getElementsByName(day)0.value=; document.getElementsByName(day)0.focus(); return false; else document.forms0.action=submit.jsp;document.forms0.submit();return true;前台显示如下：填写完内容后，页面将会提交到submit.jsp，将对提交的数据进行处理，同时流程继续流转，所以在提交的的页面中要处理两件事情：1、 处理用户提交数据，将数据和流程实例进行绑定2、 将流程继续流转，提交给下一个节点办理/submit.jsp源码如下request.setCharacterEncoding(UTF-8);response.setCharacterEncoding(UTF-8);ProcessEngine processEngine = Configuration.getProcessEngine();TaskService taskService = processEngine.getTaskService();String username = (String) session.getAttribute(username);String taskId = request.getParameter(taskId);String owner = request.getParameter(owner);int day = Integer.parseInt(request.getParameter(day);String reason = request.getParameter(reason);String sDBDriver = oracle.jdbc.driver.OracleDriver; String sConnStr = jdbc:oracle:thin:10.142.7.9:1521:orcl;Connection conn = null; PreparedStatement stmt = null;ResultSet rs = null;try Class.forName(sDBDriver); conn = DriverManager.getConnection(sConnStr,scott,scott); conn.setAutoCommit(false);/查询待办事项列表String sql1 = UPDATE jbpm4_hist_task task set task.assignee_=? where task.dbid_=?;stmt = conn.prepareStatement(sql1); stmt.setString(1,username);stmt.setString(2,taskId);stmt.executeUpdate();mit();catch(Exception e) e.printStackTrace(); tryconn.rollback();catch(Exception e1)e1.printStackTrace();finally if (stmt != null) stmt.close(); if (conn != null) conn.close();/将数据存储封转到map中Map map = new HashMap();map.put(day, day);map.put(reason, reason);/将数据和流程进行绑定，具体请看jbpm4.4API/绑定数据的同时，将现在的任务节点completeTask，既完成当前操作，将流程向下提交taskSpleteTask(taskId, map);response.sendRedirect(task-personal-list.jsp);=我们这里将请假的内容填写如下=请假四天，根据流程定义，大于四天经理审批通过后，还要老板审批才可以。2.8 流程办理（经理审批）请假“申请”提交后，就进入经理审批流程了。在之前的经理审批节点，我们进行如下定义：注：form：处理经理审批的处理页面Candidate-groups：处理当前任务节点的用户组，如果不定义则任务都在这里节点进行操作，还可以像“申请”节点一样，定义assignee的属性，但是candidate-groups和assigness同时只能使用其中的一个。这里定义了两个transition，分别是“批准”和“驳回”，决定的流程的下一个流转节点是哪里。在具体操作中，将详细说明。/manager.jsp源码如下：其中，有两点需要注意：1）taskService.getVariable(taskId, owner)这样的内容是，取出之前在“申请”节点中，封装进流程实例的相应变量的值，如果你要对已有值进行修改或者要增加新值，只需要对你当前想要变更的变量封装进map，然后同“申请”一样绑定到流程实例中即可。2）在页面中给出了两个submit提交按钮，他们的name相同，但是value不同： 这刚好和我们之前定义的流程的两个transition相同，他是为后面流转流程所做服务的。request.setCharacterEncoding(UTF-8);response.setCharacterEncoding(UTF-8);ProcessEngine processEngine = Configuration.getProcessEngine();TaskService taskService = processEngine.getTaskService();String taskId = request.getParameter(id);Task task = taskService.getTask(taskId);Insert title here经理审核 申请人：请假时间：请假原因： 转办当前实例办理情况流程ID节点名称开始时间结束时间参与人员String sDBDriver = oracle.jdbc.driver.OracleDriver;String sConnStr = jdbc:oracle:thin:10.142.7.9:1521:orcl;Connection conn = null;ResultSet rs = null;PreparedStatement stmt = null;try Class.forName(sDBDriver);conn = DriverManager.getConnection(sConnStr, scott, scott);String sqlstr = SELECT procinst.dbid_,actinst.activity_name_,actinst.start_,actinst.end_,+ actinst.htask_,histtask.assignee_+ FROM JBPM4_HIST_ACTINST actinst,+ JBPM4_HIST_PROCINST procinst,+ JBPM4_HIST_TASK histtask+ WHERE actinst.hproci_=procinst.dbid_+ AND histtask.dbid_=actinst.htask_+ AND procinst.dbid_=(+ SELECT task.procinst_+ FROM JBPM4_TASK task+ INNER JOIN JBPM4_HIST_TASK hist ON hist.dbid_=task.dbid_+ WHERE hist.dbid_=?+ AND actinst.activity_name_!=exclusive1+ ORDER BY procinst.dbid_,actinst.dbid_;stmt = conn.prepareStatement(sqlstr);stmt.setString(1, taskId);rs = stmt.executeQuery();while (rs.next() tr bgcolor=green catch (Exception e) e.printStackTrace(); finally if (rs != null) rs.close();if (stmt != null) stmt.close();if (conn != null) conn.close();/submit_manager.jsp注：String result = request.getParameter(result);先取出了之前有定义的相同name，但value不同的流程result属性，然后taskSpleteTask(taskId, result);这个用来定义流程流转到的下一个节点的节点名。request.setCharacterEncoding(UTF-8);response.setCharacterEncoding(UTF-8);ProcessEngine processEngine = Configuration.getProcessEngine();