与MQ通讯的完整JAVA程序

这份程序的原始文档是来自于互联网，不过不知道作者是谁，在些先谢了，我增加了个人的理解在里面，增加注释，这样便于阅读与理解。

该程序实现了发送消息与读取消息的功能，见其中的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:[e-mail]
 * @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();
     }
}