Osworkflow2.8.0+hibernate3.1.3+spring1.2.8集成环境配置安装指南

Osworkflow2.8.0+hibernate3.1.3+spring1.2.8集成环境配置安装指南

作者：ahxu 时间：2006年6月13日

由于osworkflow与spring及hibernate3的集成不是很完善，网上也很鲜见有成功配置的文章及例子，加上osworkflow的文档帮助有限，为了方便其它开发人员学习和使用，ahxu将把osworkflow2.8.0自带的例子与hibernate3和spring1.2.8结合在一起，给出完整的运行例子。由于是多个项目的整合，其间配置文件的内容及形式会因人而宜，很难做到统一和准确，如有疏漏和不足，请大家指出，谢谢。

测试环境安装

1. Netbeans 5简体中文版集成的Tomcat5.5

2. Mysql 5.0.20a

3. Osworkflow 2.8.0，下载地址：https://osworkflow.dev.java.net/files/documents/635/27138/osworkflow-2.8.0.zip

4. hibernate3.1.3，下载地址：http://sourceforge.net/project/showfiles.php?group_id=40712&package_id=127784&release_id=403223

5. spring1.2.8，下载地址：http://sourceforge.net/project/showfiles.php?group_id=73357&package_id=73406&release_id=415255

应用配置

由于受项目所采用的技术影响，这里只提供了一种常见的配置形式（仅供测试，未必准确，各项目具体详细的配置安装请参见各项目的安装说明文档）。

1. %Application%/ WEB-INF/lib下需要放置的库文件有：

a) Osworkflow的支持包

包名
文件来源

commons-logging.jar
%osworkflow解压包%/lib/core

propertyset-1.4.jar

oscore-2.2.5.jar

propertyset-hibernate-1.4.jar
%osworkflow解压包%/lib/optional

bsf.jar

bsh-1.2b7.jar

ehcache.jar

osuser-1.0-dev-2Feb05.jar

osworkflow-2.8.0.jar
%osworkflow解压包%/

b) Srping的支持包

包名
文件来源

spring.jar
%spring解压包%/dist

c) Hibernate的支持包

包名
文件来源

antlr.jar
%hibernate解压包%/lib

cglib.jar

asm.jar

asm-attrs.jars

commons-collections.jar

commons-logging.jar

hibernate3.jar

jta.jar

dom4j.jar

log4j.jar

2. %Application%/ WEB-INF/classes下需要放置的配置文件：

a) workflows.xml

内容略，与OSWF自带例子同。

b) example.xml

内容略，与OSWF自带例子同。

c) osuser.xml

内容略，与OSWF自带例子同。

d) propertyset.xml

<?xml version="1.0" encoding="UTF-8"?>

<propertysets>

<propertyset name="hibernate3" class="ahxu.workflow.hibernate3.HibernatePropertySet">

<arg name="hibernate.connection.datasource" value="jdbc/DefaultDS" />

<arg name="hibernate.dialect" value="org.hibernate.dialect.MySQLDialect" />

</propertyset>

</propertysets>

注：hibernate.dialect的值取决于你使用的数据库。

e) log4j.properties

内容略，与OSWF自带例子同。

3. %Application%/ WEB-INF/下需要放置的配置文件有：

a) web.xml

<?xml version="1.0" encoding="UTF-8"?>

<web-app version="2.4" xmlns="http://java.sun.com/xml/ns/j2ee" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="http://java.sun.com/xml/ns/j2ee http://java.sun.com/xml/ns/j2ee/web-app_2_4.xsd">

<context-param>

<param-name>contextConfigLocation</param-name>

<param-value>/WEB-INF/spring-osworkflow.xml</param-value>

</context-param>

<servlet>

<servlet-name>context</servlet-name>

<servlet-class>org.springframework.web.context.ContextLoaderServlet</servlet-class>

<load-on-startup>1</load-on-startup>

</servlet>

<servlet>

<servlet-name>SOAPWorkflow</servlet-name>

<servlet-class>com.opensymphony.workflow.soap.SOAPWorkflowServlet</servlet-class>

</servlet>

<servlet-mapping>

<servlet-name>SOAPWorkflow</servlet-name>

