jBPM jPDL 用户开发手册 - 第9章

最新推荐文章于 2021-08-23 15:31:41 发布
最新推荐文章于 2021-08-23 15:31:41 发布
阅读量252 收藏
点赞数
分类专栏： workflow 文章标签： JBPM Hibernate EJB JMS Bean

第9章Java EE 应用服务器工具

本章将描述jBPM提供的工具，它对Java EE基础架构起到一个杠杆的作用。

9.1. EJB

CommandServiceBean是一个无状态的会话bean，它在独立的jBPM上下文里通过调用它的execute方法执行jBPM命令。下表中总结了可定制的环境入口和资源。
名称
类型
描述
JbpmCfgResource
环境入口
用来读jBPM配置的类路径资源。可选，缺省是jbpm.cfg.xml。
ejb/LocalTimerEntityBean
EJB 引用
连接到实现任务服务的本地实体bean。当包含定时器时是流程需要。
jdbc/JbpmDataSource
资源管理器引用
给jBPM持久化服务提供JDBC连接的数据源的逻辑名。必须同hibernate配置文件中的hibernate.connection.datasource属性相匹配。
jms/JbpmConnectionFactory
资源管理器引用
给jBPM消息服务提供JMS连接的工厂的逻辑名称。包含同步连续的流程需要。
jms/JobQueue
消息目的引用
jBPM消息服务发送工作消息到这里引用的队列。为了确保这个和job监听器bean收到消息是同一个队列，message-destination-link指出一个通用的逻辑目标, JobQueue。

表 9-1 Command service bean环境

CommandListenerBean是一个在JbpmCommandQueue上用来监听命令消息消息驱动bean。这个bean为CommandServiceBean代理命令执行。
消息体必须是一个实现了org.jbpm.Command 接口的Java对象。消息属性，如果有的话，将被忽略。如果消息不匹配预期的格式，它被转进DeadLetterQueue中。不再进一步地处理那个消息。如果缺少目标引用的话，消息被拒绝。
这样收到的消息指定了一个replyTo目标，命令执行的结果就是打包消息对象并发送到那里。命令连接工厂环境引用显示JMS连接所支持的资源管理器。

相反，JobListenerBean是一个在JbpmJobQueue上用来监听工作消息的消息驱动bean来支持异步连续（asynchronous continuations）。

消息必须有一个叫jobId的长整数类型属性引用一个数据库中的待决的工作。对于消息体，如果有的话，可以忽略。
这个bean扩展CommandListenerBean并且可定制来继承它的环境入口和资源引用。
名称
类型
描述
ejb/LocalCommandServiceBean
EJB引用
链接到在独立的jBPM上下文上执行命令的本地会话baen。
jms/JbpmConnectionFactory
资源管理器引用
给产生结果消息的JMS连接提供本地工厂的逻辑命名。命令消息需要显示一个回复目标。

jms/DeadLetterQueue ce
消息目标引用
不包含命令的消息被送到这里引用的队列。可选的，如果没有的话，这消息将被驳回，可能导致容器再投递消息。

表 9-2 Command/Job监听器bean环境

TimerEntityBean同EJB定时器服务共同作用来调度jBPM定时器。在定时到期后，定时器的执行才真正地被委托给命令服务bean。

为了读取定时器的数据定时器的实体bean需要访问jBPM数据源。EJB部署符没有提供一种方式去定义如何让一个实体bean映射到一个数据库。这个留给了容器的提供器（provider）。在JBoss AS中，jbosscmp-jdbc.xml描述符定义数据源JNDI名和关系映射数据（它们中的表和列名）。注意JBoss XMP描述符使用一个全书JNDI名（java:JbpmDS），这和资源管理器引用形成对照（java:comp/env/jdbc/JbpmDataSource）。

