MQ java基础编程介绍
MQ java基础编程介绍
MQ java 基础编程（一）
编写人：邬文俊
编写时间：2006-2-16
联系邮件:wenjunwu430@gmail.com
前言
通过2个多星期对MQ学习，在partner 丁 & partner 武 的帮助下完成了该文档。该文档提供一个简单的例子，通过对该例子的讲解，你将知道：
1. 用java写客户端从MQ Server收发消息。
2. MQ 作为Websphere Application Server 的JMS资源提供者。
3. JMS message 映射转化为MQ message
文档中的知识全部从参考资料和IBM提供的文档中获得。I recommend u to read the documents if u want to know more about the MQ.
参考资料
1. 《Using java》（some place name it 《base java》）-----the very important document offered by IBM, every java programmer should read it!
2. 《让 WebSphere MQ 成为部署在 WebSphere Application Server 中的应用程序的 JMS 提供程序》
3. Websphere MQ入门教程(a document written by IBM engineer)
4. mqseries_class_for_java
5. 《IBM - JMS 应用和使用 WebSphere MQ MQI 接口的应用如何进行信息头的交换（二）数据映射》-------《using java》mapping message部分的翻译。
6. MQ--IBM MQSeries使用指南
7. WebSphere Application Server V5 and WebSphere MQ Family Integration. PDF
8. WebSphere MQ Application Programming Guide. PDF
9. IBM MQSeries的触发机制
10. 让 WebSphere MQ 成为部署在 WebSphere Application Server 中的应用程序的 JMS 提供程序
例子说明
例子包括3个部分：发送客户端、MDB、接收客户端。
客户端A把文件发送到服务器，服务器将该文件转发给客户端B。客户端Ａ通过向MQ 客户机直接发送消息。MQ队列会把客户端Ａ发送的MQ Message 转换为JMS Message。MDB接收到转换后的JMS消息后，保存文件在服务器，然后把文件转发到发送队列（JMS队列）。发送队列由MQ Server提供，所以即为发送到了MQ队列。MQ队列把JMS Message 转换为 MQ Message。客户端 B 从MQ 队列中接收转换后的消息，从消息中读取文件，保存在硬盘。
MQMESSAGE JMS MESSAGE
Client A------------------------->mq queue------------------->MDB
Client B<------------------------ mq queue<-------------------MDB
1. 配置MQ Server
这里使用的是MQ Server 5.2。MQ Server 和 WebSphere Application Server 安装在同一台机器上（2 者可以使用绑定方式通信）。
要配置的项目：
1. 队列管理器 QMGR
2. 侦听端口 4001
3. 本地队列 EXAMPLE.QUEUE
4. 本地队列 EXAMPLE.SENDQUEUE
5. 通道 EXAMPLE.CHANNEL
打开WebSphere MQ 资源管理器。展开队列管理器节点，右键，新建队列管理器。取名字为 QMGR，设置侦听端口 4001。
在建好的队列管理器QMGR下面新建2个本地队列：EXAMPLE.QUEUE，EXAMPLE.SENDQUEUE。
展开高级节点，新建服务器连接通道 EXAMPLE.CHANNEL。
Note：不要搞错队列和通道的类型。
2. 验证MQ配置
打开WebSphere MQ服务。可以查看服务是否启动、服务监听端口。
3. 配置WAS JMS
具体操作参考《让 WebSphere MQ 成为部署在 WebSphere Application Server 中的应用程序的 JMS 提供程序》该文章可以在IBM WebSphere 开发者技术期刊中找到。
要配置的项目：
1. WebSphere MQ 连接工厂
JNDI name：jms/JMSExampleConnectionFactory
2. WebSphere MQ 队列目标
JNDI name：jms/JMSExampleQueue ；基本队列名：EXAMPLE.QUEUE；目标客户机：JMS。目标客户机决定了MQ队列接收方的消息格式。因为是用MDB接收消息，所以设置为JMS。另一个队列是由MQ 客户端接收消息，所以另一个队列的目标客户机是MQ。如果配置错误，MQ队列转换消息的格式将不是你所想要的。具体参考《IBM - JMS 应用和使用 WebSphere MQ MQI 接口的应用如何进行信息头的交换（二）数据映射》
3. WebSphere MQ 队列目标
JNDI name：jms/JMSExampleSendQueue ；
基本队列名：EXAMPLE.SENDQUEUE；目标客户机：MQ。
4. 配置MDB
在WAS上配置侦听器端口
名称：JMSExampleQueuePort；
连接工厂 JNDI 名 jms/JMSExampleConnectionFactory ；
目标 JNDI 名： jms/JMSExampleQueue。
Message Driven Beans 用于侦听消息的侦听器端口。每个端口指定 MDB 将侦听的（依据该端口部署的）JMS 连接工厂和 JMS 目标。
MDB部署描述符中配置
连接工厂 JNDI 名 jms/JMSExampleConnectionFactory ；
目标 JNDI 名： jms/JMSExampleQueue；
监听端口名称：JMSExampleQueuePort（监听端口名称也可以在管理控制台中修改）
5. 代码
客户端A（发送方）
MqPut.java
|
package cn.edu.itec.mqclient;
import java.io.File;
import com.ibm.mq.MQC;
import com.ibm.mq.MQEnvironment;
import com.ibm.mq.MQException;
import com.ibm.mq.MQMessage;
import com.ibm.mq.MQPutMessageOptions;
import com.ibm.mq.MQQueueManager;
public class MQPut {
private String HOST_URL = "192.168.1.116";
private String MQ_CHANNEL = "EXAMPLE.CHANNEL";
private String MQ_MANAGER = "QMGR";
private String MQ_QUEUE = "EXAMPLE.QUEUE";
private int MQ_PORT = 4001;
public static void main(String args[]) {
new MQPut().SendFile("f:/JMSExampleEJB.jar");
}
public void SendFile(String sFilePath) {
try {
/* 设置MQEnvironment 属性以便客户机连接 */
MQEnvironment.hostname = HOST_URL;
MQEnvironment.channel = MQ_CHANNEL;
MQEnvironment.properties.put(MQC.TRANSPORT_PROPERTY,
MQC.TRANSPORT_MQSERIES);
MQEnvironment.CCSID = 1381;
MQEnvironment.port = MQ_PORT;
/* 连接到队列管理器 */
MQQueueManager qMgr = new MQQueueManager(MQ_MANAGER);
System.out.println("queue manager is connected!");
/* 设置打开选项以便打开用于输出的队列，如果队列管理器正在停止，我们也已设置了选项去应对不成功情况。 */
int openOptions = MQC.MQOO_OUTPUT | MQC.MQOO_FAIL_IF_QUIESCING;
/* 打开队列 */
com.ibm.mq.MQQueue queue = qMgr.accessQueue(MQ_QUEUE, openOptions);
/* 设置放置消息选项我们将使用默认设置 */
MQPutMessageOptions pmo = new MQPutMessageOptions();
/* 创建消息，MQMessage 类包含实际消息数据的数据缓冲区，和描述消息的所有MQMD 参数 */
/* 创建消息缓冲区 */
MQMessage outMsg = new MQMessage();
/* set the properties of the message fot the selector */
outMsg.correlationId = "clinet_B_receive".getBytes();
outMsg.messageId = "1Aa".getBytes();
/* write msg */
MsgWriter.readFile(outMsg, new File(sFilePath));
/* put message with default options */
queue.put(outMsg, new MQPutMessageOptions());
System.out.println("send file is success!");
/* release resource */
queue.close();
qMgr.disconnect();
} catch (MQException ex) {
//System.out.println("fft!");
System.out.println("An MQ Error Occurred: Completion Code is :/t"
+ ex.completionCode + "/n/n The Reason Code is :/t"
+ ex.reasonCode);
ex.printStackTrace();
} catch (Exception e) {
e.printStackTrace();
}
}
private void readFileToMessage(String FilePath) {
}
}
|
JMS message 和 MQ message有几个字段是相同的，这些字段的值将会在转换中保留。比较方便的是使用CorrelationID这个字段。通过设置这个字段，达到选择性的接收特定消息的功能。其它字段没有完全搞清楚，有的数据类型需要转换，例如MessageID（对应于JMSMessageID）。MQ 消息选择和JMS不同，后者采用selector，前者通过设置接收消息的属性完成。例如设置CorrelationID为特定值。
客户端B
MQGet.java
|
package cn.edu.itec.mqclient;
import java.io.FileOutputStream;
import java.io.IOException;
import java.util.Hashtable;
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.MQQueueManager;
/**
* @author Administrator
*
* TODO To change the template for this generated type comment go to Window -
* Preferences - Java - Code Style - Code Templates
*/
public class MQGet {
private static String HOST_URL = "192.168.1.116";
private static String MQ_CHANNEL = "EXAMPLE.CHANNEL";
private static String MQ_MANAGER = "QMGR";
private static String MQ_QUEUE = "EXAMPLE.SENDQUEUE";
private static int MQ_PORT = 4001;
public static void main(String[] args) {
MQGet.getMessage();
}
public static void getMessage() {
try {
/* 设置MQEnvironment 属性以便客户机连接 */
MQEnvironment.hostname = HOST_URL;
MQEnvironment.channel = MQ_CHANNEL;
MQEnvironment.properties.put(MQC.TRANSPORT_PROPERTY,
MQC.TRANSPORT_MQSERIES);
MQEnvironment.CCSID = 1381;
MQEnvironment.port = MQ_PORT;
/* 连接到队列管理器 */
MQQueueManager qMgr = new MQQueueManager(MQ_MANAGER);
System.out.println("queue manager is connected!");
/*
* 设置打开选项以便打开用于输出的队列，如果队列管理器停止，我们也 已设置了选项去应对不成功情况
*/
int openOptions = MQC.MQOO_INPUT_SHARED
| MQC.MQOO_FAIL_IF_QUIESCING;
/* 打开队列 */
com.ibm.mq.MQQueue queue = qMgr.accessQueue(MQ_QUEUE, openOptions);
System.out.println("队列连接成功");
/* 设置放置消息选项 */
MQGetMessageOptions gmo = new MQGetMessageOptions();
/* 在同步点控制下获取消息 */
gmo.options = gmo.options + MQC.MQGMO_SYNCPOINT;
/* 如果在队列上没有消息则等待 */
gmo.options = gmo.options + MQC.MQGMO_WAIT;
/* 如果队列管理器停顿则失败 */
gmo.options = gmo.options + MQC.MQGMO_FAIL_IF_QUIESCING;
/* 设置等待的时间限制 */
gmo.waitInterval = MQC.MQWI_UNLIMITED;
/* create the message buffer store */
MQMessage inMessage = new MQMessage();
/* set the selector */
inMessage.correlationId = "clinet_B_receive".getBytes();
/* get the message */
queue.get(inMessage, gmo);
System.out.println("get message success");
/* 读出消息对象 */
Hashtable messageObject = (Hashtable) inMessage.readObject();
System.out.println(messageObject);
/* 读出消息内容 */
byte[] content = (byte[]) messageObject.get("content");
/* save file */
FileOutputStream output = new FileOutputStream(
"f:/exampleReceive.jar");
output.write(content);
output.close();
System.out.println(messageObject.get("FileName"));
/* 提交事务,相当于确认消息已经接收，服务器会删除该消息 */
qMgr.commit();
} catch (MQException e) {
e.printStackTrace();
} catch (IOException e) {
// TODO Auto-generated catch block
e.printStackTrace();
} catch (ClassNotFoundException e) {
// TODO Auto-generated catch block
e.printStackTrace();
}
}
}
|
MDB
MQMDBBeanBean.java MDB文件
|
package ejbs;
import javax.jms.ObjectMessage;
import javax.jms.BytesMessage;
import javax.jms.StreamMessage;
import javax.jms.TextMessage;
import javax.jms.JMSException;
import ehub.ihub.exchangeManager.*;
import java.util.Hashtable;
import java.io.ByteArrayInputStream;
import java.io.FileOutputStream;
import java.io.File;
import java.io.ObjectInputStream;
/**
* Bean implementation class for Enterprise Bean: MQMDBBean
*/
public class MQMDBBeanBean implements javax.ejb.MessageDrivenBean,
javax.jms.MessageListener {
private javax.ejb.MessageDrivenContext fMessageDrivenCtx;
/**
* getMessageDrivenContext
*/
public javax.ejb.MessageDrivenContext getMessageDrivenContext() {
return fMessageDrivenCtx;
}
/**
* setMessageDrivenContext
*/
public void setMessageDrivenContext(javax.ejb.MessageDrivenContext ctx) {
fMessageDrivenCtx = ctx;
}
/**
* ejbCreate
*/
public void ejbCreate() {
}
/**
* onMessage
*/
public void onMessage(javax.jms.Message msg) {
try {
System.out.println(msg.toString());
if (msg instanceof TextMessage) {
System.out.println("TextMessage");
} else if (msg instanceof ObjectMessage) {
System.out.println("ObjectMessage");
} else if (msg instanceof StreamMessage) {
System.out.println("StreamMessage");
} else if (msg instanceof BytesMessage) {
System.out.println("BytesMessage");
BytesMessage bytesMessage = (BytesMessage) msg;
String sCorrelationID = new String(bytesMessage
.getJMSCorrelationIDAsBytes());
String sMessageID = bytesMessage.getJMSMessageID();
long size = bytesMessage.getBodyLength();
System.out.println("size=" + size + "/n CorrelationID="
+ sCorrelationID + "/n MessageID=" + sMessageID);
/*read the message and save the file*/
ReadMessage.readMessage(bytesMessage);
System.out.println("read message success");
/*send the message to the client */
SendMessage.sendFileToReceiveQueue(new File("c:/receivedExample.jar"));
System.out.println("send file success");
} else {
System.out.println("no message");
}
} catch (Exception e) {
System.out.println("onmessage 执行错误，回滚！");
e.printStackTrace(System.err);
fMessageDrivenCtx.setRollbackOnly();
}
}
private void getProperties(byte[] p) {
}
/**
* ejbRemove
*/
public void ejbRemove() {
}
}
|
ReadMessage.java
|
/*
* Created on 2006-2-15
*
* TODO To change the template for this generated file go to
* Window - Preferences - Java - Code Style - Code Templates
*/
package ehub.ihub.exchangeManager;
import java.io.ByteArrayInputStream;
import java.io.FileOutputStream;
import java.io.IOException;
import java.io.ObjectInputStream;
import java.util.Hashtable;
import javax.jms.BytesMessage;
import javax.jms.JMSException;
/**
* @author Administrator
*
*
*/
public class ReadMessage {
/**
* read message including property and body
*
* @param Message
* @throws JMSException
* @throws IOException
* @throws ClassNotFoundException
*/
public static void readMessage(BytesMessage Message) {
try {
long bodySize = Message.getBodyLength();
byte[] buf = new byte[Integer.parseInt(String.valueOf(bodySize))];
/* 消息内容读到字节数组中 */
Message.readBytes(buf);
ByteArrayInputStream byteArrayInputStream = new ByteArrayInputStream(
buf);
/* 从字节流读出消息对象 */
ObjectInputStream objectInputStream = new ObjectInputStream(
|