�ݺ�ߣ

Spring Integration in jBPM 4 Andries Inz�� [email_address] http://andries.inze.be

About me President of Technical Project Leader at Helping out with

Content Why do we need Spring Integration? What��s In It For Us? Architecture of jBPM 4 and Spring Integration Configuration Testing jBPM 4 with Spring Integration Q&A

Why do we need it? Previous efforts on jBPM 3 Spring Modules (jBPM 3.0-3.1 but not up!) Home brew frameworks http://www.jorambarrez.be

WIIFY Deep integration, making the necessary changes No need for hacks Part of the jBPM 4 test suite Expertise and insight of the jBPM Dev Team. What��s In It For YOU ?

How much is realized? Scope 4.0.0.GA ? minimal scope jBPM 3 Further ? Easy extension and integration Spring Integration is ready but will not be fully supported in first release ? looking for feedback!

jBPM 4 Architecture Dependency Lookup Transaction Management Activity

jBPM 4 Architecture Dependency Lookup Environment Process Service Execution Service Management Service Hibernate Session Factory Transaction Manager �� Dependency resolution at runtime

jBPM 4 Architecture Dependency Lookup (2) ProcessEngineContext TransactionContext Hibernate Session Hibernate Session Factory

jBPM 4 Architecture Dependency Lookup (3) SpringContext ProcessEngineContext TransactionContext Hibernate Session Factory Transaction Manager �� Activity Hibernate Session

Transaction Handling Process Service Execution Service History Service Command Service Commands Service API

Transaction Handling (2) Configuration Details for jBPM Process Service Execution Service History Service Command Service Standard Transaction Interceptor

Transaction Handling (3) Configuration Details for Spring Process Service Execution Service History Service Command Service Business Service Transaction Interceptor

Transaction Handling (4) A discrepancy between Spring and jBPM. Spring ? Transaction per service call jBPM ? Transaction per Command Spring Integration provides support for the two!

Activity Central focus of jBPM 4 <task />, <java />, <esb />, <sql />, �� SpringBeanActivity Expression Language ( JSR 223, Juel) #{myBean.property} < hql name = "count activities" var = "activities" unique = "true" > < query > select count(*) from org.jbpm.pvm.internal.model.ActivityImpl </ query > < transition to = "wait" /> </ hql >

SpringBeanActivity <? xml version = "1.0" encoding = "UTF-8" ?> < process name = "Spring" > < start > < transition to = "test" /> </ start > < spring name = " test " > < bean > testBean </ bean > < method > testMethodWithParameters </ method > < parameters > < string value = ��J-Spring" /> </ parameters > < transition to = ��finish" /> </ spring > < end name = ��finish" /> </ process >

Configuration Minimal Spring Configuration < beans ... < bean id = "configuration" class = "org.jbpm.spring.cfg.SpringConfigurationFactoryBean" > < property name = "jbpmConfigurationLocation" value = ��my/jbpm.cfg.xml" /> </ bean > < bean id = "sessionFactory" class = "org.springframework.orm.hibernate3.LocalSessionFactoryBean" > < property name = "configLocation" value = "classpath:my/hibernate.jbpm.cfg.xml" /> </ bean > < bean id = "transactionManager�� class = "org.springframework.orm.hibernate3.HibernateTransactionManager" > < property name = "sessionFactory" ref = "sessionFactory" /> </ bean > < bean id = "dataSource" class = "org.springframework.jdbc.datasource.DriverManagerDataSource" > < property name = "driverClassName" value = "org.hsqldb.jdbcDriver" /> < property name = "url" value = "jdbc:hsqldb:mem:." /> < property name = "username" value = "sa" /> < property name = "password" value = "" /> </ bean > </ beans >

Configuration (2) Typical jBPM Configuration <?xml version="1.0" encoding="UTF-8"?> <jbpm-configuration xmlns="http://jbpm.org/xsd/cfg"> <process-engine-context> �� </process-engine-context> <transaction-context> �� </transaction-context> </jbpm-configuration>

Configuration (3) Process-engine-context configuration < process-engine-context > < repository-service /> < repository-cache /> < execution-service /> < history-service /> < management-service /> < task-service /> < identity-service /> < command-service > < retry-interceptor /> < environment-interceptor /> < standard-transaction-interceptor /> </ command-service > < hibernate-configuration > < cfg resource = "org/jbpm/pvm/spring/hibernate.jbpm.cfg.xml" /> </ hibernate-configuration > �� </ process-engine-context >

Configuration (4) Transaction-context configuration <transaction-context> <transaction /> <repository-session /> <pvm-db-session /> <job-db-session /> <task-db-session /> <message-session /> <timer-session /> <history-session /> <hibernate-session current = "true /> <identity-session /> </transaction-context>

Configuration (4) < bean id = "processEngine" factory-bean = "jbpmConfiguration" factory-method = "buildProcessEngine" /> < bean id = "executionService" factory-bean = "processEngine" factory-method = "getExecutionService" /> �� Exposing Services

AbstractTransactional SpringJbpmTestCase Only for Spring-Transaction strategy Transactional Rollback after test JbpmTestCase Only for jBPM-Transaction strategy Not transactional Performs client side cleanup ? destructive on existing data jBPM Testing

AbstractTransactional SpringJbpmTestCase public class FindExecutionTest extends AbstractTransactionalSpringJbpmTestCase { protected String[] getConfigLocations() { return new String[]{ "org/jbpm/spring/test/applicationContext.xml" }; } public void testFindExecutionById () { deployJpdlXmlString( "<process name='p'>" + " <start>" + " <transition to='a' />" + " </start>" + " <state name='a' />" + "</process>" ); Execution execution = executionService .startProcessInstanceByKey( "p" ); execution = executionService .findExecution(execution.getId()); assertNotNull(execution); assertEquals( "a" , execution.getActivityName()); }

JbpmTestCase public class FindExecutionTest extends JbpmTestCase { public void testFindExecutionById() { deployJpdlXmlString( "<process name='p'>" + " <start>" + " <transition to='a' />" + " </start>" + " <state name='a' />" + "</process>" ); Execution execution = executionService .startProcessInstanceByKey( "p" ); // take the id and see if the execution service can still find it back execution = executionService .findExecution(execution.getId()); assertNotNull(execution); assertEquals( "a" , execution.getActivityName()); }

Best practice Split up the hibernate cfg files Use Spring transaction handling when possible Write small tests and reuse them Add test-applicationContext.xml to overwrite non-transactional activities (like file-IO)

Future Feedback from community Test if everything works as intended (Timers/async/��) Test Spring 2.5 and up More SWF-like syntax DSL e.g. assertCurrentActivityEquals Mock sub processes �� Helping out?

�ݺ�ߣ

Spring integration with jBPM4

More Related Content

Spring integration with jBPM4