这份程序的原始文档是来自于互联网,不过不知道作者是谁,在些先谢了,我增加了个人的理解在里面,增加注释,这样便于阅读与理解。
该程序实现了发送消息与读取消息的功能,见其中的send***与get***方法。这只适合于测试,因为环境中的程序还需要对此有稍微的更改,在真实的环境中肯定是在while(true){...}的无限循环中去调用其中的get方法,如果有值,那就执行对消息的处理操作,如果没有值就继续循环,在get方法中有等待的时间。
这个程序就其本身来说还是比较理解的:
1、首先设置一些相关的环境变量
2、再连接队列管理器
3、再次操作队列管理器中的指定队列
4、往指定队列中发消息或者是从指定对列中取消息
5、关闭队列
如果不知道如何在MQ资源管理器中配置远程队列及通过远程队列往远程的MQ发送消息,请参见文章:
http://blog.csdn.net/fenglibing/archive/2009/05/08/4160639.aspx
真实环境中的MQ,个人觉得至少都应该有两个本地队列加一个远程队列,因为消息的交互肯定是相互的,有收消息,肯定也有发消息。一个本地队列用于接收外部发过来的消息,用法为正常;另一个本地队例用于传输,用于做于远程队例的传输队列,将消息发送给远程主机的本地队列。要使消息能够成功的传送到远程队列,还需要配置通道,通常中需要指定远程通道的IP地址及端口、本地传输队例的名称、以及本地的通信地址,这样才能够往远程主机发送消息。
- /**
- * @author Fenglb E-mail:56553655@163.com
- * @version 创建时间:2009-4-30 下午04:13:38
- * 类说明
- */
- import java.io.IOException;
- import com.ibm.mq.MQC;
- import com.ibm.mq.MQEnvironment;
- import com.ibm.mq.MQException;
- import com.ibm.mq.MQGetMessageOptions;
- import com.ibm.mq.MQMessage;
- import com.ibm.mq.MQPutMessageOptions;
- import com.ibm.mq.MQQueue;
- import com.ibm.mq.MQQueueManager;
- public class MessageByMQ{
- //定义队列管理器和队列的名称
- private static String qmName;
- private static String qName;
- private static MQQueueManager qMgr;
- static{
- //设置环境:
- //MQEnvironment中包含控制MQQueueManager对象中的环境的构成的静态变量,MQEnvironment的值的设定会在MQQueueManager的构造函数加载的时候起作用,
- //因此必须在建立MQQueueManager对象之前设定MQEnvironment中的值.
- MQEnvironment.hostname="10.24.1.180"; //MQ服务器的IP地址
- MQEnvironment.channel="S_FENGLB"; //服务器连接的通道
- MQEnvironment.CCSID=1381; //服务器MQ服务使用的编码1381代表GBK、1208代表UTF(Coded Character Set Identifier:CCSID)
- MQEnvironment.port=1414; //MQ端口
- qmName = "QM_FENGLB"; //MQ的队列管理器名称
- qName = "testQ"; //MQ远程队列的名称
- try {
- //定义并初始化队列管理器对象并连接
- //MQQueueManager可以被多线程共享,但是从MQ获取信息的时候是同步的,任何时候只有一个线程可以和MQ通信。
- qMgr = new MQQueueManager(qmName);
- } catch (MQException e) {
- // TODO Auto-generated catch block
- System.out.println("初使化MQ出错");
- e.printStackTrace();
- }
- }
- /**
- * 往MQ发送消息
- * @param message
- * @return
- */
- public static int sendMessage(String message){
- int result=0;
- try{
- //设置将要连接的队列属性
- // Note. The MQC interface defines all the constants used by the WebSphere MQ Java programming interface
- //(except for completion code constants and error code constants).
- //MQOO_INPUT_AS_Q_DEF:Open the queue to get messages using the queue-defined default.
- //MQOO_OUTPUT:Open the queue to put messages.
- /*目标为远程队列,所有这里不可以用MQOO_INPUT_AS_Q_DEF属性*/
- //int openOptions = MQC.MQOO_INPUT_AS_Q_DEF | MQC.MQOO_OUTPUT;
- /*以下选项可适合远程队列与本地队列*/
- int openOptions = MQC.MQOO_OUTPUT | MQC.MQOO_FAIL_IF_QUIESCING;
- //连接队列
- //MQQueue provides inquire, set, put and get operations for WebSphere MQ queues.
- //The inquire and set capabilities are inherited from MQManagedObject.
- /*关闭了就重新打开*/
- if(qMgr==null || !qMgr.isConnected()){
- qMgr = new MQQueueManager(qmName);
- }
- MQQueue queue = qMgr.accessQueue(qName, openOptions);
- //定义一个简单的消息
- MQMessage putMessage = new MQMessage();
- //将数据放入消息缓冲区
- putMessage.writeUTF(message);
- //设置写入消息的属性(默认属性)
- MQPutMessageOptions pmo = new MQPutMessageOptions();
- //将消息写入队列
- queue.put(putMessage,pmo);
- queue.close();
- }catch (MQException ex) {
- System.out.println("A WebSphere MQ error occurred : Completion code "
- + ex.completionCode + " Reason code " + ex.reasonCode);
- ex.printStackTrace();
- }catch (IOException ex) {
- System.out.println("An error occurred whilst writing to the message buffer: " + ex);
- }catch(Exception ex){
- ex.printStackTrace();
- }finally{
- try {
- qMgr.disconnect();
- } catch (MQException e) {
- e.printStackTrace();
- }
- }
- return result;
- }
- /**
- * 从队列中去获取消息,如果队列中没有消息,就会发生异常,不过没有关系,有TRY...CATCH,如果是第三方程序调用方法,如果无返回则说明无消息
- * 第三方可以将该方法放于一个无限循环的while(true){...}之中,不需要设置等待,因为在该方法内部在没有消息的时候会自动等待。
- * @return
- */
- public static String getMessage(){
- String message=null;
- try{
- //设置将要连接的队列属性
- // Note. The MQC interface defines all the constants used by the WebSphere MQ Java programming interface
- //(except for completion code constants and error code constants).
- //MQOO_INPUT_AS_Q_DEF:Open the queue to get messages using the queue-defined default.
- //MQOO_OUTPUT:Open the queue to put messages.
- int openOptions = MQC.MQOO_INPUT_AS_Q_DEF | MQC.MQOO_OUTPUT;
- MQMessage retrieve = new MQMessage();
- //设置取出消息的属性(默认属性)
- //Set the put message options.(设置放置消息选项)
- MQGetMessageOptions gmo = new MQGetMessageOptions();
- gmo.options = gmo.options + MQC.MQGMO_SYNCPOINT;//Get messages under sync point control(在同步点控制下获取消息)
- gmo.options = gmo.options + MQC.MQGMO_WAIT; // Wait if no messages on the Queue(如果在队列上没有消息则等待)
- gmo.options = gmo.options + MQC.MQGMO_FAIL_IF_QUIESCING;// Fail if Qeue Manager Quiescing(如果队列管理器停顿则失败)
- gmo.waitInterval = 1000 ; // Sets the time limit for the wait.(设置等待的毫秒时间限制)
- /*关闭了就重新打开*/
- if(qMgr==null || !qMgr.isConnected()){
- qMgr = new MQQueueManager(qmName);
- }
- MQQueue queue = qMgr.accessQueue(qName, openOptions);
- // 从队列中取出消息
- queue.get(retrieve, gmo);
- message = retrieve.readUTF();
- System.out.println("The message is: " + message);
- queue.close();
- }catch (MQException ex) {
- System.out.println("A WebSphere MQ error occurred : Completion code "
- + ex.completionCode + " Reason code " + ex.reasonCode);
- }catch (IOException ex) {
- System.out.println("An error occurred whilst writing to the message buffer: " + ex);
- }catch(Exception ex){
- ex.printStackTrace();
- }finally{
- try {
- qMgr.disconnect();
- } catch (MQException e) {
- e.printStackTrace();
- }
- }
- return message;
- }
- public static void main(String args[]) {
- /*下面两个方法可同时使用,也可以单独使用*/
- sendMessage("this is a test");
- //getMessage();
- }
- }
本文出自:冯立彬的博客