1. 將osworkflow與spring和hibernate結合的原因
1)簡化對osworkflow的配置
2)利用hibernate框架的一些特性,如持久化,緩存等
3)事務管理,osworkflow本身是不支持事務的,而事務是作為一個產品的基本功能
4)可以利用spring加入其它的擴展功能,如用戶認證和鑒權。這點本文沒有介紹。
2、準備
下載osworkflow-2.8.0版本 ,下載hibernate-3.2版本,下載spring-framework-2.5.5版本
3、搭建eclipse環境
測試的工程目錄如下:
src 源代碼目錄
oswf 包路徑
Test.java 測試類,后面會給出源代碼
bin 編譯目的目錄
oswf 包路徑
Test.class 編譯生成的class文件
//下面的幾個配置文件位于bin目錄下
log4j.properties 這是log4j的配置文件,這可以不需要
//下面三個hbm.xml文件是osworkflow持久化的o/r映射文件,這是從osworkflow的源代碼目錄com"opensymphony"workflow"spi"hibernate3下拷出來的。
HibernateCurrentStep.hbm.xml
HibernateHistoryStep.hbm.xml
HibernateWorkflowEntry.hbm.xml
//下面三個文件直接從osworkflow自帶的例子中獲取的,其中example.xml是流程定義文件。osuser.xml是osuser的配置文件。workflows.xml是osworkflow配置有哪些流程定義的配置文件。
example.xml
osuser.xml
workflows.xml
osworkflow-spring.xml //這是spring 的配置文件,位于根目錄下,后面會給出源代碼
//下面兩個是eclipse的工程文件
.project
.classpath
4、編寫spring 的beans.xml配置文件
文件名如osworkflow-spring.xml,內容如下:
<?xml version="1.0" encoding="UTF-8"?>
<beans xmlns="http://www.springframework.org/schema/beans"
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xsi:schemaLocation="http://www.springframework.org/schema/beans
http://www.springframework.org/schema/beans/spring-beans-2.5.xsd">
<!-- 下面配置數據源datasource,這里用的是spring 自帶的一個測試用的連接池。也可以用開源的連接池Jakarta Commons DBCP。
如果程序是運行在servlet容器中,如tomcat中,可直接使用在tomcat中配置的數據庫連接池jdni。
這里給出的是oracle數據庫驅動,可以換成任意的數據庫,如mysql等。 -->
<bean id="dataSource" class="org.springframework.jdbc.datasource.DriverManagerDataSource" destroy-method="close">
<property name="driverClassName">
<value>oracle.jdbc.driver.OracleDriver</value>
</property>
<property name="url">
<value>jdbc:oracle:thin:@127.0.0.1:1521:orcl</value>
</property>
<property name="username">
<value>test</value>
</property>
<property name="password">
<value>test</value>
</property>
</bean>
<!-- 配置hibernate的sessionFactory以及相關的配置,這是使用hibernate的入口-->
<bean id="sessionFactory" class="org.springframework.orm.hibernate3.LocalSessionFactoryBean">
<property name="dataSource"><ref local="dataSource"/></property>
<property name="mappingResources">
<list>
<value>HibernateCurrentStep.hbm.xml</value>
<value>HibernateHistoryStep.hbm.xml</value>
<value>HibernateWorkflowEntry.hbm.xml</value>
</list>
</property>
<property name="hibernateProperties">
<props>
<prop key="hibernate.dialect">org.hibernate.dialect.Oracle9iDialect</prop>
<prop key="hibernate.current_session_context_class">thread</prop>
<prop key="hibernate.hbm2ddl.auto">create-drop</prop>
</props>
</property>
</bean>
<!-- 配置osworkflow中所用的propertyset,這里配置的是默認的內存方式的propertyset。-->
<bean id="propertySetDelegate" class="com.opensymphony.workflow.util.PropertySetDelegateImpl">
</bean>
<!-- 配置osworkflow的存儲工廠WorkflowStore -->
<bean id="workflowStore" class="com.opensymphony.workflow.spi.hibernate3.SpringHibernateWorkflowStore">
<property name="sessionFactory"><ref local="sessionFactory"/></property>
<property name="propertySetDelegate"> <ref bean="propertySetDelegate"/> </property>
</bean>
<!-- 配置osworkflow的工廠類 -->
<bean id="workflowFactory" class="com.opensymphony.workflow.spi.hibernate.SpringWorkflowFactory" init-method="init">
<property name="resource"><value>workflows.xml</value></property>
<property name="reload"><value>false</value></property>
</bean>
<bean id="osworkflowConfiguration" class="com.opensymphony.workflow.config.SpringConfiguration">
<property name="store"><ref local="workflowStore"/></property>
<property name="factory"><ref local="workflowFactory"/></property>
</bean>
<!-- 配置osworkflow的工作流接口。注意下面的構造函數參數值test是用戶名 -->
<bean id="workflowTarget" class="com.opensymphony.workflow.basic.BasicWorkflow">
<constructor-arg><value>test</value></constructor-arg>
<property name="configuration"><ref local="osworkflowConfiguration"/></property>
</bean>
<!-- 下面的配置是配置讓oswrorkflow使用spring的事務框架 -->
<bean id="transactionManager" class="org.springframework.orm.hibernate3.HibernateTransactionManager">
<property name="sessionFactory" ref="sessionFactory"/>
</bean>
<!-- 應用程序在代碼中唯一要關注的就只有這一個Bean,其它不用關注 -->
<bean id="workflow" class="org.springframework.transaction.interceptor.TransactionProxyFactoryBean">
<property name="transactionManager" ref="transactionManager"/>
<property name="target" ref="workflowTarget"/>
<property name="transactionAttributes">
<props>
<prop key="*">PROPAGATION_REQUIRED</prop>
</props>
</property>
</bean>
</beans>
5、編寫測試代碼,只有一個類,代碼如下:
package oswf;
import org.springframework.beans.factory.xml.XmlBeanFactory;
import org.springframework.core.io.FileSystemResource;
import org.springframework.core.io.Resource;
import com.opensymphony.user.Group;
import com.opensymphony.user.User;
import com.opensymphony.user.UserManager;
import com.opensymphony.workflow.Workflow;
public class Test {
public static void main(String[] args) {
try{
UserManager um = UserManager.getInstance();
User test = um.createUser("test");
test.setPassword("test");
Group foos = um.createGroup("foos");
Group bars = um.createGroup("bars");
Group bazs = um.createGroup("bazs");
test.addToGroup(foos);
test.addToGroup(bars);
test.addToGroup(bazs);
}
catch(Exception e){
System.out.println("create user error,app exit");
return;
}
System.out.println("create user success");
Resource res = new FileSystemResource("osworkflow-spring.xml");
XmlBeanFactory beanFactory =new XmlBeanFactory(res);
Workflow workflow = (Workflow) beanFactory.getBean("workflow");
try {
workflow.initialize("example", 100, null);
} catch (Exception e)
{
e.printStackTrace();
}
}
}
代碼是,首先要創建一個用戶(這里使用的是osworkflow默認綁定的osuser框架)。然后獲取workflow bean,再調用initialize方法創建一個新的流程。
6、問題
1)osworkflow使用了propertyset框架,但propertyset框架和osworkflow都是opensymphony下的一個開源項目。osworkflow中提供的propertyset jar包不支持hibernate3,因此本例子中是使用內存化的propertyset,沒有持久化propertyset。
2)osworkflow中的BasicWorkflow類的構造函數必須提供一個參數,參數是osuser中的用戶。而且沒有提供設置用戶的set方法,這樣就只能在配置文件中把用戶名寫死。這只能用在測試環境中。在實際中需要修改這個代碼,支持動態設置用戶。
3)osuser框架不支持通過hibernate持久化,如果要支持,需要自己下載源代碼改寫。但osuser支持通過jdbc持久化。