हैलो वर्ल्ड BPMN2.0 या एक्टिविटी का परिचय

इस लेख में मैं एक्टीविटी इंजन का उपयोग करके एक साधारण एप्लिकेशन बनाने के एक उदाहरण पर विचार करना चाहता हूं।



" एक्टीविटी " व्यावसायिक प्रक्रियाओं (बिजनेस प्रोसेस मैनेजमेंट) के साथ काम करने के लिए एक हल्का प्लेटफॉर्म है, जो व्यापारिक लोगों, डेवलपर्स और सिस्टम प्रशासकों के लिए अनुकूलित है। प्लेटफार्म BPMN2 प्रक्रियाओं के तेज और विश्वसनीय जावा इंजन पर आधारित है । OpenSource प्रोजेक्ट Apache लाइसेंस के तहत वितरित किया गया है। एक्टीविटी को आपके जावा एप्लिकेशन के हिस्से के रूप में या सर्वर, क्लस्टर या क्लाउड पर स्वतंत्र रूप से लॉन्च किया जा सकता है। इसके अलावा, यह वसंत के साथ पूरी तरह से एकीकृत करता है।



चूंकि परियोजना में उत्कृष्ट दस्तावेज हैं , इसलिए मैं इसकी मूल अवधारणाओं का वर्णन नहीं करूंगा। मैं केवल यह नोट करता हूं कि जैसा कि ऊपर उल्लेख किया गया है, हम एक्टिविटी को एक स्टैंडअलोन एप्लिकेशन के रूप में उपयोग कर सकते हैं, लेकिन हम इसे एप्लिकेशन में एम्बेडेड व्यावसायिक प्रक्रियाओं के प्रसंस्करण के लिए इंजन / लाइब्रेरी के रूप में उपयोग कर सकते हैं। विवरण यहाँ पाया जा सकता है ।

पर निर्भर करता है

तो, चलिए शुरू करते हैं। सबसे पहले, हमें मावेन समर्थन के साथ एक परियोजना बनाने की आवश्यकता है और इसमें निम्नलिखित निर्भरता का वर्णन करें:

<!--

Activiti

-->

< dependency >

< groupId > org.activiti </ groupId >

< artifactId > activiti-engine </ artifactId >

< version > 5.1 </ version >

</ dependency >

< dependency >

< groupId > org.activiti </ groupId >

< artifactId > activiti-spring </ artifactId >

< version > 5.1 </ version >

</ dependency >





<!--

DataBase

-->

< dependency >

< groupId > com.h2database </ groupId >

< artifactId > h2 </ artifactId >

< version > 1.2.132 </ version >

</ dependency >

< dependency >

< groupId > commons-dbcp </ groupId >

< artifactId > commons-dbcp </ artifactId >

< version > 1.2.2 </ version >

</ dependency >





* This source code was highlighted with Source Code Highlighter .

पहले दो निर्भरताएं (मावेन के लिए रिपॉजिटरी यहां वर्णित हैं ) एक्टीविटी कर्नेल को जोड़ते हैं और वसंत के साथ एकीकरण के लिए उपयोगिताओं का एक सेट (कनेक्टिंग स्पेस को बचाने के लिए वसंत का वर्णन नहीं किया गया है)। निर्भरता का दूसरा समूह डेटाबेस को जोड़ता है (हमारे मामले में, इन-मेमोरी का उपयोग किया जाएगा) और इसके साथ काम करने के लिए एक पूल।



Activiti को प्रक्रियाओं, उनकी स्थिति, उपयोगकर्ताओं, इतिहास और बहुत कुछ के बारे में जानकारी संग्रहीत करने के लिए एक डेटाबेस की आवश्यकता होती है।

व्यवसाय की प्रक्रिया

व्यावसायिक प्रक्रिया के विवरण के साथ एक एप्लिकेशन विकसित करना शुरू करना तर्कसंगत है। सबसे पहले, आपको अपने आप को व्यावसायिक प्रक्रिया विवरण की इकाइयों के साथ परिचित करना चाहिए जो एक्टीविटी हमें प्रदान करता है (अधिक सटीक रूप से, बीपीएमएन 2.0 संकेतन)। उसके बाद, आप अपनी खुद की व्यवसाय प्रक्रिया का वर्णन करना शुरू कर सकते हैं। ऐसा करने के तीन तरीके हैं:

• ग्रहण प्लग-इन (अल्प घटक पैलेट) का उपयोग करना;
• एक विशेष एक्टिविटिटी मॉडलर एप्लिकेशन की मदद से (डायग्राम लोड करने की कोई संभावना नहीं है, बचत बेहद अजीब है);
• एक XML संपादक के माध्यम से हाथ।