jBPM较早版本使用一个叫TimerServiceBean的无状态会话bean同EJB定时器服务交互。这session方案不得不被放弃了因为在cancelation方法中有一个不可避免的瓶颈问题。因为会话bean没有身份，定时器服务被迫去迭代所有的定时器来查找出已经退出的。这个bean仍然是围绕着向后的兼容性。它像TimerEntityBean一样工作在相同的环境下，以至于更容易迁移。
名称
类型
描述
ejb/LocalCommandServiceBean
EJB引用

链接到独立的jBPM上下文中执行定时器的本地{@linkplain CommandServiceBean会话bean}。

表 9-2 Command/Job监听器bean环境

9.2. jBPM企业配置

jbpm.cfg.xml包含下列的配置项：
<jbpm-context>

  <service name="persistence"

           factory="org.jbpm.persistence.jta.JtaDbPersistenceServiceFactory" />

  <service name="message"

           factory="org.jbpm.msg.jms.JmsMessageServiceFactoryImpl" />

  <service name="scheduler"

           factory="org.jbpm.scheduler.ejbtimer.EntitySchedulerServiceFactory" />

</jbpm-context>
JtaDbPersistenceServiceFactor允许jBPM加入JTA事务。如果一个现有的事务正在进行的话，JTA持久化事务将保持它，否则它开始一个新的事务。jBPM企业bean配置为给窗口分派一个事务管理。然而，如果你在没有活动的事务的环境中创建一个JbpmContext的话（也就是说，在一个web应用中），一个事务将自动开始。JTA持久化服务工厂有个下面描述的配置域。

·           isCurrentSessionEnabled：如果是true，jBPM将使用同进行的JTA事务关联的“当前”Hibernate会话。这是缺省设置。参考Hibernate手册，2.5 Contextual sessions节描述了这个行为。你可以利用session机制的上下文关系来使用被jBPM在应用的其他部分通过调用SessionFactory.getCurrentSession()取得的同一个session。另一方面，你可以让jBPM支持你自己的hibernate session。这样做的话，设置isCurrentSessionEnabled为false并通过JbpmContext.setSession(session)方法注入session。这也要确保jBPM同你应用的其他部分使用相同的Hibernate session。注意，Hibernate session可能通过持久化上下文注入到无状态的会话bean中。

·           isTransactionEnabled：这个域值为true意味着jBPM将通过Hibernate的事务API（Hibernate手册的11.2数据库事务分界部分显示了这些API）用JbpmConfiguration.createJbpmContext()来创建事务，使用JbpmContext.close()来提交事务并关闭Hibernate会话。当jBPMp以ear来部署时这绝对不是一个期望的行为，因此isTransactionEnabled缺省情况下设置为false。

JmsMessageServiceFactoryImpl对可靠的通信基础结构有一个杠杆作用通过暴露的JMS接口传递异步连续消息到JobListenerBean。JMS消息服务工厂暴露下列的配置域。
  • connectionFactoryJndiName: 在JNDI初始上下文中的JMS连接工厂的名字。对于Java缺省是：comp/env/jms/JbpmConnectionFactory。
  • destinationJndiName: 工作消息将被传送那里JMS目标的名字。必须同JobListenerBean 接收消息的目标相匹配。对于java缺省是：comp/env/jms/JobQueue。
  • isCommitEnabled: 告诉jBPM是否应该使用JbpmContext.close()提交JMS会话。消息被JMS消息服务产生，那就意味着（消息）在当前的事务提交前将从不会被接收。因此通过服务创建的JMS会话总是被处理。当在用的连接工厂是XA时缺省的值false是合适的，同样的JMS会话产生的消息将通过被全部的JTA事务控制。这个域应该被设置为true如果JMS连接工厂不是XA的话，因此jBPM将明确地提交这个JMS会话的本地事务。
EntitySchedulerServiceFactory构建在事务告知服务上，为EJB容器提供的定时事件调度企业流程定时器。EJB调度服务工厂有下面描述的可配置域。
  • timerEntityHomeJndiName: TimerEntityBean 在JNDI初始上下文中的本地home接口的名称。对于java缺省是：comp/env/ejb/LocalTimerEntityBean.

9.3. Hibernate企业配置