<url-pattern>/soap/*</url-pattern>

</servlet-mapping>

<session-config>

<session-timeout>

30

</session-timeout>

</session-config>

<welcome-file-list>

<welcome-file>

index.jsp

</welcome-file>

</welcome-file-list>

</web-app>

b) spring-osworkflow.xml

<?xml version="1.0" encoding="UTF-8"?>

<!DOCTYPE beans PUBLIC "-//SPRING//DTD BEAN//EN" "http://www.springframework.org/dtd/spring-beans.dtd">

<beans>

<bean id="dataSource" class="org.springframework.jndi.JndiObjectFactoryBean">

<property name="jndiName"><value>java:comp/env/jdbc/DefaultDS</value></property>

</bean>

<bean id="sessionFactory" class="org.springframework.orm.hibernate3.LocalSessionFactoryBean" singleton="true">

<property name="dataSource"><ref local="dataSource"/></property>

<property name="mappingResources">

<list>

<value>com/opensymphony/workflow/spi/hibernate3/HibernateCurrentStep.hbm.xml</value>

<value>com/opensymphony/workflow/spi/hibernate3/HibernateHistoryStep.hbm.xml</value>

<value>com/opensymphony/workflow/spi/hibernate3/HibernateWorkflowEntry.hbm.xml</value>

<value>ahxu/workflow/hibernate3/PropertySetItemImpl.hbm.xml</value>

</list>

</property>

<property name="hibernateProperties">

<props>

<prop key="hibernate.dialect">org.hibernate.dialect.MySQLDialect</prop>

<prop key="hibernate.show_sql">true</prop>

<prop key="hibernate.hbm2ddl.auto">create-drop</prop>

</props>

</property>

</bean>

<bean id="transactionManager" class="org.springframework.orm.hibernate3.HibernateTransactionManager">

<property name="sessionFactory" >

<ref local="sessionFactory"/>

</property>

</bean>

<bean id="transactionInterceptor" class="org.springframework.transaction.interceptor.TransactionInterceptor">

<property name="transactionManager"><ref local="transactionManager"/></property>

<property name="transactionAttributes">

<props>

<prop key="*">PROPAGATION_REQUIRED</prop>

</props>

</property>

</bean>

<bean id="workflow" class="org.springframework.aop.framework.ProxyFactoryBean">

<property name="singleton">

<value>false</value>

</property>

<property name="proxyInterfaces">

<value>ahxu.osworkflow.example.WebWorkflow</value>

</property>

<property name="interceptorNames">

<list>

<value>transactionInterceptor</value>

<value>workflowTarget</value>

</list>

</property>

</bean>

<!--bean id="transactionManager" class="org.springframework.orm.hibernate.HibernateTransactionManager">

<property name="sessionFactory"><ref local="sessionFactory"/></property>

</bean-->

<bean id="xmlWorkflowFactory" 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="workflowStore" class="com.opensymphony.workflow.spi.hibernate3.SpringHibernateWorkflowStore">

<property name="sessionFactory"><ref local="sessionFactory"/></property>

<property name="propertySetDelegate">

<bean id="propertySetDelegate" class="ahxu.workflow.hibernate3.DefaultHibernatePropertySetDelegate">

<property name="sessionFactory"><ref local="sessionFactory"/></property>

</bean>

</property>

</bean>

<bean id="workflowTypeResolver" class="com.opensymphony.workflow.util.SpringTypeResolver"/>

<bean id="osworkflowConfiguration" class="com.opensymphony.workflow.config.SpringConfiguration">

<property name="store"><ref local="workflowStore"/></property>

<property name="factory"><ref local="xmlWorkflowFactory"/></property>

</bean>

<bean id="workflowTarget" class="ahxu.osworkflow.example.WebBasicWorkflow" singleton="false">

<property name="configuration"><ref local="osworkflowConfiguration"/></property>

</bean>

</beans>

注：1. hibernate.hbm2ddl.auto这里设成create-drop，这样服务器在启动时会自动重建所需表结构，上一次应用数据也会丢失；你可以跟据需要在创建完之后改成update。具体设置参见hibernate文档。

2. jndiName 的值这里要使用java:comp/env/jdbc/DefaultDS全称，如果按官方文档写jdbc/DefaultDS会报错，如果你使用Webspere则要使用jdbc/DefaultDS而不要写全称。

4. 将osworkflow的hibernate3扩展实现包放入%Application%/web-inf/lib目录下。

此包根据osworkflow站点的《Spring Framework and Hibernate 3》文档编写编绎而成，做了一些小的修改。Ahxu为方便使用打成了包，下载地址http://groups.google.com/group/ahxu/msg/5adfec0e7e83c351

5. 配置数据源jdbc/DefaultDS，关于如何配置数据源，可以参见《tomcat 5.X 的mysql DBCP配置指南及相关问题小结》

测试运行

完整例子的下载地址：http://groups.google.com/group/ahxu/msg/c12d0f4a8950d22d，这个war未包含所有运行支持包，请根据此指南自行配置。运行入口文件%Application%/default.jsp文件，界面如下

具体如何使用这个例子，这里就不累述了。

注意问题

由于OSUser包的官方的版本未实现对hibernate3的支持，所以这里在进行用户管理时，也就是%Application%/manager下的操作时会出现问题。这些问题主要是User的除用户名及密码以外的属性管理上使用的了propertyset，这个兼容问题有兴趣的读者可以改写一下，或者等待新的osuser的版本。如果只是单纯的使用osuser API建立用户、设置密码及进行组管理，一般不会出现问题。

资源参考

1. Osworkflow官方网址

Trackback: http://tb.blog.csdn.net/TrackBack.aspx?PostId=796454