इस तथ्य के बावजूद कि तीसरा बिंदु उपरोक्त सबसे तार्किक लगता है, हम अभी भी CASE-Technologies का उपयोग करेंगे और ग्रहण के लिए प्लग-इन का उपयोग करके हमारी व्यावसायिक प्रक्रिया को आकर्षित करेंगे (आरेख के प्रत्येक परिवर्तन के बाद xml-description को अपडेट करने के लिए प्लग-इन सेटिंग्स को सेट करना महत्वपूर्ण है, अन्यथा संपादक अपना स्वयं का जीना शुरू कर देता है। खुद का जीवन और एक उपयोगकर्ता के रूप में बाहरी उत्तेजनाओं को पूरी तरह से अनदेखा करें)।



परिणामस्वरूप, मुझे निम्नलिखित चित्र मिला:







ServiceTask "GenerateData" छद्म यादृच्छिक डेटा (JavaDelegate इंटरफ़ेस को लागू करने वाले GenerateDataService वर्ग का उपयोग करके कार्यान्वयन) उत्पन्न करता है

@Service

public class GenerateDataService implements JavaDelegate {



public void execute(DelegateExecution execution) throws Exception {

Long someData = Calendar.getInstance().getTimeInMillis() % 2;

execution.setVariable( "someData" , someData);

}

}



* This source code was highlighted with Source Code Highlighter .

जिसके आधार पर या तो ServiceTask "SayHelloA" या ServiceTask "SayHelloB" निष्पादित किया जाता है। इन दोनों ServiceTask में संबंधित SayHelloService सेवा पद्धति ( UEL अभिव्यक्ति के आधार पर कार्यान्वयन "$ {sayHelloService.printMessageB (निष्पादन)") कहते हैं:

@Service

public class SayHelloService {



public void printMessageA(ActivityExecution execution) {

System. out .println( "Hello world: variant A" );

}



public void printMessageB(ActivityExecution execution) {

System. out .println( "Hello world: variant B" );

}

}



* This source code was highlighted with Source Code Highlighter .

एक्सएमएल फॉर्म में (यानी, बीपीएमएन 2.0 के प्रारूप में), अर्थात्, यह व्याख्या के लिए एक्टीविटी इंजन द्वारा आवश्यक है, प्रक्रिया इस प्रकार है:

<? xml version ="1.0" encoding ="UTF-8" ? >

< definitions xmlns ="http://www.omg.org/spec/BPMN/20100524/MODEL" xmlns:xsi ="http://www.w3.org/2001/XMLSchema-instance" xmlns:activiti ="http://activiti.org/bpmn" xmlns:bpmndi ="http://www.omg.org/spec/BPMN/20100524/DI" xmlns:omgdc ="http://www.omg.org/spec/DD/20100524/DC" xmlns:omgdi ="http://www.omg.org/spec/DD/20100524/DI" typeLanguage ="http://www.w3.org/2001/XMLSchema" expressionLanguage ="http://www.w3.org/1999/XPath" targetNamespace ="http://www.activiti.org/test" >



< process id ="helloWorldProcess" name ="Hello World" >

< documentation > Simple "Hello World" process </ documentation >

< startEvent id ="startevent1" name ="Start" ></ startEvent >

< serviceTask id ="servicetask1" name ="GenerateData" activiti:class ="name.krestjaninoff.activiti.hello.process.GenerateDataService" ></ serviceTask >

< endEvent id ="endevent1" name ="End" ></ endEvent >

< sequenceFlow id ="flow1" name ="" sourceRef ="startevent1" targetRef ="servicetask1" ></ sequenceFlow >

< serviceTask id ="servicetask3" name ="SayHelloB" activiti:expression ="${sayHelloService.printMessageB(execution)}" ></ serviceTask >

< serviceTask id ="servicetask4" name ="SayHelloA" activiti:expression ="${sayHelloService.printMessageA(execution)}" ></ serviceTask >

< exclusiveGateway id ="exclusivegateway2" name ="Exclusive Gateway" ></ exclusiveGateway >

< sequenceFlow id ="flow4" name ="" sourceRef ="servicetask1" targetRef ="exclusivegateway2" ></ sequenceFlow >

< sequenceFlow id ="flow5" name ="${someData != 0}" sourceRef ="exclusivegateway2" targetRef ="servicetask3" >

< conditionExpression xsi:type ="tFormalExpression" ><! [CDATA[${someData != 0}]] ></ conditionExpression >

</ sequenceFlow >

< sequenceFlow id ="flow6" name ="${someData == 0}" sourceRef ="exclusivegateway2" targetRef ="servicetask4" >

< conditionExpression xsi:type ="tFormalExpression" ><! [CDATA[${someData == 0}]] ></ conditionExpression >

</ sequenceFlow >

< exclusiveGateway id ="exclusivegateway3" name ="Exclusive Gateway" ></ exclusiveGateway >