hibernate.cfg.xml包含下列被修改后去支持其他数据库或应用服务器的配置项目：

<!-- sql dialect -->

<property name="hibernate.dialect">org.hibernate.dialect.HSQLDialect</property>

 

<property name="hibernate.cache.provider_class">

  org.hibernate.cache.HashtableCacheProvider

</property>
 

<!-- DataSource properties (begin) -->

<property name="hibernate.connection.datasource">java:comp/env/jdbc/JbpmDataSource</property>

<!-- DataSource properties (end) -->

 

<!-- JTA transaction properties (begin) -->

<property name="hibernate.transaction.factory_class">

  org.hibernate.transaction.JTATransactionFactory

</property>

<property name="hibernate.transaction.manager_lookup_class">

  org.hibernate.transaction.JBossTransactionManagerLookup

</property>

<!-- JTA transaction properties (end) -->

 

<!-- CMT transaction properties (begin) ===

<property name="hibernate.transaction.factory_class">

  org.hibernate.transaction.CMTTransactionFactory

</property>

<property name="hibernate.transaction.manager_lookup_class">

  org.hibernate.transaction.JBossTransactionManagerLookup

</property>

==== CMT transaction properties (end) -->

你可以符合你的数据库管理系统的一个方言来替换hibernate.dialect。hibernate参考手册在3.4.1 SQL方言部分列举了可用的数据库方言。

HashtableCacheProvider能够使用其他支持的缓存提供器实替换。对于支持的缓存提供器列表可以查阅hibernate手册19.2 二级缓存部分。

JbossTransactionManagerLookup可以被一个策略替换适合的不同于JBoss的应用服务器。查看3.8.1 事务策略配置部分找到符合每个应用服务器的lookup类。

注意用于hibernate.connection.datasourceJNDI名称， 实际上，是一个资源管理器引用，可移植多应用服务器。也就是说引用意味着一个真正的数据源在部署时绑定到目标服务器上。在包含的jboss.xml描述符中，引用绑定到java:JbpmDS上。
默认包中，jBPM被配置使用JTATransactionFactory。如果一个现有的事务是正在进行中的话，JTATransaction工厂使用它，否则它创建一个新的事务。jBPM企业Bean被配置委派事务管理到容器上。然而，如果你使用的jBPM API在没有的事务活动事务的上下文中的话（也就是说，在一个web应用中），一个事务被将自动开始。
如果你自己的EJB容器管理事务并且你想限制非计划的事务创建的话，你可以切换到 CMTTransactionFactory。使用空上设置，hibernate将总是查找一个现有的事务并且如果什么也没有找到的话就汇报问题。

9.4. 客户端组件

客户组件依赖jBPM API编写，希望对企业服务确保他们的部署描述符在适当的位置有个合适的环境引用起到杠杆作用。
下面的描述符可以被看作典型的客户端会话Bean。
<session>
 

  <ejb-name>MyClientBean</ejb-name>

  <home>org.example.RemoteClientHome</home>

  <remote>org.example.RemoteClient</remote>

  <local-home>org.example.LocalClientHome</local-home>

  <local>org.example.LocalClient</local>

  <ejb-class>org.example.ClientBean</ejb-class>

  <session-type>Stateless</session-type>

  <transaction-type>Container</transaction-type>

 

  <ejb-local-ref>

    <ejb-ref-name>ejb/LocalTimerEntityBean</ejb-ref-name>

    <ejb-ref-type>Entity</ejb-ref-type>

    <local-home>org.jbpm.ejb.LocalTimerEntityHome</local-home>

    <local>org.jbpm.ejb.LocalTimerEntity</local>

  </ejb-local-ref>

 

  <resource-ref>

    <res-ref-name>jdbc/JbpmDataSource</res-ref-name>

    <res-type>javax.sql.DataSource</res-type>

    <res-auth>Container</res-auth>

  </resource-ref>

 

  <resource-ref>

    <res-ref-name>jms/JbpmConnectionFactory</res-ref-name>

    <res-type>javax.jms.ConnnectionFactory</res-type>

    <res-auth>Container</res-auth>

  </resource-ref>

 

  <message-destination-ref>

    <message-destination-ref-name>jms/JobQueue</message-destination-ref-name>

    <message-destination-type>javax.jms.Queue</message-destination-type>

    <message-destination-usage>Produces</message-destination-usage>

  </message-destination-ref>

 
