JMS连接WMQ及收发消息

时间:2021-07-05 11:48:20

因为对JMS的了解也只算入门级,有些概念也很模糊,不过,卤煮会尽可能去介绍的。另外,sample code都调试过可以跑。

1.神马是JMS?

jms即Java消息服务(Java Message Service)应用程序接口是一个Java平台中关于面向消息中间件(MOM)的API,用于在两个应用程序之间,或分布式系统中发送消息,进行异步通信。Java消息服务是一个与具体平台无关的API,绝大多数MOM提供商都对JMS提供支持。——摘自百度百科

2.JMS组成要素

JMS提供者,JMS客户,JMS生产者,JMS消费者,JMS队列和JMS主题。具体啥意思,还是参考百度百科吧,不过,概念讲起来也木有啥意思,还会把人绕晕。多跑几次sample,回来再看概念可能更清楚些哈。另,博文中的JMS提供者以IBM 的WebSphere MQ为例。

3.JMS模型

JMS模型定义一组可供 Java™ 应用程序用于执行消息传递操作的接口。

以下列表概括了主要的JMS接口:

Destination:Destination 对象是应用程序将消息发往的位置和/或应用程序从其接收消息的源。

ConnectionFactory:ConnectionFactory 对象包括连接的一组配置属性。应用程序使用连接工厂来创建连接。

Connection:Connection 对象包括应用程序与消息传递服务器的活动连接。应用程序使用连接来创建会话。

Session:Session 对象是用于发送和接收消息的单个线程上下文。应用程序使用会话来创建消息、消息生产者和消息使用者。会话是事务性或非事务性会话。

Message:Message 对象包括应用程序发送或接收的消息。

MessageProducer:应用程序使用消息生产者将消息发送到目标。

MessageConsumer:应用程序使用消息使用者来接收已发送到目标的消息。

下图是这些对象之间的关系(摘自IBM Info Center)其实,IBM info center中资料多多的呀。

JMS连接WMQ及收发消息

Destination、ConnectionFactory 或 Connection 对象可供多线程应用程序的不同线程并发使用,但是 Session、MessageProducer 或 MessageConsumer 对象不能供不同线程并发使用。确保不并发使用 Session、MessageProducer 或 MessageConsumer 对象的最简单方法是为每个线程创建单独的 Session 对象。

JMS支持两种消息传递样式:

  • 点到点消息传递
  • 发布/预订消息传递

这两类消息传递也被称为消息传递域,且您可以将两类消息传递都组合在一个应用程序中。在点到点域中,目标是队列,而在发布/预订域中,目标是主题。

通过JMS1.1 以前的JMS版本,对点到点域的程序设计使用一组接口和方法,而对发布/预订域的程序设计使用另一组接口和方法。两组接口和方法是相似的,但却各自独立。通过JMS1.1,您可以使用一组公共的支持两类消息传递域的接口和方法。公共接口提供了独立于域的每个消息传递域的视图。下表列出了独立于JMS 域的接口及其相应的特定于域的接口。

JMS连接WMQ及收发消息

特别清楚有木有。

4.开发JMS客户端用于连接WMQ及收发消息

下面的code能跑起来的前提是,本地已安装MQ,且创建好队列管理器和相应的QUEUE,TOPIC。

连接方式一:使用的是IBM对于JMS的实现(要导入包com.ibm.mqjms.jar):

 package com.demo;

 import java.io.UnsupportedEncodingException;

 import javax.jms.BytesMessage;