< sequenceFlow id ="flow7" name ="" sourceRef ="servicetask3" targetRef ="exclusivegateway3" ></ sequenceFlow >

< sequenceFlow id ="flow8" name ="" sourceRef ="servicetask4" targetRef ="exclusivegateway3" ></ sequenceFlow >

< sequenceFlow id ="flow9" name ="" sourceRef ="exclusivegateway3" targetRef ="endevent1" ></ sequenceFlow >

</ process >



< bpmndi:BPMNDiagram id ="BPMNDiagram_helloWorldProcess" >

< bpmndi:BPMNPlane bpmnElement ="helloWorldProcess" id ="BPMNPlane_helloWorldProcess" >

< bpmndi:BPMNShape bpmnElement ="startevent1" id ="BPMNShape_startevent1" >

< omgdc:Bounds height ="55" width ="55" x ="273" y ="10" ></ omgdc:Bounds >

</ bpmndi:BPMNShape >

< bpmndi:BPMNShape bpmnElement ="servicetask1" id ="BPMNShape_servicetask1" >

< omgdc:Bounds height ="55" width ="105" x ="248" y ="120" ></ omgdc:Bounds >

</ bpmndi:BPMNShape >

< bpmndi:BPMNShape bpmnElement ="endevent1" id ="BPMNShape_endevent1" >

< omgdc:Bounds height ="55" width ="55" x ="273" y ="460" ></ omgdc:Bounds >

</ bpmndi:BPMNShape >

< bpmndi:BPMNShape bpmnElement ="servicetask3" id ="BPMNShape_servicetask3" >

< omgdc:Bounds height ="55" width ="105" x ="390" y ="304" ></ omgdc:Bounds >

</ bpmndi:BPMNShape >

< bpmndi:BPMNShape bpmnElement ="servicetask4" id ="BPMNShape_servicetask4" >

< omgdc:Bounds height ="55" width ="105" x ="109" y ="304" ></ omgdc:Bounds >

</ bpmndi:BPMNShape >

< bpmndi:BPMNShape bpmnElement ="exclusivegateway2" id ="BPMNShape_exclusivegateway2" >

< omgdc:Bounds height ="60" width ="60" x ="270" y ="210" ></ omgdc:Bounds >

</ bpmndi:BPMNShape >

< bpmndi:BPMNShape bpmnElement ="exclusivegateway3" id ="BPMNShape_exclusivegateway3" >

< omgdc:Bounds height ="60" width ="60" x ="270" y ="370" ></ omgdc:Bounds >

</ bpmndi:BPMNShape >

< bpmndi:BPMNEdge bpmnElement ="flow1" id ="BPMNEdge_flow1" >

< omgdi:waypoint x ="328" y ="37" ></ omgdi:waypoint >

< omgdi:waypoint x ="248" y ="147" ></ omgdi:waypoint >

</ bpmndi:BPMNEdge >

< bpmndi:BPMNEdge bpmnElement ="flow4" id ="BPMNEdge_flow4" >

< omgdi:waypoint x ="353" y ="147" ></ omgdi:waypoint >

< omgdi:waypoint x ="270" y ="240" ></ omgdi:waypoint >

</ bpmndi:BPMNEdge >

< bpmndi:BPMNEdge bpmnElement ="flow5" id ="BPMNEdge_flow5" >

< omgdi:waypoint x ="330" y ="240" ></ omgdi:waypoint >

< omgdi:waypoint x ="390" y ="331" ></ omgdi:waypoint >

</ bpmndi:BPMNEdge >

< bpmndi:BPMNEdge bpmnElement ="flow6" id ="BPMNEdge_flow6" >

< omgdi:waypoint x ="330" y ="240" ></ omgdi:waypoint >

< omgdi:waypoint x ="109" y ="331" ></ omgdi:waypoint >

</ bpmndi:BPMNEdge >

< bpmndi:BPMNEdge bpmnElement ="flow7" id ="BPMNEdge_flow7" >

< omgdi:waypoint x ="495" y ="331" ></ omgdi:waypoint >

< omgdi:waypoint x ="270" y ="400" ></ omgdi:waypoint >

</ bpmndi:BPMNEdge >

< bpmndi:BPMNEdge bpmnElement ="flow8" id ="BPMNEdge_flow8" >

< omgdi:waypoint x ="214" y ="331" ></ omgdi:waypoint >

< omgdi:waypoint x ="270" y ="400" ></ omgdi:waypoint >

</ bpmndi:BPMNEdge >

< bpmndi:BPMNEdge bpmnElement ="flow9" id ="BPMNEdge_flow9" >

< omgdi:waypoint x ="330" y ="400" ></ omgdi:waypoint >

< omgdi:waypoint x ="273" y ="487" ></ omgdi:waypoint >

