68.3. 与 Spring 集成

流程

1. 配置实体管理器工厂和事务管理器：

   在 spring.xml 文件中配置实体管理器工厂和事务管理器

   <bean id="jbpmEMF" class="org.springframework.orm.jpa.LocalContainerEntityManagerFactoryBean">
     <property name="persistenceUnitName" value="org.jbpm.persistence.spring.jta"/>
   </bean>
   
   <bean id="jbpmEM" class="org.springframework.orm.jpa.support.SharedEntityManagerBean">
     <property name="entityManagerFactory" ref="jbpmEMF"/>
   </bean>
   
   <bean id="narayanaUserTransaction" factory-method="userTransaction" class="com.arjuna.ats.jta.UserTransaction" />
   
   <bean id="narayanaTransactionManager" factory-method="transactionManager" class="com.arjuna.ats.jta.TransactionManager" />
   
   <bean id="jbpmTxManager" class="org.springframework.transaction.jta.JtaTransactionManager">
     <property name="transactionManager" ref="narayanaTransactionManager" />
     <property name="userTransaction" ref="narayanaUserTransaction" />
   </bean>

   这些设置定义了以下持久性配置：

   • JTA 事务管理器（由 Narayana JTA 提供支持，用于单元测试或 servlet 容器）
   • org.jbpm.persistence.spring.jta persistence 单元的实体管理器工厂

2. 配置业务流程资源：

   在 spring.xml 文件中配置业务流程资源

   <bean id="process" factory-method="newClassPathResource" class="org.kie.internal.io.ResourceFactory">
     <constructor-arg>
       <value>jbpm/processes/sample.bpmn</value>
     </constructor-arg>
   </bean>

   这些设置定义可用于执行的单个进程。资源名称是 sample.bpmn，它必须在类路径上可用。您可以将类路径用作包含尝试进程引擎的资源的简单方法。

3. 使用实体管理器、事务管理器和资源配置 RuntimeEnvironment 实例：

   在 spring.xml 文件中配置 RuntimeEnvironment 实例

   <bean id="runtimeEnvironment" class="org.kie.spring.factorybeans.RuntimeEnvironmentFactoryBean">
     <property name="type" value="DEFAULT"/>
     <property name="entityManagerFactory" ref="jbpmEMF"/>
     <property name="transactionManager" ref="jbpmTxManager"/>
     <property name="assets">
       <map>
         <entry key-ref="process"><util:constant static-field="org.kie.api.io.ResourceType.BPMN2"/></entry>
       </map>
     </property>
   </bean>

   这些设置定义了运行时管理器的默认运行时环境。

4. 根据环境创建一个 RuntimeManager 实例：

   <bean id="runtimeManager" class="org.kie.spring.factorybeans.RuntimeManagerFactoryBean" destroy-method="close">
     <property name="identifier" value="spring-rm"/>
     <property name="runtimeEnvironment" ref="runtimeEnvironment"/>
   </bean>

流程

1. 配置转换：

   在 spring.xml 文件中配置事务

   <context:annotation-config />
   <tx:annotation-driven />
   <tx:jta-transaction-manager />
   
   <bean id="transactionManager" class="org.springframework.transaction.jta.JtaTransactionManager" />

2. 配置 JPA 和持久性：

   在 spring.xml 文件中配置 JPA 和持久性

   <bean id="entityManagerFactory" class="org.springframework.orm.jpa.LocalContainerEntityManagerFactoryBean" depends-on="transactionManager">
      <property name="persistenceXmlLocation" value="classpath:/META-INF/jbpm-persistence.xml" />
   </bean>

3. 配置安全性和用户和组群信息供应商：

   在 spring.xml 文件中配置安全性和组信息提供程序

   <util:properties id="roleProperties" location="classpath:/roles.properties" />
   
   <bean id="userGroupCallback" class="org.jbpm.services.task.identity.JBossUserGroupCallbackImpl">
     <constructor-arg name="userGroups" ref="roleProperties"></constructor-arg>
   </bean>
   
   <bean id="identityProvider" class="org.jbpm.spring.SpringSecurityIdentityProvider"/>

4. 配置运行时管理器工厂。这个因素是 Spring 上下文了解，因此它能够以正确的方式与 Spring 容器交互，并支持必要的服务，包括事务命令服务和任务服务：

   在 spring.xml 文件中配置运行时管理器工厂

   <bean id="runtimeManagerFactory" class="org.kie.spring.manager.SpringRuntimeManagerFactoryImpl">
     <property name="transactionManager" ref="transactionManager"/>
     <property name="userGroupCallback" ref="userGroupCallback"/>
   </bean>
   
   <bean id="transactionCmdService" class="org.jbpm.shared.services.impl.TransactionalCommandService">
     <constructor-arg name="emf" ref="entityManagerFactory"></constructor-arg>
   </bean>
   
   <bean id="taskService" class="org.kie.spring.factorybeans.TaskServiceFactoryBean" destroy-method="close">
     <property name="entityManagerFactory" ref="entityManagerFactory"/>
     <property name="transactionManager" ref="transactionManager"/>
     <property name="userGroupCallback" ref="userGroupCallback"/>
     <property name="listeners">
       <list>
         <bean class="org.jbpm.services.task.audit.JPATaskLifeCycleEventListener">
           <constructor-arg value="true"/>
         </bean>
       </list>
     </property>
   </bean>

5. 将流程引擎服务配置为 Spring Bean：

   在 spring.xml 文件中将进程引擎服务配置为 Spring Bean

   <!-- Definition service -->
   <bean id="definitionService" class="org.jbpm.kie.services.impl.bpmn2.BPMN2DataServiceImpl"/>
   
   <!-- Runtime data service -->
   <bean id="runtimeDataService" class="org.jbpm.kie.services.impl.RuntimeDataServiceImpl">
     <property name="commandService" ref="transactionCmdService"/>
     <property name="identityProvider" ref="identityProvider"/>
     <property name="taskService" ref="taskService"/>
   </bean>
   
   <!-- Deployment service -->
   <bean id="deploymentService" class="org.jbpm.kie.services.impl.KModuleDeploymentService" depends-on="entityManagerFactory" init-method="onInit">
     <property name="bpmn2Service" ref="definitionService"/>
     <property name="emf" ref="entityManagerFactory"/>
     <property name="managerFactory" ref="runtimeManagerFactory"/>
     <property name="identityProvider" ref="identityProvider"/>
     <property name="runtimeDataService" ref="runtimeDataService"/>
   </bean>
   
   <!-- Process service -->
   <bean id="processService" class="org.jbpm.kie.services.impl.ProcessServiceImpl" depends-on="deploymentService">
     <property name="dataService" ref="runtimeDataService"/>
     <property name="deploymentService" ref="deploymentService"/>
   </bean>
   
   <!-- User task service -->
   <bean id="userTaskService" class="org.jbpm.kie.services.impl.UserTaskServiceImpl" depends-on="deploymentService">
     <property name="dataService" ref="runtimeDataService"/>
     <property name="deploymentService" ref="deploymentService"/>
   </bean>
   
   <!-- Register the runtime data service as a listener on the deployment service so it can receive notification about deployed and undeployed units -->
   <bean id="data" class="org.springframework.beans.factory.config.MethodInvokingFactoryBean" depends-on="deploymentService">
     <property name="targetObject" ref="deploymentService"></property>
     <property name="targetMethod"><value>addListener</value></property>
     <property name="arguments">
     <list>
         <ref bean="runtimeDataService"/>
     </list>
     </property>
   </bean>