快速应用JMS控件访问JMS资源

　　JMS定义了Java中访问消息中间件的接口,是企业资源异步访问的主要形式。JMS可以和EJB技术集成使用，也就是常说的消息驱动BEAN。

　　因为访问JMS和访问Entity EJB和SessionEJB的调用方法有很大的差异，所以Beehive中提供了专门的JMS控件来完成JMS资源的访问。

　　创建JMS控件的典型步骤

　　Beehive中提供的JMS控件无法直接用于访问JMS资源，使用者必须继承JMS控件来创建自己的访问控件，设置相关的环境后才能完成JMS资源的访问。一个继承控件中只能对应的访问唯一一个消息队列/主题，如果需要向多个消息队列/主题发送消息，必须针对每个消息队列/主题提供相应的控件。

　　你可以使用下面的步骤来创建自己的控件实现对JMS资源的访问：

　　创建新的Java接口，继承JMSControl接口

　　用@ControlExtension关键字注释新创建的Java接口，通知解析器这个接口继承了另外的某个控件。

　　使用@JMSControl.Destination注释新创建的Java接口，说明控件如何搜索消息队列/主题，同时使用sendType声明发送目标是消息队列还是消息主题。

　　创建新的业务方法，使用JMSControl.Message注释来声明被发送消息的类型，或者使用不同的参数来区别不同的消息类型。

　　使用控件访问消息队列的例子

　　在本节中，我们将通过简单的例子演示如何使用JMS控件来访问监听消息队列的消息驱动Bean。我们假设存在一个消息驱动Bean，他接受用户传递的文本消息(TextMessage)，随后将该文本消息打印在应用服务器的控制台上。该消息驱动Bean监听消息队列(jndiname=”queue/helloworld”)。

　　Beehive并不仅仅限于WebLogic平台使用，我们这里以JBoss为例。我们使用Eclipse+WTP(Web Tools Platform)工具开发符合要求的消息驱动Bean以及JMS队列，发布在JBoss上。

　　本文中所有例子的源代码可以在通过资源下载区中的连接完成下载。

　　开发消息驱动Bean

　　现在我们来开发提供上述功能的消息驱动Bean，使用WTP的向导完成消息驱动Bean的创建工作，剩下的工作就是根据业务的需求完成onMessage方法的编写了。

　　根据演示实例的要求，我们修改onMessage方法，让它处理TextMessage类型的消息，并且将消息的内容打印在控制台上，清单1中列出了消息驱动Bean类的源代码。如何开发、编译和部署请参考JBoss的帮助文档，这里不提供详细的说明。

　　接下来的JMS、EJB开发、部署和控件访问部分内容针对JBoss应用服务器。实际情况下，你可能根据不同情况选择其他的J2EE容器比如Websphere 、WebLogic、Geronimo、JOnAS等作为EJB容器，请根据下面的提示信息进行适当的调整。

　　清单1 ejbsrc\org\vivianj\beehive\controls\examples\ejb\MessageBeanOnQueue.java

　　1. package org.vivianj.beehive.controls.examples.ejb;

　　2.

　　3. import javax.ejb.*;

　　4. import javax.jms.*;

　　5.

　　6. public class MessageBeanOnQueue

　　7. implements MessageDrivenBean, MessageListener

　　8. {

　　9. public void onMessage(Message msg) {

　　10. TextMessage tm = null;

　　11. if (msg instanceof TextMessage){

　　12. tm = (TextMessage) msg;

　　13. try{

　　14. System.out.println(tm.getText());

　　15. }catch(Exception e){

　　16. e.printStackTrace();

　　17. }

　　18. }

　　19. }

　　20. }

　　

　　在部署消息驱动Bean之前，我们还应该在JBoss服务器上配置一个JNDI名称为“queue/helloworld”的消息队列。请大家参考JBoss应用服务器的帮助文档完成这部分工作。

　　JMS控件开发

　　现在我们来使用JMS控件编写代码访问消息驱动Bean。由于消息驱动Bean没有本地或者远程访问方法，只能通过向JMS目标发送消息来完成消息驱动Bean资源的调用。

　　清单2中的代码是访问一个JMS目标对列的简单例子，它提供sendTextMessage方法，接收String类型的参数msn，当sendTextMessage方法被调用时，控件负责连接到JMS对列(“queue/helloworld”)，将接收到的参数msg发送到目标服务器上。

　　清单2 src\org\vivianj\beehive\controls\examples\controls\

　　HelloWorldQueueJMSControl.java

　　1. package org.vivianj.beehive.controls.examples.controls;

　　2.