import javax.jms.Connection;
import javax.jms.DeliveryMode;
import javax.jms.ExceptionListener;
import javax.jms.JMSException;
import javax.jms.Message;
import javax.jms.MessageConsumer;
import javax.jms.MessageListener;
import javax.jms.MessageProducer;
import javax.jms.Queue;
import javax.jms.QueueConnection;
import javax.jms.QueueConnectionFactory;
import javax.jms.Session;
import javax.jms.TextMessage;
import javax.naming.NamingException; import com.ibm.mq.jms.MQQueueConnectionFactory; public class JmsQueueDemo {
private static Connection conn = null;
private static Session session = null;
private static MessageProducer producer = null;
private static MessageConsumer consumer = null;
private static QueueConnection qConn = null; public static void init() {
// 连接工厂,用com.ibm.mq.jms中的类实现javax.jms中的接口
QueueConnectionFactory qcf = new MQQueueConnectionFactory(); // 设置连接工厂属性
try {
//设置WMQ所在机器的IP
((MQQueueConnectionFactory) qcf).setHostName("localhost");
//设置WMQ上队列管理器名
((MQQueueConnectionFactory) qcf).setQueueManager("TestQM");
//设置WMQ上的通道名
((MQQueueConnectionFactory) qcf).setChannel("SYSTEM.DEF.SVRCONN");
//设置WMQ上的监听端口
((MQQueueConnectionFactory) qcf).setPort(1414); //由连接工厂创建连接
qConn = qcf.createQueueConnection(); //建立异常监听器用于监听连接过程中发生的异常
ExceptionListener exceptionListener = new ExceptionListener(){ //此处可放入更多逻辑,由自己定义
public void onException(JMSException e) {
System.out.println("mq exception");
e.printStackTrace();
System.exit(0);
} };
//在连接上面注册监听器
qConn.setExceptionListener(exceptionListener);
} catch (JMSException e) { e.printStackTrace();
return;
}
} public static void main(String[] args) throws NamingException,
JMSException, UnsupportedEncodingException { init();
sendMessage();
// receiveMessage();
receiveWithListener();
destroy(); } public static void sendMessage() throws JMSException {
boolean transacted = false; // 非事务处理(分别接收或发送消息)[事务处理(全部发送或者全部接收作为一个单元的一组消息)]
session = qConn
.createQueueSession(transacted, Session.AUTO_ACKNOWLEDGE);
// 由session创建要发送到的队列
Queue inputQ = session.createQueue("TestQ"); //由session创建消息发送者
MessageProducer sender = session.createProducer(inputQ); //启动连接
qConn.start(); // 消息由会话创建
TextMessage message = session.createTextMessage();
//设置消息内容
message.setText("this is input message from queue sender");
//这句可有可无的哦,主要用于设置消息属性;方便后面取消息时,取特定类型的消息,如"company='systems'"
message.setStringProperty("company", "systems"); // 发送消息,后面的参数依次为消息的持久性设置,消息的优先级,消息在队列的存活时间,设置为0,表示永不失效
//DeliveryMode为PERSISTENT表示,队列管理器或者WMQ重启后,消息仍在queue中;NON_PERSISTENT意思相反
sender.send(message, DeliveryMode.NON_PERSISTENT, 7, 0);
} //使用listener的方式从queue中取消息,可一次取多条消息出来
public static void receiveWithListener() throws JMSException { boolean transacted = false; // 非事务处理(分别接收或发送消息)[事务处理(全部发送或者全部接收作为一个单元的一组消息)]
session = qConn
.createQueueSession(transacted, Session.AUTO_ACKNOWLEDGE);
//从同一个queue中取消息,此处为使用session创建queue
Queue outputQ = session.createQueue("TestQ");
//使用session创建消息消费者,注意了,后面的那个参数就是消息选择器,用于接收特定类型的消息
consumer = session.createConsumer(outputQ, "company='t-systems'");
//创建消息监听器
MessageListener listener = new MessageListener() {
public void onMessage(Message message) {
try {
if (message instanceof TextMessage) {
System.out.println("Listener 接收消息:"
+ ((TextMessage) message).getText());
}
} catch (JMSException e) {
e.printStackTrace();
}
}
};
//注册消息监听器
consumer.setMessageListener(listener);
//启动连接
qConn.start();
try {
Thread.sleep(10 * 1000);
} catch (InterruptedException e) {
e.printStackTrace();
}
}
//取消息的另一种方式,手动从queue中取消息,一次只能接收一条消息
public static void receiveMessage() throws JMSException,
UnsupportedEncodingException { boolean transacted = false; // 非事务处理(分别接收或发送消息)[事务处理(全部发送或者全部接收作为一个单元的一组消息)]
session = qConn
.createQueueSession(transacted, Session.AUTO_ACKNOWLEDGE);
// 对队列管理器上队列的映射
Queue outputQ = session.createQueue("TestQ");
consumer = session.createConsumer(outputQ);
qConn.start();
//此时,若send的message中,设置了message的属性如,"company='systems'",下面的方法是取不到消息的哈
//要取到消息可屏蔽到send中设置message属性的语句,或使用consumer.receive("company='systems'")
Message msg = consumer.receiveNoWait();
//转换消息格式
if (msg instanceof TextMessage) {
TextMessage message = (TextMessage) msg;
System.out.println("received message from queue is:"
+ message.getText());
} else if (msg instanceof BytesMessage) {
BytesMessage message = (BytesMessage) msg;
byte buff[] = null;
long length = message.getBodyLength();
buff = new byte[(int) length];
message.readBytes(buff);
String textmessage = new String(buff, "UTF-8");
System.out.println("received message from queue is:" + textmessage);
}
}
//销毁资源
public static void destroy() throws JMSException {
if (consumer != null) {
consumer.close();
}
if (producer != null) {
producer.close();
}
if (session != null) {
session.close();
}
if (conn != null) {
conn.close();
} } }