</ bpmndi:BPMNEdge >

</ bpmndi:BPMNPlane >

</ bpmndi:BPMNDiagram >

</ definitions >



* This source code was highlighted with Source Code Highlighter .

सेटिंग्स

अब, हमें सक्रियता का उपयोग करके प्रक्रिया शुरू करने के लिए, हमें गतिविधि के मूल तत्वों के मूल तत्वों को कॉन्फ़िगर और आरंभ करना होगा। चूँकि हम स्प्रिंग का उपयोग करते हैं, हमारे लिए, विन्यास संबंधित फलियों के विन्यास में कम हो जाएगा:

< beans xmlns ="http://www.springframework.org/schema/beans"

xmlns:context ="http://www.springframework.org/schema/context"

xmlns:tx ="http://www.springframework.org/schema/tx"

xmlns:xsi ="http://www.w3.org/2001/XMLSchema-instance"

xsi:schemaLocation ="http://www.springframework.org/schema/beans www.springframework.org/schema/beans/spring-beans.xsd

www.springframework.org/schema/context www.springframework.org/schema/context/spring-context-3.0.xsd

www.springframework.org/schema/tx www.springframework.org/schema/tx/spring-tx-3.0.xsd"

>

<!-- Configuration -->

< context:property-placeholder location ="classpath*:*.properties" />



<!-- Annotation based configuration -->

< context:annotation-config />

< context:component-scan base-package ="name.krestjaninoff" />





<!-- Data -->

< bean id ="dataSource"

class ="org.apache.commons.dbcp.BasicDataSource" destroy-method ="close" >

< property name ="driverClassName" value ="org.h2.Driver" />

< property name ="url" value ="jdbc:h2:mem:activiti;DB_CLOSE_DELAY=1000" />

< property name ="username" value ="sa" />

< property name ="password" value ="" />

</ bean >



< bean id ="transactionManager"

class ="org.springframework.jdbc.datasource.DataSourceTransactionManager" >

< property name ="dataSource" ref ="dataSource" />

</ bean >

< tx:annotation-driven transaction-manager ="transactionManager" />





<!--

Activiti

-->

< bean id ="processEngineConfiguration" class ="org.activiti.spring.SpringProcessEngineConfiguration" >

< property name ="databaseType" value ="h2" />

< property name ="dataSource" ref ="dataSource" />

< property name ="transactionManager" ref ="transactionManager" />

< property name ="databaseSchemaUpdate" value ="true" />

< property name ="jobExecutorActivate" value ="false" />

< property name ="deploymentResources" value ="classpath*:/process/*.bpmn20.xml" />

</ bean >



< bean id ="processEngine" class ="org.activiti.spring.ProcessEngineFactoryBean" >

< property name ="processEngineConfiguration" ref ="processEngineConfiguration" />

</ bean >



< bean id ="repositoryService" factory-bean ="processEngine"

factory-method ="getRepositoryService" />

< bean id ="runtimeService" factory-bean ="processEngine"

factory-method ="getRuntimeService" />

< bean id ="taskService" factory-bean ="processEngine"

factory-method ="getTaskService" />

< bean id ="historyService" factory-bean ="processEngine"

factory-method ="getHistoryService" />

< bean id ="managementService" factory-bean ="processEngine"

factory-method ="getManagementService" />

</ beans >



* This source code was highlighted with Source Code Highlighter .

यह ध्यान देना महत्वपूर्ण है कि processEngineConfiguration बीन की परिनियोजन के स्रोत संपत्ति - यह विन्यासकर्ता को बताता है कि हमारी प्रक्रियाओं के लिए विवरण फाइलें कहाँ स्थित हैं। हर बार जब आप आवेदन शुरू करते हैं, तो आपको इन प्रक्रियाओं को एक्टीविटी इंजन में "तैनात" करना होगा। अधिक तैनाती यहाँ वर्णित है ।

एप्लिकेशन लॉन्च

और इसलिए, मुख्य काम पहले ही किया जा चुका है। अब एप्लिकेशन को लॉन्च करने के लिए हमें केवल स्प्रिंग संदर्भ बनाने और वांछित प्रक्रिया शुरू करने की आवश्यकता है:

public class Main {

public static void main( String [] args) {



// Create Spring context

ClassPathXmlApplicationContext applicationContext =

new ClassPathXmlApplicationContext( "applicationContext.xml" );



// Start process

RuntimeService runtimeService = (RuntimeService) applicationContext.

getBean( "runtimeService" );

runtimeService.startProcessInstanceByKey( "helloWorldProcess" );

}

}



* This source code was highlighted with Source Code Highlighter .

उदाहरण

ऊपर वर्णित परियोजना के लिए कोड GitHub पर उपलब्ध है ।