使用JMS接口接入WebSphere MQ消息

在你的应用程序中利用IBM WebSphere MQ消息中间件提供Java消息服务开放接口。

  IBM WebSphere MQ(WMQ)是一套面向消息的中间件(message-oriented middleware,MOM),通过使用消息和队列简化应用程序之间的通信,WMQ支持点到点的和发布/订阅消息,支持多种平台,包括Windows、AIX、HP-UX和Sun Solaris,它特别适合目前的异构计算环境。

  对于Java开发者而言,WMQ为Java应用程序提供了两种接口:

  1.为Java提供MQ基础类 - 一个基于WMQ本地接口的Java接口。

  2.MQ JMS - Java消息服务(Java Messaging Service ,JMS)1.1接口的实现。

  JMS通过开启Java应用程序发送和接收消息扩展了Java的互操作性,JMS应用程序可以使用点到点或发布/订阅模式进行消息交换。

  本文描述的是使用WMQ和JMS进行开发的过程,重心集中在点到点消息,通过下面几步教你如何使用Java类编写JMS接口:

  1.创建WMQ对象

  2.创建JMS管理对象

  3.解释JMS代码

  4.运行一个实例类发送消息和从WMQ接收消息

  WMQ安装

  本文使用的是winxp上的MQ 版本 7(可以从http://www.ibm.com/developerworks/downloads/ws/wmq/learn.html下载试用版),在windows上的安装是非常简单的,一路默认就可以完成安装。

  如果你还没有使用过WMQ也不要担心,你可以使用基于Eclipse的WebSphere MQ管理器,它是一个简单的用于管理WMQ的图形工具。

  创建MQ对象:队列管理器和队列

  队列是用来存储消息的,直到应用程序处理完毕才释放,队列管理器拥有并管理队列,要创建一个队列管理器和队列,按以下步骤启动WebSphere MQ管理器:开始?所有程序? IBM WebSphere MQ ? WebSphere MQ Explorer。图1显示了启动WebSphere MQ管理器时的样子。

  图1 WebSphere MQ 管理器

  在MQ管理器中执行下列操作创建一个队列管理器:

  1.在导航视图下,右击“队列管理器”,选择“新建--队列管理器”,启动创建队列管理器向导。

  2.在第一步中输入队列管理器的名字“TestMQ”,点击“下一步”。如图2所示。

  图2 创建队列管理器,第一步:输入队列管理器名称

  3.在第二步和第三步都点击“下一步”,进入第四步,确定选中了“创建一个TCP/IP监听器”,然后输入一个未使用的端口号,点击“完成”。如图3所示。

  图3 创建队列管理器,第四步:检查队列管理器的监听器端口号。

  接下来创建两个队列:IN.QUEUE 和 OUT.QUEUE。你就可以将消息写入IN.QUEUE,从OUT.QUEUE读取消息。

  1.在TestMQ下,右击“队列”?“新建”?“本地队列”启动“新建本地队列”向导。

  2.在名称区域,输入IN.QUEUE,点击“完成”。如图4所示。

  图4 创建队列向导:输入队列名称,其它属性值保留默认值

  3.重复上面的步骤创建好队列OUT.QUEUE。

创建JMS管理对象

  JMS定义了一个通用的接口来发送和接收消息,只要与之通信的程序兼容JMS即可,点到点的JMS接口是:

  1. javax.jms.QueueConnection - 这个接口提供一个到JMS提供程序的连接,用于创建会话对象。

  2.javax.jms.QueueSession - 这个接口为产生和消耗消息提供上下文呢,包括创建QueueSender和QueueReceiver的方法。

  3. javax.jms.QueueSender - 这个接口用于向队列发送消息,javax.jms.QueueReceiver用于从队列接收消息。

  为了让你的代码可以在不同的消息提供程序间有良好的移植性,你必须在你的应用程序中使用javax.jms中的标准JMS接口,所有特定厂家的信息都封装在javax.jms.QueueConnectionFactory 和 javax.jms.Queue中,这些管理对象可以使用厂家提供管理工具进行构建,存储在JNDI命名空间中,JMS应用程序可以从命名空间中检索这些对象,这时就不需要知道是哪个厂家提供的了。

  按照下面的步骤使用Websphere MQ管理器创建管理对象,存储在基于文件的目录下:

  1.在JMS-管理对象上点击右键?添加初始上下文。

  2.在屏幕1上:

   为“JNDI存储在哪里”选择“文件系统”

   在关联目录处,输入C:JNDI-Directory(前提是这个目录已经存在)

   注意工厂类和提供程序URL,因为你将会在Java代码中使用到(如图5所示)

  图5 添加初始上下文向导:你将在样例类中使用工厂类和提供程序URL

  3.你的管理器现在应该如图6所示

  图6 添加初始上下文后的MQ管理器:你可以在MQ管理器中轻易地创建JMS管理对象

  在新的初始上下文中,创建一个连接工厂。

  1.在连接工厂上点击右键?新建?连接工厂,在第一个屏幕上,在名称区域输入“TestQM_QCF”,点击“下一步”,在JNDI查找中你就使用TestQM_QCF了。

  2.将类型设置为“队列连接工厂”,点击“下一步”。如图7所示。

  图7 新建连接工厂向导:用于点对点消息的队列连接工厂

  3.保持传送类型为汇集,点击下一步,当WMQ和应用程序在同一机器上时使用汇集传输。

  4.在下一页面点击下一步(无需修改设置)。

  5.在最后一页,选择连接标签,点击“选择”按钮选择TestQM作为“基础队列管理器”。如图8所示。

  图8 新建连接工厂向导:连接工厂被包装为TestMQ

  6.点击“完成”。

  接下来创建目的地,对应WMQ消息的JMS管理对象。

  1.在目的地上点击右键?选择“新建”?“目的地”。

  2.在第一页上,在名字区域输入INInputTestQueue作为名字,确保类型设置为队列了,点击“下一步”。如图9所示。

  图9 新建目的地向导:使用InputTestQueue查找IN.QUEUE

  3.第二页保持默认设置不变,点击“下一步”。

  4.在最后一页:

   在队列管理器区域,点击“选择”按钮选择TestQM。

   在队列区域,点击“选择”按钮选择IN.QUEUE。

  5.点击“完成”。

  重复上述步骤创建另一个目的地:OutputTestQueue,它对应OUT.QUEUE

理解示例类

  如果你编写过JMS应用程序,就很容易理解JNDIUtil 和 Tester示例类(从http://assets.devx.com/sourcecode/WebSphereMQ_JMSSource&Classes.zip下载Java源文件和编译好的类),你创建的JMS管理对象隐藏了所有厂家专利实现。

  JNDIUtil类

  JNDIUtil包括使用名字通过JNDI查找检索对象的方法,参考清单1,你可以使用这个类中的方法检索你在MQ管理器中定义的JMS对象的引用情况。

  清单1 JNDIUtil.java

package devx.articles.mqjms;
  
// JMS 类   import javax.jms.JMSException;
  
import javax.jms.Queue;
  
import javax.jms.QueueConnectionFactory;
  
// JNDI 类   import javax.naming.InitialContext;
  
import javax.naming.Context;
  
import javax.naming.NamingException;
  
// 标准 Java类   import java.util.Hashtable;
  
/**
  *
  * A wrapper class for JNDI calls
  *
  
*/
  
publicclass JNDIUtil
  {
  
private Context context;
  
public JNDIUtil(String icf, String url) throws JMSException, NamingException
  {
  Hashtable environment
=new Hashtable();
  environment.put(Context.INITIAL_CONTEXT_FACTORY, icf );
  environment.put(Context.PROVIDER_URL, url);
  context
=new InitialContext( environment );
  }
  
/**
  *
  *
@param ObjName Object Name to be retrieved
  *
@return Retrieved Object
  *
@throws NamingException
  
*/
  
private Object getObjectByName(String ObjName) throws NamingException
  {
  
return context.lookup( ObjName );
  }
  
/**
  * A convenience method that returns QueueConnectionFactory objects (no casting required)
  *
@param factoryName QueueConnectionFactory JNDI name
  *
@return QueueConnectionFactory object
  *
@throws NamingException
  
*/
  
public QueueConnectionFactory getQueueConnectionFactory(String factoryName) throws NamingException
  {
  
return (QueueConnectionFactory) getObjectByName(factoryName);
  }
  
/**
  * A convenience method that returns Queue objects (no casting required)
  *
@param queueName
  *
@return
  *
@throws NamingException
  
*/
  
public Queue getQueue(String queueName) throws NamingException
  {
  
return (Queue) getObjectByName(queueName);
  }
  }

    Tester类

  Tester类向OUT.QUEUE中写入消息,从IN.QUEUE中读取消息。参考清单2.

  清单2 Tester.java

 package devx.articles.mqjms;
  
//JMS 类   import javax.jms.Queue;
  
import javax.jms.QueueSession;
  
import javax.jms.QueueConnection;
  
import javax.jms.QueueConnectionFactory;
  
import javax.jms.JMSException;
  
import javax.jms.Session;
  
import javax.jms.QueueSender;
  
import javax.jms.QueueReceiver;
  
import javax.jms.TextMessage;
  
import javax.jms.Message;
  
//JNDI 类   import javax.naming.NamingException;
  
//标准 Java 类   /**
  *
  * A class to test JMS with IBM MQ
  *
  
*/
  
publicclass Tester
  {
  
publicstatic String icf ="com.sun.jndi.fscontext.RefFSContextFactory";
  
publicstatic String url ="file:/C:/JNDI-Directory";
  
publicstaticvoid main(String[] vars) throws JMSException, NamingException
  {
  QueueSession session
=null;
  QueueConnection connection
=null;
  QueueConnectionFactory factory
=null;
  QueueSender queueSender
=null;
  QueueReceiver queueReceiver
=null;
  Queue oQueue
=null; // 消息发送到的队列   Queue iQueue =null; // 接收消息的队列   try
  {
  JNDIUtil jndiUtil
=new JNDIUtil(icf,url);
  factory
= jndiUtil.getQueueConnectionFactory("TestQM_QCF");
  connection
= factory.createQueueConnection();
  
// 启动(或重新启动)入站消息的连接地址,如果没有这个调用消息不会被接收   connection.start();
  
//表示一个非相互操作会话   boolean transacted =false;
  session
= connection.createQueueSession( transacted, Session.AUTO_ACKNOWLEDGE);
  oQueue
= jndiUtil.getQueue("OutputTestQueue");
  queueSender
= session.createSender(oQueue);
  TextMessage oMsg
= session.createTextMessage();
  oMsg.setText(
"www.devx.com");
  
// 你还可以设置其他消息属性   queueSender.send(oMsg);
  iQueue
= jndiUtil.getQueue("InputTestQueue");
  queueReceiver
= session.createReceiver(iQueue);
  Message iMsg
= queueReceiver.receive(1000);
  
if ( iMsg !=null )
  System.out.println( ((TextMessage)iMsg).getText() );
  
else
  System.out.println(
"No messages in queue " );
  }
  
finally
  {
  
//总是释放资源   if ( queueReceiver!=null )
  queueReceiver.close();
  
if ( queueSender!=null )
  queueSender.close();
  
if ( session!=null )
  session.close();
  
if ( connection!=null )
  {
  connection.close();
  }
  }
  }
  }

   开始点是连接工厂查找,这个工厂用于创建一个连接:

factory= jndiUtil.getQueueConnectionFactory("TestQM_QCF");
  connection
= factory.createQueueConnection();

   连接对象用于创建一个会话:

 session = connection.createQueueSession( transacted, Session.AUTO_ACKNOWLEDGE);

  要将消息写入IN.QUEUE queue,查找前面创建的目的地对象OutputTestQueue:

oQueue= jndiUtil.getQueue("OutputTestQueue");

  最后创建一个QueueSender对象将消息写入队列:

queueSender = session.createSender(oQueue); TextMessage oMsg = session.createTextMessage(); oMsg.setText("www.devx.com"); queueSender.send(oMsg);

  从OUT.QUEUE读取消息的过程相同,但使用的是QueueReceiver。

编译运行示例类

  当你安装WMQ时会自动将编译和运行示例类需要的jar文件添加到CLASSPATH环境变量中,需要的jar文件位于C:Program FilesIBMWebSphere MQJavalib,包括JMS和JNDI需要的jar。

  在运行Tester类之前,使用MQ管理器向IN.QUEUE增加一条测试消息:

  1.在 IN.QUEUE上点击右键,选择放入测试消息。

  2.输入任意文本,点击放入消息。

  如果你还没有在IN.QUEUE队列中放入过消息,Tester类会显示“队列中无消息”。

  要运行Tester类,将Tester.class 和 JNDIUtil.class添加到CLASSPATH,然后在命令提示符输入:

 java devx.articles.mqjms.Tester

   应用程序向OUT.QUEUE写入一条消息,并显示从IN.QUEUE检索到的消息,要检查发送到OUT.QUEUE中的消息,进入MQ管理器,在OUT.QUEUE上点击右键?选择“浏览消息”即可。

  企业中的Java和WMQ MOM

  在大型企业环境下,可以充分利用WMQ的性能和稳定性优势,只要你的代码遵循Java标准接口,你就可以受益。

原文地址:https://www.cnblogs.com/tbyang/p/3489347.html