上面的代码是点对点消息发送模式的实现,其实,发布/预定模式的实现也差不多了。

 package com.demo;

 import java.io.UnsupportedEncodingException;

 import javax.jms.BytesMessage;
import javax.jms.Connection;
import javax.jms.DeliveryMode;
import javax.jms.ExceptionListener;
import javax.jms.JMSException;
import javax.jms.Message;
import javax.jms.MessageConsumer;
import javax.jms.MessageListener;
import javax.jms.MessageProducer;
import javax.jms.Session;
import javax.jms.TextMessage;
import javax.jms.Topic;
import javax.jms.TopicConnection;
import javax.jms.TopicConnectionFactory;
import javax.naming.NamingException; import com.ibm.mq.jms.MQTopicConnectionFactory; public class JmsTopicDemo {
private static Connection conn;
private static Session session;
private static MessageProducer producer;
private static MessageConsumer consumer;
private static TopicConnection tConn = null; public static void init() {
// 连接工厂,用com.ibm.mq.jms中的类实现javax.jms中的接口
TopicConnectionFactory tcf = new MQTopicConnectionFactory(); // 设置连接工厂属性
try {
((MQTopicConnectionFactory) tcf).setHostName("localhost");
((MQTopicConnectionFactory) tcf).setQueueManager("TestQM");
((MQTopicConnectionFactory) tcf).setCCSID(1381);
((MQTopicConnectionFactory) tcf).setChannel("SYSTEM.DEF.SVRCONN");
((MQTopicConnectionFactory) tcf).setPort(1414);
tConn = tcf.createTopicConnection(); ExceptionListener exceptionListener = new ExceptionListener() { // 此处可放入更多逻辑
public void onException(JMSException e) {
System.out.println("mq exception");
e.printStackTrace();
System.exit(0);
} };
tConn.setExceptionListener(exceptionListener);
} catch (JMSException e) { e.printStackTrace();
return;
}
} public static void main(String[] args) throws NamingException,
JMSException, UnsupportedEncodingException, InterruptedException { init();
sendMessage();
receiveMessage();
receiveWithListener();
destroy(); } public static void sendMessage() throws JMSException {
boolean transacted = false; session = tConn
.createTopicSession(transacted, Session.AUTO_ACKNOWLEDGE); Topic inputTopic = session.createTopic("TestT");
MessageProducer sender = session.createProducer(inputTopic);
tConn.start(); TextMessage message = session.createTextMessage();
message.setText("this is input message from topic sender"); sender.send(message, DeliveryMode.PERSISTENT, 7, 0); } public static void receiveWithListener() throws JMSException {
// receive message from mq boolean transacted = false; session = tConn
.createTopicSession(transacted, Session.AUTO_ACKNOWLEDGE);
Topic outputT = session.createTopic("TestT"); consumer = session.createConsumer(outputT); MessageListener listener = new MessageListener() {
public void onMessage(Message message) {
try {
if (message instanceof TextMessage) {
System.out.println("Listener 接收消息:"
+ ((TextMessage) message).getText());
}
} catch (JMSException e) {
e.printStackTrace();
}
}
};
consumer.setMessageListener(listener);
tConn.start();
try {
Thread.sleep(10 * 1000);
} catch (InterruptedException e) {
e.printStackTrace();
}
} public static void receiveMessage() throws JMSException,
UnsupportedEncodingException { boolean transacted = false; session = tConn
.createTopicSession(transacted, Session.AUTO_ACKNOWLEDGE); Topic outputT = session.createTopic("TestT");
consumer = session.createConsumer(outputT); tConn.start();
Message msg = consumer.receive(5000);
if (msg instanceof TextMessage) {
TextMessage message = (TextMessage) msg;
System.out.println("received message from topic is:"
+ message.getText());
} else if (msg instanceof BytesMessage) {
BytesMessage message = (BytesMessage) msg;
byte buff[] = null;
long length = message.getBodyLength();
buff = new byte[(int) length];
message.readBytes(buff);
String textmessage = new String(buff, "UTF-8");
System.out.println("received message from topic is:" + textmessage);
}
} public static void destroy() throws JMSException {
if (consumer != null) {
consumer.close();
}
if (producer != null) {
producer.close();
}
if (session != null) {
session.close();
}
if (conn != null) {
conn.close();
} } }