　　3. import org.apache.beehive.controls.api.bean.ControlExtension;

　　4. import org.apache.beehive.controls.system.jms.JMSControl;

　　5.

　　6. /**

　　7. * HelloWorldQueueJMSControl 是访问JMS资源的控件

　　

　　8. * 可向JMS对列发送字符串类型的消息

　　9. */

　　10.

　　11. @ControlExtension

　　12. @JMSControl.Destination(sendJndiName = “queue/helloworld”,

　　13. jndiConnectionFactory =

　　14. “org.jnp.interfaces.NamingContextFactory”,

　　15. jndiProviderURL=“jnp://localhost:1099”,

　　16. sendType=DestinationType.Queue)

　　17. public interface HelloWorldQueueJMSControl

　　18. extends JMSControl {

　　19. @JMSControl.Message(MessageType.Text)

　　20. public void sendTextMessage(String msg);

　　21. }

　　

　　JMS控件调用

　　现在我们可以使用如下方法来完成上面所创建控件的调用。

　　使用声明式控件实例化定义成员变量_jmsControl.

　　@Control

　　HelloWorldQueueJMSControl _jmsControl;

　　调用控件的业务方法完成向JMS对列发送消息的功能。由于消息服务本身是没有返回内容的，所以我们只需要完成业务方法的调用即可。

　　下面的调用代码可以实现向服务器发送”Hello World!”字符串的功能。

　　_jmsControl.sendTextMessage(“Hello World!”);

　　测试控件

　　一切准备就绪后，启动JBoss服务器，参考《控件入门》中“使用JUnit测试控件”部分的内容，编写单元测试TestCase测试新创建的JMS控件。

　　实例分析

　　从上面的例子中我们可以看到，访问JMS资源的时候，开发者的工作被大大的简化了。开发者只需要开发一个继承自JMS控件的控件，使用JMS控件中规定的注释提供访问JMS资源所需要的一些环境参数，随后便可以使用声明式控件实例化方式完成控件的实例化，通过调用该控件实例的相关业务方法完成JMS资源的访问。

　　现在我们来分析一下上面创建的EJB控件-- HelloWorldQueueJMSControl (参见清单2)中的主要代码。

　　11. @ControlExtension

　　在控件例子的11行，我们通过@ControllerExcention关键词来说明接下来声明的这个接口是另外一个控件的扩展。

　　12. @JMSControl.Destination(sendJndiName = “queue/helloworld”,

　　13. jndiConnectionFactory =

　　14. “org.jnp.interfaces.NamingContextFactory”,

　　15. jndiProviderURL=“iiop://localhost:7001”,

　　16. sendType=DestinationType.Queue))

　　

　　在第12~16行代码中我们使用JMSControl.Destination关键词和它的sendJndiName、jndiConnectionFactory、jndiProviderURL和sendType属性来设置我们要访问消息队列/主题在目标服务器中发布时使用的jndiName和访问目标服务器需要提供的相关环境变量。

　　17. public interface HelloWorldQueueJMSControl

