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官方网址