不同点的地方,可能就是从topic中取消息的时候,因为消息不能在topic中驻留,所以,一定要是取的动作已经发生了或准备好,再做发送消息的操作,这时候,才能够从topic中收到发送的消息。怎么理解呢?比如说,queue是个篮子,消息发送出去,就会在篮子里。有时,发送的动作也许早就已经完成,但消息会一直在篮子里。取消息的时候,从篮子中取走即可。而topic则是一个篮球框的那种篮网,消息发送到篮网,如果下面没有接收的东西,就会直接从篮网溜走,你这时再去取消息,就只能是竹篮打水一场空啦。所以,从topic中收消息,一定要再发消息之前先把接的动作准备好的哈。

连接方式二:使用javax.jms中的标准JMS接口(要导入包jms.jar)

使用javax.jms中的标准JMS接口,可以隐藏特定厂商的实现,使代码具有更好的可移植性。开发时,只需要关注javax.jms.QueueConnectionFactory 和 javax.jms.Queue这两个对象即可。通常JMS提供厂商会有自己的工具去构建这两个对象,并存储在JNDI命名空间中。可以从命名空间中检索这两个对象,而不用care是哪个厂商实现滴。

对于WMQ,这两个对象是这样构建滴哈。

1)打开WMQ,找到“JMS受管对象”,右击“添加初始上下文”,如下图选择,记得绑定目录是先创建好的哈。

JMS连接WMQ及收发消息

点击“完成”。

2)在刚建好的“初始上下文”下面,找到”连接工厂“,右击新建“连接工厂”,如下图,

JMS连接WMQ及收发消息

点击”下一步“,到最后一页,在连接里面做如下设置,

JMS连接WMQ及收发消息

选择”基本队列管理器“(应先在WMQ上创建好一个队列管理器,此处选上;另还需先创建好;一个queue,下面要用到滴),完成。

此时我们就有javax.jms.QueueConnectionFactory这个对象了。

3)在新建的”初始上下文“下,找到”目标“,新建”目标“,点”下一步“,到最后一页,做下面的设置,

JMS连接WMQ及收发消息

选择”队列管理器“和”队列“,应先在WMQ上创建好。这时,javax.jms.Queue这个对象也构建好了呢。

OK,完事具备了,下面就是配合JNDI方式实现的标准JMS接口了。

 package com.demo;

 import java.util.Hashtable;

 import javax.jms.*;
import javax.naming.*; public class Tester {
public static void main(String[] args) {
send();
} public static void send() {
try { Hashtable<String, String> environment = new Hashtable<String, String>();
//刚才建的初始上下文哈
environment.put(Context.INITIAL_CONTEXT_FACTORY,
"com.sun.jndi.fscontext.RefFSContextFactory");
environment.put(Context.PROVIDER_URL, "file:/D:/JNDI-Directory");
InitialContext initContext = new InitialContext(environment);
//创建的连接工厂哈
ConnectionFactory factory = (ConnectionFactory) initContext
.lookup("TestQM_Q");
//创建的目标哈
Destination destination = (Destination) initContext
.lookup("TestQueue");
initContext.close(); Connection connection = factory.createConnection();
Session session = connection.createSession(false,
Session.AUTO_ACKNOWLEDGE); MessageProducer sender = session.createProducer(destination);
// Send messages
TextMessage message = session .createTextMessage("hello, this is my first jms sample code~~~"); //记住,message并不是send到“TestQueue”里面去了,而是send到WMQ上与“TestQueue”关联的那个queue里面去了
sender.send(message);
session.close();
connection.close();
} catch (Exception e) {
e.printStackTrace();
}
}
}

好了,就介绍到这里了。Happy ending~~~