　　18. extends JMSControl {

　　在第17~18行中，我们声明该控件继承了JMSControl接口。

　　19. @JMSControl.Message(MessageType.Text)

　　在第19行，我们使用@JMSControl.Message关键字来声明接下来的这个业务方法发送消息的类型是TextMessage。

　　20. public void sendTextMessage(String msg);

　　

　　第20行代码我们声明了一个方法，这个方法需要向目标消息队列/主题发送参数msg提供的字符串。

　　完成这些工作，我们就可以调用该控件声明的方法实现向目标消息队列/主题发送JMS消息了，如何与目标应用服务器交互的工作由控件来辅助完成。

　　使用注释定制JMS控件

　　在上面的内容中，我们已经新建了一个JMS控件，它提供sendTextMessage方法，调用该方法能够向消息对列”queue/helloworld”发送消息。在JMS控件代码中，我们使用了@JMSControl.Destination我们使用了@JMSControl.Destination和@JMSControl.Message两个注释来提供访问JMS资源的参数。

　　JMS控件支持10个注释，他们分别是@JMSControl.CorrelationId、@JMSControl.Delivery 、@JMSControl.Destination 、@JMSControl.Expiration 、@JMSControl.Message 、@JMSControl.Priority 、@JMSControl.Properties 、@JMSControl.Property 、@JMSControl.PropertyValue 、@JMSControl.Type

　　下面我们详细的介绍其中最常用的@JMSControl.Destination和@JMSControl.Message两个注释的属性和用法，了解如何用这注释定制JMS控件的更多细节。

　　Destination注释

　　Destination注释是类级别的注释，用于定制JMS控件发送消息的目标消息队列/主题的jndiName和它们所在目标容器的相关参数。Destination注释提供了八个参数用于用户定制，下面将介绍常用的四个：sendJndiName、jndiConnectionFactory、 sendType、jndiProviderURL，其中sendJndiName和jndiConnectionFactory是必须的，其他的可以根据不同的情况选择性的使用。

　　sendJndiName

　　字符串类型的属性，用于设置目标消息队列或者主题的JNDI名称。

　　sendType

　　JMSControl.DestinationType类型的属性，可选值有三个：DestinationType.Auto（自动适配类型），DestinationType.Topic(主题)和DestinationType.Queue（队列），如果使用DestinationType.AUTO，控件将根据sendJndiName中指定的目标消息类型进行适配。

　　jndiConnectionFactory

　　字符串类型的属性，设置访问EJB JNDI上下文环境需要使用工厂类，和具体的目标EJB服务器相关。比如访问JBoss服务器上的JMS资源时可以设置jndiConnectionFactory为“org.jnp.interfaces.NamingContextFactory”。

　　jndiProviderURL

　　字符串类型的属性，设置目标EJB容器的相关属性，包括访问JNDI上下文环境使用的协议、目标服务器IP地址、服务端口等，比如访问JBoss容器中消息队列时，providerURL可以写成”jnp://localhost:1099”。

　　Message注释

　　Message注释是JMS控件中方法级别的注释，它的参数为JMSControl.MessageType类型，用于注释新创建JMS控件的业务方法，声明该业务方法发送消息的类型，可选参数包括MessageType.Text、MessageType. Bytes（字节类型）、MessageType.Object（对象类型）, MessageType.Map （Map类型）、MessageType.JMSMessage（JMS消息类型）、MessageType.Auto（自动适配类型），默认的消息类型是MessageType.Auto。

　　如果使用默认的消息类型或者设置被发送消息的类型为MessageType.Auto，控件将根据被发送消息的类型来决定发送消息时使用的消息类型：

　　如果被发送的消息是字符串内容或者是XML对象，控件将发送TextMessage类型的消息给目标消息队列/主题；

　　如果被发送的消息内容是字节数组，控件将发送StreamMessage类型的消息给目标消息队列/主题；

　　如果被发送的消息内容是字节数组，控件将发送StreamMessage类型的消息给目标消息队列/主题；

　　如果被发送的消息内容是Map对象，控件将发送MapMessage类型的消息给目标消息队列/主题；

　　如果被发送的消息内容是JMSMessage对象，控件将发送JMSMessage类型的消息给目标消息队列/主题；

　　如果被发送的消息内容实现了Serializable接口，控件将发送ObjectMessage类型的消息给目标消息队列/主题；

　　其他的消息内容，控件将不发送消息，而是抛出一个违例。

　　JMS控件内置的方法

　　JMS控件提供了很多可以在运行时对JMS控件进行定制的Java方法，开发者使用这些内置的方法可以在使用JMS控件的过程中根据不同的情况灵活的加以应用，以便能够完成各种复杂的业务逻辑。

　　getSession()

　　获取当前访问消息队列/主题的会话对象。

　　getDestination()

　　获取当前访问消息队列/主题的目标服务的相关信息。

　　getConnection()

　　获取当前访问消息队列/主题和目标服务器之间的连接。

　　setHeaders(Map)

　　setHeader(HeaderType,Object)

　　这两个方法都用于设置被发送消息的头信息，只有调用了这两个方法后接着发送的消息才使用这部分头信息，其他的消息不具备这些头信息。如果发送的消息中也设置了同样的信息，使用setHeaderX方法设置的参数将覆盖消息中设置的参数。

　　被设置的头信息包括JMSCorrelationID、JMSExpriation 、Priority 、JMSType，用于发送消息时标识身份或者提供消息发送所需要的路由。

　　setProperties(Map)

　　setProperty(String,Object)

　　这两个方法用于在发送消息的同时提供更多的属性信息，可以用于在应用中作为扩展头信息而使用，可发送的类型可以是boolean, byte, short, int, long, float, double, or String等基本Java数据类型。

　　结束语

　　JMS是J2EE框架中最重要的部分，也是企业应用中提供异步消息访问的技术实现，然而JMS的客户端编写对于开发者而言不是一件轻松的事情。控件架构中的JMS控件大大的简化了JMS资源的复杂性、难度，开发者只需要通过简单的继承org.apache.beehive.controls.system.jms.JMSControl，然后通过提供相应的注释就可以完成JMS资源的访问。