</session>

被提供的目标服务器是JBoss，上面的环境引用可以像后面的那样被绑定资源在目标操作环境上。注意JNDI名称必须同jBPM Bean使用的值相匹配。

<session>
 

  <ejb-name>MyClientBean</ejb-name>

  <jndi-name>ejb/MyClientBean</jndi-name>

  <local-jndi-name>java:ejb/MyClientBean</local-jndi-name>

 

  <ejb-local-ref>

    <ejb-ref-name>ejb/LocalTimerEntityBean</ejb-ref-name>

    <local-jndi-name>java:ejb/TimerEntityBean</local-jndi-name>

  </ejb-local-ref>

 

  <resource-ref>

    <res-ref-name>jdbc/JbpmDataSource</res-ref-name>

    <jndi-name>java:JbpmDS</jndi-name>

  </resource-ref>

 

  <resource-ref>

    <res-ref-name>jms/JbpmConnectionFactory</res-ref-name>

    <jndi-name>java:JmsXA</jndi-name>

  </resource-ref>

 

  <message-destination-ref>

    <message-destination-ref-name>jms/JobQueue</message-destination-ref-name>

    <jndi-name>queue/JbpmJobQueue</jndi-name>

  </message-destination-ref>

 
</session>
假使客户端组件是一个web应用，与企业Bean形成对照，部署描述符看起来像这样：
<web-app>
 

  <servlet>

    <servlet-name>MyClientServlet</servlet-name>

    <servlet-class>org.example.ClientServlet</servlet-class>

  </servlet>

 

  <servlet-mapping>

    <servlet-name>MyClientServlet</servlet-name>

    <url-pattern>/client/servlet</url-pattern>

  </servlet-mapping>

 

  <ejb-local-ref>

    <ejb-ref-name>ejb/LocalTimerEntityBean</ejb-ref-name>

    <ejb-ref-type>Entity</ejb-ref-type>

    <local-home>org.jbpm.ejb.LocalTimerEntityHome</local-home>

    <local>org.jbpm.ejb.LocalTimerEntity</local>

    <ejb-link>TimerEntityBean</ejb-link>

  </ejb-local-ref>

 

  <resource-ref>

    <res-ref-name>jdbc/JbpmDataSource</res-ref-name>

    <res-type>javax.sql.DataSource</res-type>

    <res-auth>Container</res-auth>

  </resource-ref>

 

  <resource-ref>

    <res-ref-name>jms/JbpmConnectionFactory</res-ref-name>

    <res-type>javax.jms.ConnectionFactory</res-type>

    <res-auth>Container</res-auth>

  </resource-ref>

 

  <message-destination-ref>

    <message-destination-ref-name>jms/JobQueue</message-destination-ref-name>

    <message-destination-type>javax.jms.Queue</message-destination-type>

    <message-destination-usage>Produces</message-destination-usage>

    <message-destination-link>JobQueue</message-destination-link>

  </message-destination-ref>

 
</web-app>
如果目标应用服务器是JBoss的话，上面的环境引用能够像下面一样在目标操作的环境中绑定到资源上。
<jboss-web>
 

  <ejb-local-ref>

    <ejb-ref-name>ejb/LocalTimerEntityBean</ejb-ref-name>

    <local-jndi-name>java:ejb/TimerEntityBean</local-jndi-name>

  </ejb-local-ref>

 

  <resource-ref>

    <res-ref-name>jdbc/JbpmDataSource</res-ref-name>

    <jndi-name>java:JbpmDS</jndi-name>

  </resource-ref>

 

  <resource-ref>

    <res-ref-name>jms/JbpmConnectionFactory</res-ref-name>

    <jndi-name>java:JmsXA</jndi-name>

  </resource-ref>

 

  <message-destination-ref>

    <message-destination-ref-name>jms/JobQueue</message-destination-ref-name>

    <jndi-name>queue/JbpmJobQueue</jndi-name>

  </message-destination-ref>

 
