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

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

 

由于osworkflow与spring及hibernate3的集成不是很完善，网上也很鲜见有成功配置的文章及例子，加上osworkflow的文档帮助有限，为了方便其它开发人员学习和使用，ahxu将把osworkflow 2.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.       hibernate 3.1.3 ，下载地址：http://sourceforge.net/project/showfiles.php?group_id=40712&package_id=127784&release_id=403223

5.       spring 1.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建立用户、设置密码及进行组管理，一般不会出现问题。