jBPM流程部署文件研究.doc

jBPM 流程部署文件研究
Posted by Nicholas Ding on 五月 29th, 2006
jBPM 为流程定义及其相关文件专门使用了一种打包机制，就是.par文件，似乎JBoss很喜欢这样的形式，之前还有为Hibernate提供的.har包。这个.par被称为Process Archive，故名思义，里面包含了流程需要的所有信息。
其实.par文件就是一个简单的zip格式的压缩包。里面的核心文件是processdefinition.xml这个流程定义，当然用 Eclipse jBPM插件制作的流程还含有一个流程图片，可以使用jBPM提供的webapp动态标示当前所执行的流程。除次之外，classes这个目录以内的文件 都会被动态加载到内存，因为流程里面定义的Action和Task等的实现类都需要去Classpath找，jBPM会在部署.par包的时候用自己的 Class Loader加载进去。（PS：也可以直接放在上层Classpath里面，只要能够加载到就可以）
流程部署详解
如果认为一定要使用Eclipse jBPM插件来部署流程的话，那就错了，jBPM插件从一定程度上简化了jBPM开发，尤其是Deployment功能为大家省了不少事情，但是如果要手 工部署，怎么做呢？接下来就要研究一下到底部署这个.par文件的时候做了哪些事情。
首先要让Eclipse jBPM的部署功能有效，那么要确保服务器使用jBPM提供的webapp，并且让起Context位于/jbpm这个位置。例如http: //localhost:8080/jbpm，那么在jBPM插件里面写上localhost，端口8080，测试一下连接就可以了。那么我们分析一下 webapp，发现原来是org.jbpm.webapp.servlet.UploadServlet这个类在起作用。
看一下UploadServlet的代码，看handleRequest里面的内容，用Commons Fileupload做的文件上传，如果文件小直接加载到内存，文件大会用磁盘的临时空间（Fileupload的文档上有解释）。文件上传完毕，那么就 执行doDeployment操作。这个doDeployment才是部署的关键入口。
ZipInputStream zipInputStream = new ZipInputStream(fileItem.getInputStream());

这行代码解释了如何加载.par文件，首先作为Zip格式读取，然后得到jbpmContext来进行流程部署。这个JbpmContext也是采用了 ThreadLocal，感觉原理上和Hibernate用的差不多（到这篇文章为止，我在Weblogic还没法成功使用这个得到 jbpmContext，还只能用jbpmConfiguration来获取）。
JbpmContext jbpmContext = JbpmContext.getCurrentJbpmContext();
ProcessDefinition processDefinition = ProcessDefinition.parseParZipInputStream(zipInputStream);
jbpmContext.deployProcessDefinition(processDefinition);
这样以来，一个流程就这么简单的部署上去了。当然了，如果不想Upload，还可以使用本地文件系统直接部署，需要提供一个URL就可以了，请参考DeployServlet，还可以使用ant进行部署。
这么看来，部署一个流程就变得非常方便了。
部署文件怎么就消失了，到底去了哪里？
在部署完.par流程包之后，仿佛就不再需要这个.par文件了，但是是什么原因能够让服务器不必知道.par的位置而又能每次正常运行这个流程呢？这个问题我诼磨了很久，一个zip文件不可能凭空消失啊，至少他应该存在于引擎可以找到的地方。而这个地方，正是数据库！
看一下jbpm生成的数据库，包含两张比较特别的表jbpm_bytearray和jbpm_byteblock，正是这两张表纯储了.par文件的内容。可以说，他是将zip里面的内容拆开存到了数据库。
mysql> select * from jbpm_bytearray;
+-----+------------------------------------------------------+-----------------+

| ID_ | NAME_ | FILEDEFINITION_ |

+-----+------------------------------------------------------+-----------------+

| 1 | processimage.jpg | 1 |

| 2 | gpd.xml | 1 |

| 3 | processimage.jpg | 4 |

| 4 | gpd.xml | 4 |

| 5 | classes/com/sample/action/MessageActionHandler.class | 4 |

+-----+------------------------------------------------------+-----------------+
jbpm_bytearray这张表把.par文件目录存了进去，jbpm_byteblock则是将二进制内容存了进去。可以说如果你的.par 文件里面含有Java Bytecode，那么引擎会从数据库读出byte[]数组然后作为类加载，如果你的类存在于引擎可见的Classpath，那么他会从那里面加载。
总结
jBPM在流程的部署上着实下了不少功夫，从流程的部署上可以看到jBPM引擎的一些工作方式，这也有点类似IoC的概念，本身jBPM提供了基于 有限状态机的编程模型，这一模型大大的简化了编程难度，同时将流程的定义和实现分离出来，使得可以在流程实现的功能子集定义新的流程。
在流程部署上提供了版本机制，即连续部署两个相同的流程会出现版本增量，总是新建高版本的流程，但是低版本的流程在执行过程中不会因为高版本的部署而自动取消，直到运行完毕。