</jboss-web>

 

 

昨天去医大看牙医了，要不昨天就能翻译完成的，可是没有...... :< ,还得今天起个大早

but all has got it! :~;

 

zhang_yuming
关注
  • 0
    点赞
  • 踩
  • 0
    收藏
    觉得还不错? 一键收藏
  • 0
    评论
专栏目录
jBPM jPDL 用户开发手册 - 第8章
03-10
图片较多，不好传，先将mht格式全文上传，如需要请下载查看！ 博文链接：https://zhangym.iteye.com/blog/231403
JPDL介绍
u010872015的专栏
06-09 684
JPDL介绍
jpdl 流程定义语言的使用
欢迎来到跃行者技术博客
07-19 1524
一、jpdl 流程定义语言的使用 l  process（流程） l  transition （连线、转移） l  流转控制活动 •    start （开始活动） •    end、end-error、end-cancel （结束活动） •    state （状态活动） •    task （任务活动） •    decision （判断活动） •   fork、join （分
JBPM（三）--- JPDL 流程定义语言
一个无限死循环的博客
06-10 2162
JPDL 全称JBossjBPMProcessDefinitionLanguage，是JBPM的流程定义语言。JPDL流程定义语言主要掌握以下几种： 1.process （流程） 2.transition （连线、转移） 3.start （开始活动） 4.end、end-error、end-cancel （结束活动） 5.state （状态活动） 6.task （任务活动） 7.dec
jPdl介绍
tutugogo的专栏
05-22 4336
 jPdl描述的是流程的过程，是通过状态表示，流程由几个元素组成。流程的走向由transition元素指定。Start-state就是开始节点State就是流程的活动Process-state就是子流成Decision是判断节点Fork是分支节点Join是联合节点（注意fork和join必须成对出现）End-state是结束节点 
