作者: gsccnu
JBPM外接任务表单简述
目前我看过采用JBPM的工作流有web-console (JBPM 3.2.1自带)、RUNA WFE、SMART,就这三个我做一个比较: RUNA WFE RUNA WFE是上面提到的三个中,唯一可以直接部署应用的,当然也有它的缺点,下面我会提到。这个框架采用的是Struts作为表示层,流程管理和组织架构管理都做的不错,良好的国际化,文档很全。如果只打算研究可以看下它的permission部分,它已经实现了对流程查看、启动、结束等的权限控制,JBPM自身在这部分基本还是TODO状态。 OK,再说就偏题了,下面讲了它的Taskform实现。RUNA采用了Web-Console的forms.xml这种文件与Task的映射方法,但有它自己的特色:forms.xml里包含有variable 信息,没有采用xhtml。下面我贴一点他的Taskform代码 代码 <tr title="since" > <td style="padding-right: 20px;"> Since <i><font size="-1"> (dd.mm.yyyy) font><i> td> <td> <customtag var="since" delegation="ru.runa.wf.web.html.vartag.DateTimeInputVarTag" /> td> tr> 不是很难吧,呵呵。值得注意的只有那个<customtag >。由于看它的代码已经过了一段时间,所以具体代码的位置已经忘了,只记得实现的原理。大致如下,从数据库把上述文件的字节流读出,通过一个匹配方法找到整个 <customtag >,根据参数Var 和一个委托delegation得到这个组件的HTML代码,用这段代码将原来的<customtag >替换掉,最后将所有的HTML一次输入到response中去。 RUNA提供了很多vartag ,通过继承它自带的几个抽象类你也可以扩展你自己的。然而它最大的缺点就是在原有的JBPM又进行了封装,产生了自己的IDE插件、流程定义语言,可以说比较封闭。 WEB-CONSOLE web-console (3.2.1),主要使用了一个jbpm4jsf.jar来完成这部分工作。使用过JBPM的朋友都知道,在JBPM的最近流程设计器里多了一个Generate Form的按钮,通过它我们可以创建一个描述Variables的xhtml文件。在发布的时候,我们可以将它和processdefinition.xml、processimage.jpg等一起发布到数据库(多句嘴,通过简单的配置JBPM也可以从本地的文件系统读取上述文件),然后jbpm4jsf就可以通过读取这个xhtml文件产生一个很灵活的Task-form。具体如下:(所有文件来自jbpm-jpdl-3.2.1,代码都是节选的) sa / task.xhtml xml 代码 <j4j:includeProcessFile file="#{taskForms[task.name]}" process="# {task.processInstance.processDefinition}"> <ui:param name="var" value="#{taskVariableMap}"/> <ui:param name="comment" value="#{comment}"/> <ui:param name="taskName" value="#{task.name}"/> j4j:includeProcessFile> 注意这里使用了<j4j:includeProcessFile >这个标签,对应它在jbpm4jsf.jar中 org.jbpm.jsf.core.handler.IncludeProcessFileHandler.java java 代码 final FileDefinition fileDefinition = processDefinition.getFileDefinition(); if (fileDefinition == null) { throw new TagException(tag, "Process has a null fileDefinition property"); } if (! fileDefinition.hasFile(file)) { throw new TagException(tag, "Process does not contain file '" + file + "'"); } VariableMapper orig = ctx.getVariableMapper(); final VariableMapperWrapper newVarMapper = new VariableMapperWrapper(orig); ctx.setVariableMapper(newVarMapper); try { final StringBuffer buffer = new StringBuffer(); buffer.append(processDefinition.getId()); buffer.append("/"); buffer.append(file); nextHandler.apply(ctx, parent); ctx.includeFacelet(parent, new URL("par", "", 0, buffer.toString(), new FileDefinitionURLStreamHandler(fileDefinition, file))); } finally { ctx.setVariableMapper(orig); } 用这种方式就将数据库中的xhtml文件取出,通过创建一个URL对象,将这部分加入到当前FaceletContext中,并作为UIComponent parent的子UIComponent 。然后我们再看一个表单文件,选用自带的websale例子 examples/websale/src/main/jpdl/form.create.xhtml xml 代码 <f:facet name="header"> <h:outputText value="Quantity:"/> f:facet> <h:inputText value="#{var['quantity']}" converter="javax.faces.Integer" converterMessage="The quantity must be numeric." validatorMessage="The quantity must be at least 1."> <f:validateLongRange minimum="1"/> h:inputText> 有点JSF基础的应该很容易看出上面的代码,转换、验证、FORM组件都可以在这里定义。这里使用了JSF RI <xmlns:h="http://java.sun.com/jsf/html>,我们有理由相信使用第三方的UIComponent以及定义自己的UIComponent(来满足一些国内的BT需求)将不是什么难事。
jbpm4jsf要求JSF 1.2,所以目前无法使用Myfaces(JSF 1.1),本人喜欢的Tomahawk 、Tobago 一并被毙了,非常.十分以及极其不爽。 目前只好慢慢等Myfaces出1.2 release, 总之相对于其他2个流程框架我还是看好JBPM4JSF。喜欢struts的朋友也不用急,JBPM 好象计划在3.3版本的时候推出支持Struts的东东,不过目前在CVS上还没有看到JBPM4STRUTS这个项目
|