JMS规范
1 JMS介绍:
JMS即Java消息服务(Java Message Service)应用程序接口,是一个Java平台中关于面向消息中间件(MOM)的API,用于在两个应用程序之间,或分布式系统中发送消息,进行异步通信。在JavaEE中,当两个应用程序使用JMS进行通信时,它们之间不是直接相连的,而是通过一个共同的消息收发服务组件关联起来以达到解耦/异步削峰的效果。
2 JMS组成结构与特点:
JMS组成结构与特点(四大元素)
JMS provider 实现JMS接口和规范的消息中间件,也就是MQ服务器(安装的MQ软件)
JMS producer 消息生产者,创建以及发送消息的客户端应用
JMS consumer 消息消费者,接收与处理消息的客户端
JMS message
消息头
JMSDestination //目的地
JMSDeliveryMode //持久化:持久化的模式保证了消息可靠性 persistent 持久 non_persistent 非持久
JMSExpiration //过期时间:默认永不过期
JMSPririty //优先级(0-9 越大越优先,非绝对)
JMSMessageID //消息生成的唯一标识,也可以自己定义(分布式项目可以使用分布式id生成器)
消息体
TextMessage 常用
MapMessage 常用
BytesMessage
StreamMesage
ObjectMessage
消息属性(对消息体的进一步区分)
如果需要除消息头字段以外的值,那么可以使用消息属性
识别/去重/重点标注等操作非常有用的方法(找属性值为vip的) message.send()之前,对消息设置属性
2.1消息头
@Test
public void queueProduce() throws JMSException {
ActiveMQConnectionFactory factory = new ActiveMQConnectionFactory(userName, password, url);
Connection connection = factory.createConnection();
connection.start();
//1.创建会话session,两个参数transacted=事务,acknowledgeMode=确认模式(签收)
//设置为不开启事务
Session session = connection.createSession(false, Session.AUTO_ACKNOWLEDGE);
Destination queue = session.createQueue(queueName); //消息头 目的地
MessageProducer producer = session.createProducer(queue);
//消息头 持久化 PERSISTENT持久化 NON_PERSISTENT非持久化(mq挂了后消息会丢失)
producer.setDeliveryMode(DeliveryMode.PERSISTENT);
//消息头 权重 越大越先执行 5-9加急 0-4普通;JMS不要求MQ严格按照这十个优先级发送消息但必须保证加急消息要先于普通消息到达。默认是4级。
producer.setPriority(9);
for (int i = 1; i <= 10; i++) {
String msg = "第" + i + "个msg";
TextMessage message = session.createTextMessage(msg);
message.setStringProperty("source", "dingding");
/*
可以设置消息在一定时间后过期,默认是永不过期。
消息过期时间,等于Destination的send方法中的timeToLive值加上发送时刻的GMT时间值。
如果timeToLive值等于0,则JMSExpiration被设为0,表示该消息永不过期。
如果发送后,在消息过期时间之后还没有被发送到目的地,则该消息被清除。
*/
message.setJMSExpiration(1000 * 60 * 60 * 24L);
// 唯一标识每个消息的标识。MQ会给我们默认生成一个,我们也可以自己指定。可以解决消息消费的幂等性
message.setJMSMessageID("111111");
producer.send(message);
}
}
2.2 消息体
封装了具体的消息数据。有5种消息体格式。要求发送和接收的消息体类型必须一致对应。
TextMessage 常用 普通字符串消息,包含一个String
MapMessage 常用 一个Map类型的消息,key为String 类型,而值为java的基本类型
BytesMessage 二进制数组消息,包含一个byte[]
StreamMesage java数据流消息,用标准流操作来顺序的填充和读取
ObjectMessage 对象消息,包含一个可序列化的java对象
TextMessage 和MapMessage 的发送
// 发送TextMessage消息体
TextMessage textMessage = session.createTextMessage("name--" );
messageProducer.send(textMessage);
// 发送MapMessage 消息体。set方法: 添加,get方式:获取
MapMessage mapMessage = session.createMapMessage();
mapMessage.setString("name", "张三");
mapMessage.setInt("age", 18);
messageProducer.send(mapMessage);
TextMessage 和MapMessage 的接收
messageConsumer.setMessageListener( (message) -> {
// 判断消息是哪种类型之后,再强转。
if (null != message && message instanceof TextMessage){
TextMessage textMessage = (TextMessage)message;
try {
System.out.println("****消费者text的消息:"+textMessage.getText());
}catch (JMSException e) {
}
}
if (null != message && message instanceof MapMessage){
MapMessage mapMessage = (MapMessage)message;
try {
System.out.println("****消费者的map消息:"+mapMessage.getString("name"));
System.out.println("****消费者的map消息:"+mapMessage.getInt("age"));
}catch (JMSException e) {
}
}
});
2.3 消息属性
生产者业务判断,进一步标记消息;。他是识别/去重/重点标注等操作,非常有用的方法。比如:用户为vip,需要特殊处理,可以使用 setStringProperty("idVip","y"); 在消费端,判断此属性为y时特殊处理。
消息端获取
textMessage.getStringProperty("idVip");
2.4消息的持久化:
什么是持久化消息?
保证消息只被传送一次和成功使用一次。在持久性消息传送至目标时,消息服务将其放入持久性数据存储。如果消息服务由于某种原因导致失败,它可以恢复此消息并将此消息传送至相应的消费者。在消息生产者将消息成功发送给MQ消息中间件之后。无论是出现任何问题,如:MQ服务器宕机、消费者掉线等。都保证(topic要之前注册过,queue不用)消息消费者,能够成功消费消息。
队列
当生产者成功发布消息之后,MQ服务端宕机重启,消息消费者就收不到该消息了
// 非持久化
messageProducer.setDeliveryMode(DeliveryMode.NON_PERSISTENT);
topic消息持久化
topic默认就是非持久化的,因为生产者生产消息时,消费者也要在线,这样消费者才能消费到消息。
topic消息持久化,只要消费者向MQ服务器注册过,所有生产者发布成功的消息,该消费者都能收到,不管是MQ服务器宕机还是消费者不在线。
注意:
1.一定要先运行一次消费者,等于向MQ注册,类似我订阅了这个主题。
2.然后再运行生产者发送消息。
3.之后无论消费者是否在线,都会收到消息。如果不在线的话,下次连接的时候,会把没有收过的消息都接收过来。
生产者代码
public static void main(String[] args) throws Exception{
ActiveMQConnectionFactory activeMQConnectionFactory = new ActiveMQConnectionFactory(ACTIVEMQ_URL);
javax.jms.Connection connection = activeMQConnectionFactory.createConnection();
Session session = connection.createSession(false, Session.AUTO_ACKNOWLEDGE);
Topic topic = session.createTopic(TOPIC_NAME);
MessageProducer messageProducer = session.createProducer(topic);
// 设置持久化topic
messageProducer.setDeliveryMode(DeliveryMode.PERSISTENT);
// 设置持久化topic之后再,启动连接
connection.start();
for (int i = 1; i < 4 ; i++) {
TextMessage textMessage = session.createTextMessage("topic_name--" + i);
messageProducer.send(textMessage);
MapMessage mapMessage = session.createMapMessage();
}
messageProducer.close();
session.close();
connection.close();
System.out.println(" **** TOPIC_NAME消息发送到MQ完成 ****");
}
消费者
public static void main(String[] args) throws Exception{
ActiveMQConnectionFactory activeMQConnectionFactory = new ActiveMQConnectionFactory(ACTIVEMQ_URL);
Connection connection = activeMQConnectionFactory.createConnection();
// 设置客户端ID。向MQ服务器注册自己的名称
connection.setClientID("marrry");
Session session = connection.createSession(false, Session.AUTO_ACKNOWLEDGE);
Topic topic = session.createTopic(TOPIC_NAME);
// 创建一个topic订阅者对象。一参是topic,二参是订阅者名称
TopicSubscriber topicSubscriber = session.createDurableSubscriber(topic,"remark...");
// 之后再开启连接
connection.start();
Message message = topicSubscriber.receive();
while (null != message){
TextMessage textMessage = (TextMessage)message;
System.out.println(" 收到的持久化 topic :"+textMessage.getText());
message = topicSubscriber.receive();
}
session.close();
connection.close();
}
2.5 消息的事务性与签收
2.5.1事务特性:
- 生产者开启事务后,执行commit方法,这批消息才真正的被提交。不执行commit方法,这批消息不会提交。执行rollback方法,之前的消息会回滚掉。生产者的事务机制,要高于签收机制,当生产者开启事务,签收机制不再重要。
- 消费者开启事务后,执行commit方法,这批消息才算真正的被消费。不执行commit方法,这些消息不会标记已消费,下次还会被消费。执行rollback方法,是不能回滚之前执行过的业务逻辑,但是能够回滚之前的消息,回滚后的消息,下次还会被消费。消费者利用commit和rollback方法,甚至能够违反一个消费者只能消费一次消息的原理。
- 消费者和生产者的事务,完全没有关联,各自是各自的事务。
生产者
Session session = connection.createSession(true, Session.AUTO_ACKNOWLEDGE);
Queue queue = session.createQueue("queue_name);
MessageProducer producer = session.createProducer(queue);
try {
for (int i = 0; i < 3; i++) {
TextMessage textMessage = session.createTextMessage("tx msg--" + i);
producer.send(textMessage);
if(i == 2){
throw new RuntimeException("GG.....");
}
}
// 2. 开启事务后,使用commit提交事务,这样这批消息才能真正的被提交。
session.commit();
System.out.println("消息发送完成");
} catch (Exception e) {
System.out.println("出现异常,消息回滚");
// 3. 工作中一般,当代码出错,我们在catch代码块中回滚。这样这批发送的消息就能回滚。
session.rollback();
}
消费者
// 创建会话session,两个参数transacted=事务,acknowledgeMode=确认模式(签收)
// 消费者开启了事务就必须手动提交,不然会重复消费消息
final Session session = connection.createSession(true, Session.AUTO_ACKNOWLEDGE);
Queue queue = session.createQueue("queue_name");
MessageConsumer messageConsumer = session.createConsumer(queue);
messageConsumer.setMessageListener(new MessageListener() {
int a = 0;
@Override
public void onMessage(Message message) {
if (message instanceof TextMessage) {
try {
TextMessage textMessage = (TextMessage) message;
System.out.println("***消费者接收到的消息: " + textMessage.getText());
if(a == 0){
System.out.println("commit");
session.commit();
}
if (a == 2) {
System.out.println("rollback");
session.rollback();
}
a++;
} catch (Exception e) {
System.out.println("出现异常,消费失败,放弃消费");
try {
session.rollback();
} catch (JMSException ex) {
ex.printStackTrace();
}
}
}
}
});
控制台输出
***消费者接收到的消息: tx msg--0
commit
***消费者接收到的消息: tx msg--1
***消费者接收到的消息: tx msg--2
rollback
***消费者接收到的消息: tx msg--1
***消费者接收到的消息: tx msg--2
2.5.2消息的签收机制
签收的几种方式
自动签收(Session.AUTO_ACKNOWLEDGE):该方式是默认的。框架会帮我们自动签收收到的消息。
手动签收(Session.CLIENT_ACKNOWLEDGE):手动签收。需要我们手动调用Message.acknowledge(),来签收消息。如果不签收消息,该消息会被我们反复消费,只到被签收。
允许重复消息(Session.DUPS_OK_ACKNOWLEDGE):多线程或多个消费者同时消费到一个消息,因为线程不安全,可能会重复消费。该种方式很少使用到。
事务下的签收(Session.SESSION_TRANSACTED):开始事务的情况下,可以使用该方式。该种方式很少使用到。
事务和签收的关系
在事务性会话中,当一个事务被成功提交则消息被自动签收。如果事务回滚,则消息会被再次传送。事务优先于签收,开始事务后,签收机制不再起任何作用。
非事务性会话中,消息何时被确认取决于创建会话时的应答模式。
生产者事务开启,只有commit后才能将全部消息变为已消费。
事务偏向生产者,签收偏向消费者。也就是说,生产者使用事务更好点,消费者使用签收机制更好点。
2.6 总结
点对点
点对点模型是基于队列的,生产者发消息到队列,消费者从队列接收消息,队列的存在使得消息的异步传输成为可能。和发送短信类似。
如果在Session关闭时有部分消息己被收到但还没有被签收(acknowledged),那当消费者下次连接到相同的队列时,这些消息还会被再次接收。队列可以长久地保存消息直到消费者收到消息。消费者不需要时刻和队列保持激活的连接状态,充分体现了异步传输模式的优势
发布订阅总结
(1) JMS的发布订阅总结
JMS Pub/Sub 模型定义了如何向一个内容节点发布和订阅消息,这些节点被称作topic。
主题可以被认为是消息的传输中介,发布者(publisher)发布消息到主题,订阅者(subscribe)从主题订阅消息。
主题使得消息订阅者和消息发布者保持互相独立不需要解除即可保证消息的传送
(2) 非持久订阅
非持久订阅只有当客户端处于激活状态,也就是和MQ保持连接状态才能收发到某个主题的消息。
如果消费者处于离线状态,生产者发送的主题消息将会丢失作废,消费者永远不会收到。
一句话:先订阅注册才能接受到发布,只给订阅者发布消息。
(3) 持久订阅
客户端首先向MQ注册一个自己的身份ID识别号,当这个客户端处于离线时,生产者会为这个ID保存所有发送到主题的消息,当客户再次连接到MQ的时候,会根据消费者的ID得到所有当自己处于离线时发送到主题的消息。当持久订阅状态下,不能恢复或重新派送一个未签收的消息。
持久订阅才能恢复或重新派送一个未签收的消息。
(4) 非持久和持久化订阅如何选择
当所有的消息必须被接收,则用持久化订阅。当消息丢失能够被容忍,则用非持久订阅。