使用向导创建消息驱动的 Bean
您可以使用“创建 EJB 3.x 消息驱动的 Bean”向导来创建消息驱动的 Bean 并将其添加至项目。
开始之前
关于此任务
消息驱动的 Bean 与会话 Bean 之间的主要差异是,消息驱动的 Bean 没有本地或远程接口。相反,它只有一个 Bean 类。
过程
- 在 Java EE 透视图中,右键单击项目,然后,选择新建 > 消息驱动的 Bean。此时将打开“创建 EJB 3.x 消息驱动的 Bean”向导。
- 在源文件夹字段中,为新 Bean 选择源文件夹。
- 在包字段中,输入新 Bean 的包名。
- 在名称字段中,输入要指定给消息驱动的 Bean 的名称。按照惯例,Bean 名称以大写字母开头。
- 在目标名称字段中,输入要指定给目标的名称。
- 选择 JMS 以使用 Java 消息传递服务,或者取消选中 JMS 以使用另一个消息传递服务。
- 在目标类型字段中,选择队列或主题目标类型,然后单击下一步。
- 在特定于消息驱动的 Bean 的信息页面中的事务类型字段内,选择容器(适用于容器管理的事务)或 Bean(适用于 Bean 管理的事务)。
- 单击完成。Java 编辑器包含消息驱动的 Bean 类的缺省代码:
package com.ibm.test; import javax.ejb.ActivationConfigProperty; import javax.ejb.MessageDriven; import javax.jms.Message; import javax.jms.MessageListener; /** * Message-Driven Bean implementation class for: TestMdb * */ @MessageDriven( activationConfig = { @ActivationConfigProperty( propertyName = "destinationType", propertyValue = "javax.jms.Queue" ) }) public class TestMdb implements MessageListener { /** * Default constructor. */ public TestMdb() { // TODO Auto-generated constructor stub } /** * @see MessageListener#onMessage(Message) */ public void onMessage(Message message) { // TODO Auto-generated method stub } }在这个缺省消息驱动的 Bean 代码示例中,需要注意以下几个要点:- 在 EJB 3.x 中,@MessageDriven 注释指定一组激活配置参数。对于用于驱动消息驱动的 Bean 的特定类型的 JCA 1.5 适配器而言,这些参数是特有的。某些适配器具有一些配置参数,这些配置参数允许您指定消息驱动的 Bean 的目标队列。 如果适配器不支持,那么必须在 XML 绑定文件中使用 <message-destination> 条目来指定目标名称。
- Bean 类必须实现 MessageListener 接口,该接口仅定义一个方法:onMessage。当消息到达由此 MDB 监视的队列中时,容器将调用 Bean 类的 onMessage 方法并将入局消息作为参数传入。
- @MessageDriven 注释的 ActivationConfigProperty 提供了特定于消息传递系统的配置信息。
父主题: 使用向导创建企业 Bean