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 でサポート) (ユニットテスト用またはサーブレットコンテナー用)
   • org.jbpm.persistence.spring.jta 永続ユニットのエンティティーマネージャーファクトリー

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>

   これらの設定は、実行可能な 1 つのプロセスを定義します。リソースの名前は 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>