activiti 手动创建定时任务——衍生定时任务
喵″的博客
05-06 9992
很多时候，我们想像Activiti定时开始事件一样，加入一些自己的定时流程。但定时开始事件有很大的局限性，比如时间、循环次数、循环间隔是必须要指定的，这对于一些根据实际状况，计算时间并启动的流程是无法处理的。 通过一系列的源码分析，最终找到了手动建立Job的方式方法
jBPM_用户开发手册-中文版
03-22
jBPM_用户开发手册
jbpm-jpdl-suite-3.2.3.zip
06-11
jbpm-jpdl-suite-3.2.3.zip工作流 设计器
jbpm-jpdl-designer-3.0.13.zip_jbpm_jbpm design_jbpm designer_jbp
09-21
jbpm-jpdl-designer-3.0.13 关于jbpm的jpdl 设计器
JBPM中 使用JobExecutor执行timer定义的job
hzhlu的博客
07-27 166
Job executor在jbpm.cfg.xml中是被缺省注释的，所以只要去掉此行即可通过JobExecutor来定时触发timer中的event-handler了 [code="xml"] [/code] 测试程序 [code="java"] /** * @author hz...
jbpm-jpdl 　
05-01
jbpm-jpdl-3.2.3
JBoss_jBPM_jPDL用户开发手册_3.2.3.pdf 中文-(转)zhangym
10-17
转发zhangym翻译的JBoss_jBPM_jPDL用户开发手册_3.2.3.pdf 共199页 24章。
jbpm jpdl 帮助文档pdf版
10-07
jbpm jpdl 帮助文档pdf版jbpm jpdl 帮助文档pdf版jbpm jpdl 帮助文档pdf版jbpm jpdl 帮助文档pdf版
jpdl定义语言
10-06
关于jbpm流程开发，的jdpl建模语言，包含各个控件的属性使用。
jBPM-jPDL学习笔记
zhang_yuming的专栏
08-08 152
      最近正在研究工作流相关的内容，准备使用下 jBoss 下面的 jBPM 这个工作流引擎，但是这方面的文档太少了，看到了网上一朋友（linliangyi2007）的整理的资料，他的blog主页的网址如下，有兴趣的可以去看下： Java、咖啡与茶       看着不错，很详细，我整理了下他的文章，形成了一份文档（pdf）的，供大家参考，版权linliangyi2007所有。:!~     ...
深入浅出JBPM读书笔记(四)_jbpm基础
naxsu的专栏
04-04 107
1.JbpmConfiguration和JbpmContext讲解 它们是操作jbpm流程的对象，通过它们可以实现针对jbpm流程的所有操作。 JbpmConfiguration： 用来读取JBPM配置文件的对象。 通过该对象，可以获取JBPM配置文件里的所有配置信息。 该对象提供了JBPM流程在运行过程中所需要的各种服务对象。 JBPM默认配置文件：jbpm-jpdl-3...
使用Java开源工作流jBPM开发一个简单的Demo
热门推荐
滔滔江水的技术博客
09-15 1万+
    jBPM是jboss旗下遵守LGPL许可的java开源工作流，功能比较完善，从4.0开始引入了pvm的概念，支持jPDL、BPEL等流程定义语言。由于相关资料还比较少，开发自己的一个demo还不是太容易，本文详细讲解如何做一个简单的demo程序。     我们从http://www.jboss.org/jbossjbpm/jbpm_downloads/下载jBPM，实际使用时发现4
最通俗易懂的字节码插桩实战（Gradle + ASM）—— 优雅的打印方法执行时间
m0_61170579的博客
08-23 734
前言 做项目优化时，我们通常会先打印出方法的执行时间，再根据方法的耗时情况对其进行优化。代码如下： public static void main(String[] args) { long startTime = System.currentTimeMillis(); //... long endTime = System.currentTimeMillis(); System.out.println("程序运行时间： " + (e
《精通idea整合web开发——struts+spring+hibernate+jbpm》
最新发布
08-20
《精通Idea整合Web开发-Struts Spring Hibernate JBPM》是一本关于使用Idea开发工具进行整合Web开发的书籍。该书主要介绍了Struts、Spring、Hibernate和JBPM等技术的使用和整合方法。 Struts是一个开源的MVC框架，提供了一套简化Web应用程序开发的解决方案。本书详细介绍了如何使用Struts框架进行Web开发，包括配置文件的编写、控制器和视图的设计等。 Spring是一个轻量级的Java开发框架，提供了丰富的功能和模块，包括依赖注入、面向切面编程等。本书介绍了如何使用Spring框架来实现Web应用程序的开发，并与其他技术进行整合。 Hibernate是一个开源的对象-关系映射框架，可以简化与关系数据库的交互。该书详细介绍了使用Hibernate进行数据持久化的方法，包括配置文件的编写、实体类的映射等。 JBPM是一个开源的工作流引擎，可以帮助开发人员轻松地定义和管理业务流程。本书介绍了如何使用JBPM框架进行业务流程的建模和执行。 通过整合Struts、Spring、Hibernate和JBPM等技术，开发人员可以更加高效地进行Web应用程序的开发。《精通Idea整合Web开发-Struts Spring Hibernate JBPM》详细介绍了这些框架的使用方法和整合技巧，对于想要深入学习和应用这些技术的读者来说，是一本非常实用的参考书籍。

“相关推荐”对你有帮助么？

  • 非常没帮助
  • 没帮助
  • 一般
  • 有帮助
  • 非常有帮助
提交
评论
添加红包

请填写红包祝福语或标题

个

红包个数最小为10个

元

红包金额最低5元

当前余额3.43元 前往充值 >
需支付：10.00元
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付元
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明：

1.余额是钱包充值的虚拟货币，按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载，可以购买VIP、付费专栏及课程。

余额充值