目录
简
述
使
用jbpm-starters-kit-3.1.4生成数据库表及安装eclipse图形化配置插件
部
署jbpm的jar包和moudle的jar包
部
署hbm文件到项目
设
置大字段string-max
配
置configration、template
过
滤器的设置与建立
编
写发布流程定义xml的人机页面及程序
写
在最后
简述
Jbpm工作流框架与现有ssh框架的集成工作其
实很简单,但国内外的资料太小,所以会在集成时走入太多误区,本文是在struts1.2,spring2.5,hibernate3.2上集成成功的详细步骤。其中解决了,jbpm的访问数据库session与原有hibernate的session不同的问
题,string-max大字段问题。完成了流程部署web及后台程序。利用spring-modules-0.8当中的spring31做为集成
的桥梁(其实它已经做好了集成,但文档和实例实在是太简单)。
使用jbpm-starters-kit-3.1.4生成数据库表及安装eclipse图形化配置插件
1下载jbpm-starters-kit-3.1.4到其网站,包含所有需要的工具及jar包。
2数据库的安装以oracle为例,其它
数据库可按此例修改。
2.1创建所需用户及表空间,如果有了用户和表空间就不需要了。
2.2找到jbpm-starters-kit-3.1.4文件夹,在其下的jbpm文件夹的下级文件夹lib中加入oracle的驱动包ojdbc14.jar.
2.3在jbpm"src"resources文件夹下建立oracle文件夹,将"jbpm"src"resources"hsqldb里的create.db.hibernate.properties和identity.db.xml文件copy到刚刚建立的oracle文件夹当中.
2.4修改create.db.hibernate.properties文件,修改目标数据库的连接属性如下:
# these properties are
used by the build script to create
# a hypersonic database
in the build/db directory that contains
# the jbpm tables and a
process deployed in there
hibernate.dialect=org.hibernate.dialect.OracleDialect
hibernate.connection.driver_class=oracle.jdbc.driver.OracleDriver
hibernate.connection.url=jdbc:oracle:thin:@10.62.1.12:1521:oracle
hibernate.connection.username=dpf
hibernate.connection.password=dpf
hibernate.show_sql=true
hibernate.cache.provider_class=org.hibernate.cache.HashtableCacheProvider
2.5修改jbpm"src"config.files"hibernate.cfg.xml文件,同样是配置数据库的连接属性如下:
name="hibernate.dialect">org.hibernate.dialect.OracleDialect
name="hibernate.connection.driver_class">oracle.jdbc.driver.OracleDriver
name="hibernate.connection.url">jdbc:oracle:thin:@10.62.1.12:1521:oracle
name="hibernate.connection.username">dpf
name="hibernate.connection.password">dpf
name="hibernate.cache.provider_class">org.hibernate.cache.HashtableCacheProvider
2.6修改jbpm"build.deploy.xml文件.找到create.db项并进行如下修改:
name="create.db" depends="declare.jbpm.tasks, db.clean, db.start"
description="creates a hypersonic database with the jbpm tables and
loads the processes in there">
actions="create"
cfg="${basedir}/src/config.files/hibernate.cfg.xml"
properties="${basedir}/src/resources/oracle/create.db.hibernate.properties"/>
file="${basedir}/src/resources/oracle/identity.db.xml"
cfg="${basedir}/src/config.files/hibernate.cfg.xml"
properties="${basedir}/src/resources/oracle/create.db.hibernate.properties"/>
antfile="build.xml" target="build.processes" inheritall="false" />
cfg="${basedir}/src/config.files/hibernate.cfg.xml"
properties="${basedir}/src/resources/oracle/create.db.hibernate.properties">
dir="build" includes="*.process" />
target="db.stop" />
2.7配置ant,在jbpm目录执行ant create.db –buildfile build.deploy.xml命令。
会有一些小错误的提示,没有关系数据库的表已经建立完成。
2.8 eclipse的图形化配置插件安装文件可以到jbpm-starters-kit-3.1.4"jbpm-designer"
jbpm-gpd-feature"eclipse下找到,需注意版本。
部署jbpm的jar包和moudle的jar包
1把如下jar包放入"WEB-INF"lib文件夹下,spring-modules-jbpm31.jar可以在
spring-modules-0.8下找到,其它的都属于jbpm工具包。
bsh-1.3.0.jar
bsf.jar
spring-modules-jbpm31.jar
jbpm-webapp-3.1.4.jar
jbpm-identity-3.1.4.jar
jbpm-3.1.4.jar
部署hbm文件到项目
1在jbpm文件夹中找到所有
的*.hbm.xml数据库映射文件。放到项目的一个文件夹当中。本例放到"com"gresoft"security"model"hbm文件夹中。并且在hibernate的sessionfactory建立时,设置为相关路径配置。
2此文件需在spring管理的hibernate配置文件下修改,本例为
dataAccessContext-hibernate.xml,如下:
class="org.springframework.orm.hibernate3.annotation.AnnotationSessionFactoryBean">
org.hibernate.dialect.Oracle9Dialect
true
org.hibernate.cache.EhCacheProvider
true
classpath*:/com/gresoft/security/model/hbm/
设置大字段string-max
1此文件需在spring管理的hibernate配置文件下修改,本例为
dataAccessContext-hibernate.xml,如下:
配置configration、template
说明:jbpmConfiguration是根据springmodules所
提供的
LocalJbpmConfigurationFactoryBean进行配置,其集成好对jbpmConfiguration的管理。在系统使用时JbpmConfiguration需调用jbpmTemplate的jbpmTemplate.getJbpmConfiguration()方法得到。
1此文件需在spring管理的hibernate配置文件下修改,本例为
dataAccessContext-hibernate.xml,如下:
2增加类路
径中jbpm.cfg.xml文件,可以根据
jbpm-starters-kit-3.1.4"jbpm"src"java.jbpm"org"jbpm"default.jbpm.cfg.xml
复制后修改。本例放到/datasql/jbpm.cfg.xml下。上面配置文件有相关配置。全部内容如下:
name="persistence">
class="org.jbpm.persistence.db.DbPersistenceServiceFactory">
过滤器的设置与建立
过滤器的建立是为了保证一个session的正常工
作。
1 web.xml中的修改
本例中描述如下:
JbpmContextFilter
com.gresoft.components.jbpm.JbpmContextHolder
2建立对应的类文件
本例中描述如下:
package
com.gresoft.components.jbpm;
import
java.io.IOException;
import
java.io.Serializable;
import
java.security.Principal;
import
javax.servlet.Filter;
import
javax.servlet.FilterChain;
import
javax.servlet.FilterConfig;
import
javax.servlet.ServletException;
import
javax.servlet.ServletRequest;
import
javax.servlet.ServletResponse;
import
javax.servlet.http.HttpServletRequest;
import
org.jbpm.JbpmConfiguration;
import
org.jbpm.JbpmContext;
import
org.springframework.web.context.WebApplicationContext;
public class
JbpmContextHolder implements Filter, Serializable {
private static final long serialVersionUID = 1L;
String jbpmConfigurationResource = null;
String jbpmContextName = null;
boolean isAuthenticationEnabled = true;
public void init(FilterConfig filterConfig) throws
ServletException {
// get the jbpm configuration resource
this.jbpmConfigurationResource = filterConfig
.getInitParameter("jbpm.configuration.resource");
// get the jbpm context to be used from the jbpm configuration
this.jbpmContextName = filterConfig
.getInitParameter("jbpm.context.name");
if (jbpmContextName == null) {
jbpmContextName = JbpmContext.DEFAULT_JBPM_CONTEXT_NAME;
}
// see if authentication is turned off
String isAuthenticationEnabledText = filterConfig
.getInitParameter("authentication");
if ((isAuthenticationEnabledText != null)
&&
("disabled".equalsIgnoreCase(isAuthenticationEnabledText))) {
isAuthenticationEnabled = false;
}
}
public void doFilter(ServletRequest servletRequest,
ServletResponse servletResponse, FilterChain filterChain)
throws IOException, ServletException {
String actorId = null;
// see if we can get the authenticated swimlaneActorId
if (servletRequest instanceof HttpServletRequest) {
HttpServletRequest httpServletRequest = (HttpServletRequest)
servletRequest;
Principal userPrincipal = httpServletRequest.getUserPrincipal();
if (userPrincipal != null) {
actorId = userPrincipal.getName();
}
}
JbpmContext jbpmContext = getJbpmConfiguration(servletRequest)
.createJbpmContext(jbpmContextName);
try {
if (isAuthenticationEnabled) {
jbpmContext.setActorId(actorId);
}
filterChain.doFilter(servletRequest, servletResponse);
} finally {
jbpmContext.close();
}
}
/*
*从spring获取JbpmConfiguration的bean加载方式
*/
protected JbpmConfiguration getJbpmConfiguration(
ServletRequest servletRequest) {
WebApplicationContext webApplicationContext =
(WebApplicationContext) ((HttpServletRequest) servletRequest)
.getSession()
.getServletContext()
.getAttribute(
WebApplicationContext.ROOT_WEB_APPLICATION_CONTEXT_ATTRIBUTE);
JbpmConfiguration jbpmConfiguration = (JbpmConfiguration)
webApplicationContext
.getBean("jbpmConfiguration");
//得到业务Bean(在这里是你需要
注入的bean)
System.out.println("------------------------------------------------------------------------------------------");
System.out.println("jbpmconfiguration对象化=" + jbpmConfiguration.toString());
System.out.println("------------------------------------------------------------------------------------------");
return jbpmConfiguration;
}
public void destroy() {
}
}
编写发布流程定义xml的人机页面及程序
1 JSP页面使用struts1.2,spring2.0,hibernate3.2框架。此为流程发布页面。
name="formupload" method="post" enctype="multipart/form-data">
请选择要发布的流程文件
type="file" id="workflowfile" >
name="submit">
2后台对应类
/*******************************************************************************
*文件名: JbpmAction.java
*版本:
*描述:
*版权所有:
*
*创建者:沙振中
*创建日期: Dec 27, 2007
*修改者:
*修改日期:
*修改说明:
******************************************************************************/
package
com.gresoft.security.web;
import
java.io.InputStream;
import
javax.servlet.http.HttpServletRequest;
import
javax.servlet.http.HttpServletResponse;
import
org.apache.commons.beanutils.DynaBean;
import
org.apache.commons.logging.Log;
import
org.apache.commons.logging.LogFactory;
import
org.apache.struts.action.ActionForm;
import
org.apache.struts.action.ActionForward;
import
org.apache.struts.action.ActionMapping;
import
org.apache.struts.upload.FormFile;
import
org.jbpm.JbpmContext;
import
org.jbpm.graph.def.ProcessDefinition;
import
org.springmodules.workflow.jbpm31.JbpmTemplate;
import
com.gresoft.commons.core.web.StrutsAction;
public class JbpmAction
extends StrutsAction {
private static Log log = LogFactory.getLog(JbpmAction.class);
private JbpmTemplate jbpmTemplate;
public void setjbpmTemplate(JbpmTemplate jbpmTemplate) {
this.jbpmTemplate = jbpmTemplate;
}
/**
*进入上传流程主页面
*
@param mapping
*
@param form
*
@param request
*
@param response
*
@return
*/
public
ActionForward index(ActionMapping mapping, ActionForm form,
HttpServletRequest request, HttpServletResponse response) {
return mapping.findForward("delpoyindex");
}
/**
*上传流程文件
*
@param mapping
*
@param form
*
@param request
*
@param response
*
@return
*/
public
ActionForward deploy(ActionMapping mapping, ActionForm form,
HttpServletRequest request, HttpServletResponse response)throws
Exception {
DynaBean dy = (DynaBean) form;
FormFile file = (FormFile) dy.get("workflowfile");
InputStream is =
file.getInputStream();
JbpmContext jbpmContext =
jbpmTemplate.getJbpmConfiguration().createJbpmContext();
ProcessDefinition processDefinition =
ProcessDefinition.parseXmlInputStream(is);
//利用容器的方法将流程定义数据部署到
数据库上
jbpmContext.deployProcessDefinition(processDefinition);
//关闭jbpmContext
jbpmContext.close();
//提交到数据库当中,使用统一的session
jbpmTemplate.getHibernateTemplate().flush();
log.info("流程部署成功!");
return mapping.findForward("delpoyindex");
}
}
注:相关ssh配置文件的设置需根
据自己实际项目为准。
写在最后
通过上述集成的工作,可以使你的项目中很好的集成jbpm。Jbpm流程的设置需根据实际业务相绑定。现在我们就可以在项目当中应用工作流了。