JBoss jBPM 3.1 プログラミング入門

Transcription

1 JBoss jbpm Hewlett-Packard Development Company, L.P. The information contained herein is subject to change without notice

2 Hello World Hello World web web GPD web

3 HelloWorld

4 HelloWorld JBoss jbpm API (JPDL) DB(DB) (state )

5 HelloWorld <process-definition name="helloworld"> <start-state name="start"> <transition to="s" /> </start-state> <state name="s"> <transition to="end" /> </state> <end-state name="end" /> </process-definition>

6 HelloWorld public void testhelloworldprocess() { // / ProcessDefinition processdefinition = ProcessDefinition.parseXmlString( "<process-definition>" + "<start-state name='start'>" + "<transition to='s' />" + "</startstate>" + "<state name='s'>" + "<transition to='end' />" + "</state>" + "<end-state name='end' />" +"</process-definition> ); // ProcessInstance processinstance = new ProcessInstance(processDefinition); // Token token = processinstance.getroottoken(); assertsame(processdefinition.getstartstate(), token.getnode()); // token.signal(); assertsame(processdefinition.getnode("s"), token.getnode()); } token.signal(); assertsame(processdefinition.getnode("end"), token.getnode());

7 HelloWorld ()

8 HelloWorld DB Hello World DB HSQLDB JBoss jbpm API (JPDL) DB DB (state ) DB DB

9 HelloWorld DB <process-definition name="helloworld"> <start-state name="start"> <transition to="s" /> </start-state> <state name="s"> <transition to="end" /> </state> <end-state name="end" /> </process-definition>

10 HelloWorld DB (1/5) JbpmConfiguration : public class HelloWorldDbTest extends TestCase { static JbpmConfiguration jbpmconfiguration = null; static { jbpmconfiguration = JbpmConfiguration.parseXmlString( "<jbpm-configuration>" + " <jbpm-context>" + " <service name='persistence' " + " factory='org.jbpm.persistence.db.dbpersistenceservicefactory' />" + " </jbpm-context>" + " <string name='resource.hibernate.cfg.xml' " + " value='hibernate.cfg.xml' />" + " <string name='resource.business.calendar' " + " value='org/jbpm/calendar/jbpm.business.calendar.properties' />" + " <string name='resource.default.modules' " + " value='org/jbpm/graph/def/jbpm.default.modules.properties' />" + " <string name='resource.converter' " + " value='org/jbpm/db/hibernate/jbpm.converter.properties' />" + " <string name='resource.action.types' " + " value='org/jbpm/graph/action/action.types.xml' />" + " <string name='resource.node.types' " + " value='org/jbpm/graph/node/node.types.xml' />" + " <string name='resource.varmapping' " + " value='org/jbpm/context/exe/jbpm.varmapping.xml' />" + "</jbpm-configuration>" ); } public void setup() { jbpmconfiguration.createschema(); 10} JbpmConfiguration JBoss jbpm ( ) jbpm.cfg.xml JbpmConfiguration JbpmConfiguration jbpmconfiguration = JbpmConfiguration.getInstance();

11 HelloWorld DB (2/5) public void testsimplepersistence() { // 1helloworld // helloworld deployprocessdefinition(); // helloworld // "s" processinstanceiscreatedwhenusersubmitswebappform(); } // helloworld theprocessinstancecontinueswhenanasyncmessageisreceived();

12 HelloWorld DB (3/5) } public void deployprocessdefinition() { ProcessDefinition processdefinition = ProcessDefinition.parseXmlString( "<process-definition name='helloworld'>" + " <start-state name='start'>" + "<transition to='s' />" + "</startstate>" + " <state name='s'>" + "<transition to='end' />" + "</state>" + " <end-state name='end' />" + "</process-definition>" ); JbpmContext jbpmcontext = jbpmconfiguration.createjbpmcontext(); try { // helloworld jbpmcontext.deployprocessdefinition(processdefinition); } finally { } jbpmcontext.close(); JbpmContext JbpmConfiguration#createJb pmcontext() Hibernate try-finally close()

13 HelloWorld DB (4/5) / public void processinstanceiscreatedwhenusersubmitswebappform() { JbpmContext jbpmcontext = jbpmconfiguration.createjbpmcontext(); try { GraphSession graphsession = jbpmcontext.getgraphsession(); // ProcessDefinition processdefinition = graphsession.findlatestprocessdefinition("helloworld"); ProcessInstance processinstance = new ProcessInstance(processDefinition); // Token token = processinstance.getroottoken(); assertequals("start", token.getnode().getname()); // token.signal(); assertequals("s", token.getnode().getname()); // ( ) jbpmcontext.save(processinstance); } } finally { jbpmcontext.close(); }

14 HelloWorld DB (5/5) / } public void theprocessinstancecontinueswhenanasyncmessageisreceived() { JbpmContext jbpmcontext = jbpmconfiguration.createjbpmcontext(); try { GraphSession graphsession = jbpmcontext.getgraphsession(); ProcessDefinition processdefinition = graphsession.findlatestprocessdefinition("helloworld"); // helloworld List processinstances = graphsession.findprocessinstances(processdefinition.getid()); // 11 ProcessInstance processinstance = (ProcessInstance) processinstances.get(0); // processinstance.signal(); // ( ) asserttrue(processinstance.hasended()); } finally { } jbpmcontext.close();

15 web Web

16 JBoss jbpm Web JBoss jbpm Web JBoss jbpm websale JBoss jbpm URL jbpm-starters-kit zip $JBPM_KIT_HOME/jbpm $JBPM_KIT_HOME/jbpm-server Web JBossAS(4.0.3SP1 )

17 JBoss jbpm JDK 5.0 Update 11 : jdk-1_5_0_11-windows-i586-p.exe : ex_jdk5.jsp JBoss jbpm : jbpm-starters-kit zip : p?group_id=70542 JDK JBossAS > cd C: jboss jbpm-starters-kit > cd jbpm-server > start.bat JBossAS Web URL > cd C: > mkdir jboss > cd jboss > jar xvf C: jboss_archive jbpm-starters-kit zip

18 Web :

19 Web : web.xml JbpmContextFilter JSP Managed Bean item price user_name isurgentapprovalmgr_name Start-state token End-state user1 ActionHandler faces-config.xml JSF (Myfaces) Tomcat JBoss jbpm Hibernate JBoss AS JbpmConfiguration jbpm.sar

20 JbpmContextFilter jbpmcontext JBoss jbpm Servlet Filter HTTP JbpmContext JbpmContext (ThreaLocal) HTTP JbpmContext web.xml... <filter> <filter-name>jbpmcontextfilter</filter-name> <filter-class>org.jbpm.web.jbpmcontextfilter </filter-class> </filter> <filter-mapping> <filter-name>jbpmcontextfilter</filter-name> <url-pattern>/*</url-pattern> </filter-mapping>... JbpmContextFilter.java public class JbpmContextFilter implements Filter, Serializable {... public void dofilter(servletrequest servletrequest, ServletResponse servletresponse, FilterChain filterchain) throws IOException, ServletException { JbpmContext jbpmcontext = getjbpmconfiguration().createjbpmcontext(jbpmcontextname); try { if (isauthenticationenabled) { jbpmcontext.setactorid(actorid); } filterchain.dofilter(servletrequest, servletresponse); } finally { jbpmcontext.close(); } }

21 jbpm.sar JBoss Application Server JbpmConfiguration jbpm JBoss jbpm jar DB (hiberante.cfg.xml) jbpmcontext JBoss JNDI

22 Web : action="#{hogebean.ametho d}" HTTP HTTP jbpmcontext JbpmContextFilter JSP Managed Bean HogeBean#aMethod( ) item price user_name isurgentapproval mgr_name Start-state user1 token End-state ActionHandler jbpmcontext facesconfig.xml JSF (Myfaces) Tomcat HttpSession HttpReque st JBoss jbpm Hibernate JBoss AS JbpmConfiguration

23 Web

24 Web JBossAS > set JAVA_HOME=c: java > cd C: jboss jbpm-starters-kit > cd jbpm-server > start.bat JBossAS Web URL

25 Cookie monster

26 web Web sale order

27 web Web sale order[save and Close Task]

28 Orderernie ernie

29 Ernie ernie order

30 Order ernie [more info needed]

31 web GPD

32 GPD JBoss jbpm (GDP) JBoss jbpm Web JBoss AS Web

33 : HelloWorld "cookie monster" (msg) "ernie" (msg) JBoss jbpm "ernie"

34 1. JDK 2. Eclipse SDK 3. JBoss jbpm 4. JBoss jbpm (GPD) 5. JBoss jbpm (GPD)

35 : JDK jdk-1_5_0_11-windows-i586-p.exe Eclipse SDK eclipse-sdk win32.zip JBoss jbpm jbpm-starters-kit zip JBoss jbpm (GPD) jbpm-jpdl-designer zip

36 : 1/3 1. JDK JAVA_HOME 2. Eclipse SDK ECLIPSE_HOME 3. JBoss jbpm > cd C: > mkdir jboss > cd jboss > jar xvf C: jboss_archive jbpm-starters-kit zip 4. JBoss jbpm > cd %ECLIPSE_HOME% > jar xvf C: jboss_archive jbpm-jpdl-designer zip eclipse

37 : 2/3 6. JBoss jbpm (GPD) (1) Eclipse Window Preferences (2) Add Name (JBoss jbpm3.1.4) Location C: jboss jbpm-starters-kit jbpm OK (3) JBoss jbpm (1) (3) (2)

38 : 3/3 7. JBoss AS JBossAS > cd C: jboss jbpm-starters-kit > cd jbpm-server > start.bat JBossAS Web URL [ ] JBoss AS TRACE INFO jbpm-server server jbpm conf log4j.xml ( ) <param name="threshold" value="trace"/> ( ) <param name="threshold" value= INFO"/>

39 : (1) Process Project Eclipse File New Other JBoss jbpm Process Project Next Project Name HelloWorldProcess Finish

40 : (2) Process Definition(JPDL) Java Perspective Package Explorer HelloWorldProcess src/main/jpdl New Other JBoss jbpm Process Definition Process Name HelloWorld Finish

41 : (3) HelloWorldProcess src/main/jpdl/helloworld processdefinition.xml Open With jbpm Graphical Process Designer Start1 Task Node End1 Transition

42 : (4) StartTask Start Add Task Outline View task Properties Controller OK Add Name : msg Read : Write : Required :

43 : (5) Taks Node Task Task Node Add Task Outline View task1 Properties Controller Add Name : msg Read : Write/Required : Assignment type : Expression expression : user(ernie) OK File Save

44 : (6) Deployment Server Deployer ( ) /jbpm-console/upload ( ) /jbpm/upload Test Connection Deploy Process Archive

45 : (7) 1/8 "cookie monster"

46 : (7) 2/8 HelloWorld

47 : (7) 3/8 msg (msg ) "Hello jbpm " "Save and Close Task"

48 : (7) 4/8 Home "Login as another user"

49 : (7) 5/8 "ernie"

50 : (7) 6/8 "Tasklist" "task1" "task1"

51 : (7) 7/8 msg "cookie monster" "Save and Close Task"

52 : (7) 8/8 Home

53 : (8) 1 Monitoring

54 : (8)

55 Web

56

57 < > Step1 : Step2 : Step3 : Step4 : Step5 : ID Step6 : < > Step1 : Step2 : Step3 : Step4 : < > Step1 : Step2 : Step3 : ID D(ID) Step4 : ( )

58

59 jbpmconfiguration JVM DB / user_name mgr_name isurgent approval Start-state End-state <task-node> <task-node> <task-node> item price SelectMgr ActionHandler SendMail ActionHandler SendMail ActionHandler UserAssignment Handler UserAssignment Handler MgrAssignment Handler user1 user1 manager1 jbpm DB EIS jbpmcontext

60 Step1 : Step2 : Step3 : Step4 : Step5 : ID Step6 : "user1" jbpmcontext user_name user1 jbpmcontext jbpmcontext user1 jbpmcontext jbpmcontext user1 jbpmcontext jbpmcontext jbpmconfiguration DB / isurgent item approval Start-state <task-node> <task-node> <task-node> price user1 user1 manager1 user_name mgr_name "user_name" UserAssignment Handler SelectMgr ActionHandler UserAssignment Handler SendMail ActionHandler MgrAssignment Handler SendMail ActionHandler jbpm DB "mgr_name" "manager1" "manager1" EIS mgr_name JVM End-state

61 Web HTTP / Step1 : HttpSession user_name Step2 : Step3 : Step4 : Step5 : Step6 : jbpmcontext user_name user1 jbpmcontext jbpmcontext user1 jbpmcontext jbpmcontext Servlet Filter user1 jbpmcontext jbpmcontext HttpSession user_name Tomcat item isurgent ServletContext jbpmconfiguration approval Start-state <task-node> <task-node> <task-node> price End-state user1 mgr_name UserAssignment Handler SelectMgr ActionHandler user1 UserAssignment Handler manager1 SendMail ActionHandler MgrAssignment Handler SendMail ActionHandler jbpm DB HttpSession EIS user_name"

62 Web: JBoss AS Seasar2 app.dicon web.xml HTML Action Logic JbpmContextFilter S2ContainerFilter Tomcat Step3 : S2JSF JSF Myfaces faces-config.xml S2Container item price user_name isurgentapprovalmgr_name Start-state user1 token End-state JBoss jbpm ActionHandler Hibernate JBoss AS JbpmConfiguration

63 Step3 : HTTP / Step1 : Step2 : Step3 : Step4 : Step5 : Step6 : jbpmcontext user_name user1 jbpmcontext jbpmcontext user1 jbpmcontext jbpmcontext Servlet Filter user1 jbpmcontext jbpmcontext HttpSession user_name item isurgent jbpmconfiguration Tomcat/JBossAS ServletContext approval Start-state <task-node> <task-node> <task-node> price End-state user1 user1 manager1 mgr_name UserAssignment Handler SelectMgr ActionHandler UserAssignment Handler SendMail ActionHandler MgrAssignment Handler SendMail ActionHandler jbpm DB EIS

64 Step3 : HTTP user_input.html HTTP user_confirm.html jbpmcontext JbpmContextFilter S2ContainerFilter Tomcat DTO HTML Step3 : JSF Myfaces S2JSF user_confirm UserAction#input() Action user_confirm jbpmcontext S2Container JBoss AS BpmLogic#input() Logic item price user_name isurgentapprovalmgr_name Start-state token End-state user1 JBoss jbpm ActionHandler JbpmConfiguration Hibernate

65

66 JBoss jbpm JBoss jbpm JBoss jbpm JBoss jbpm Wiki JBoss jbpm getting started guide JBoss jbpm API(Javadoc)

67 JBoss/URL JBoss Open Source & Linux

68 Web

69 Web : pm/ "cookie monster" "Log In" home.jsp home.jsp <h4>start New Process Execution</h4> <h:datatable value="#{homebean.latestprocessdefinitions}" var="processdefinition"...> <f:facet name="header"> <h:outputtext value="start Process Link" /> </f:facet> <h:commandlink action="#{homebean.startprocessinstance}"> <f:param name="processdefinitionid" value="#{processdefinition.id}"/> <h:outputtext value="#{processdefinition.taskmgmtdefinition.starttask.name}" /> </h:commandlink> </h:column>... <h:outputtext value="#{processdefinition.name}" />... <h:outputtext value="#{processdefinition.version}" />

70 Web : (HomeBean) HomeBean.java public class HomeBean {... JbpmContext jbpmcontext; GraphSession graphsession; TaskMgmtSession taskmgmtsession; public HomeBean() { this.jbpmcontext = JbpmContext.getCurrentJbpmContext(); this.graphsession = jbpmcontext.getgraphsession(); this.taskmgmtsession = jbpmcontext.gettaskmgmtsession(); }... public List getlatestprocessdefinitions() { return graphsession.findlatestprocessdefinitions(); }

71 Web : "create new web sale order" task.jsp home.jsp <h4>start New Process Execution</h4> <h:datatable value="#{homebean.latestprocessdefinitions}" var="processdefinition"...> <f:facet name="header"> <h:outputtext value="start Process Link" /> </f:facet> <h:commandlink action="#{homebean.startprocessinstance}"> <f:param name="processdefinitionid" value="#{processdefinition.id}"/> <h:outputtext value="#{processdefinition.taskmgmtdefinition.starttask.name}" /> </h:commandlink> </h:column>

72 Web : (HomeBean) HomeBean.java public String startprocessinstance() { // Get the task instance id from request parameter long processdefinitionid = JsfHelper.getId("processDefinitionId"); ProcessDefinition processdefinition = graphsession.loadprocessdefinition(processdefinitionid); // create a new process instance to run ProcessInstance processinstance = new ProcessInstance(processDefinition); // create a new taskinstance for the start task TaskInstance taskinstance = processinstance.gettaskmgmtinstance().createstarttaskinstance(); // Save the process instance along with the task instance jbpmcontext.save(processinstance); // Fill the task backing bean with useful information taskbean.initialize(taskinstance); return "task"; }

73 Web : item : book quantity : 1 "Save and Close Task" task.jsp <h:form id="taskform"> <h:inputhidden id="taskinstanceid" value="#{taskbean.taskinstanceid}" /> <h2><h:outputtext value="#{taskbean.taskinstance.name}" /></h2><hr /> <h:datatable value="#{taskbean.taskformparameters}" var="formparameter"> <h:column> <h:outputtext value="#{formparameter.label}" />... <h:outputtext value="#{formparameter.description}" />... <h:inputtext value="#{formparameter.value}" readonly="#{formparameter.readonly}" />... </h:datatable> <hr />... <h:commandbutton id="transitionbutton" action="#{taskbean.saveandclose}" value="save and Close Task"/>

74 Web : (TaskBean) TaskBean.java public List gettaskformparameters() { return taskformparameters; } public void initialize(taskinstance taskinstance) { this.taskinstance = taskinstance; this.taskinstanceid = taskinstance.getid(); // set the parameters this.taskformparameters = new ArrayList(); TaskController taskcontroller = taskinstance.gettask().gettaskcontroller(); if (taskcontroller!=null) { List variableaccesses = taskcontroller.getvariableaccesses(); Iterator iter = variableaccesses.iterator(); while (iter.hasnext()) { VariableAccess variableaccess = (VariableAccess) iter.next(); String mappedname = variableaccess.getmappedname(); Object value = taskinstance.getvariable(mappedname); TaskFormParameter tfp = new TaskFormParameter(variableAccess, value); taskformparameters.add(tfp); } // store the parameters in the session JsfHelper.setSessionAttribute("taskFormParameters", taskformparameters); }

75 Web : (TaskBean) TaskBean.java public String saveandclose() { // save save(); // close the task instance String transitionbutton = JsfHelper.getParameter("taskform:transitionButton"); TaskInstance taskinstance = taskmgmtsession.loadtaskinstance(taskinstanceid); if ("Save and Close Task".equals(transitionButton)) { taskinstance.end();... }... jbpmcontext.save(taskinstance); return "home"; } public String save() {... // submit the parameters in the jbpm task controller TaskInstance taskinstance = taskmgmtsession.loadtaskinstance(taskinstanceid); // collect the parameter values from the values that were updated in // the parameters by jsf. Iterator iter = taskformparameters.iterator(); while (iter.hasnext()) { TaskFormParameter taskformparameter = (TaskFormParameter) iter.next(); if ((taskformparameter.iswritable()) && (taskformparameter.getvalue()!= null)) { taskinstance.setvariable(taskformparameter.getlabel(), taskformparameter.getvalue());... } } // save the process instance and hence the updated // task instance variables jbpmcontext.save(taskinstance); // remove the parameters from the session JsfHelper.removeSessionAttribute("taskFormParameters"); return "home"; }

76 Web : m/ "ernie" "Log In" home.jsp home.jsp <h4>tasklist</h4> <h:datatable value="#{homebean.taskinstances}" var="taskinstance"...> <h:column > <f:facet name="header"> <h:outputtext value="task Form Link" /> </f:facet> <h:commandlink action="#{homebean.selecttaskinstance}"> <f:param name="taskinstanceid" value="#{taskinstance.id}"/> <h:outputtext value="#{taskinstance.name}" /> </h:commandlink> </h:column>... <h:outputtext value="#{taskinstance.taskmgmtinstance.taskmgmtdefinition.processdefinition.name}" />... <h:outputtext value="#{taskinstance.taskmgmtinstance.taskmgmtdefinition.processdefinition.version}" />

77 Web : (HomeBean) HomeBean.java public class HomeBean {... JbpmContext jbpmcontext; GraphSession graphsession; TaskMgmtSession taskmgmtsession; public HomeBean() { this.jbpmcontext = JbpmContext.getCurrentJbpmContext(); this.graphsession = jbpmcontext.getgraphsession(); this.taskmgmtsession = jbpmcontext.gettaskmgmtsession(); }... public List gettaskinstances() { return taskmgmtsession.findtaskinstances(userbean.getusername()); }

78