------------恢复内容开始------------
1.JMS是什么
JMS即Java消息服务（Java Message Service）应用程序接口，是一个java平台中关于面向消息中间件（MOM）的API，用于在两个应用程序之间，或分布式系统中发送消息，进行异步通信。Java消息服务是一个与具体平台无关的API，绝大多数MOM提供商都对JMS提供支持。
2.JMS的主要组成部分
- jms provider 消息中间件/消息服务器也就是MQ
- jms producer 消息生产者
- jms consumer 消息消费者
- jms message 消息
3.消息结构(jms message)
消息头:
红色的为常用的属性
1.JMSDestination：消息发送的目的地：主要指Queue和Topic，自动分配。
2.JMSDeliveryMode：传送模式。有两种：持久模式和非持久模式。一条持久性的消息应该被传送“一次仅仅一次”，这就意味着如果JMS提供者出现故障，该消息并不会丢失，它会在服务器恢复之后再次传递。一条非持久的消息最多会传送一次，这意味着服务器出现故障，该消息将永久丢失。自动分配。
3.JMSExpiration：消息过期时间，等于Destination的send方法中的timeToLive值加上发送时刻的GMT时间值。如果timeToLive值等于零，则JMSExpiration被设为零，表示该消息永不过期。如果发送后，在消息过期时间之后消息还没有被发送到目的地，则该消息被清除。自动分配。
4.JMSPriority：消息优先级，从0-9十个级别，0-4是普通消息，5-9是加急消息。JMS不要求JMS Provider严格按照这十个优先级发送消息，但必须保证加急消息要先于普通消息到达。默认是4级。自动分配。
5.JMSMessageID：唯一识别每个消息的标识，由JMS Provider产生。自动分配。
6.JMSTimestamp：一个JMS Provider在调用send()方法时自动设置的。它是消息被发送和消费者实际接收的时间差。自动分配。
7.JMSCorrelationID：用来连接到另外一个消息，典型的应用是在回复消息中连接到原消息。在大多数情况下，JMSCorrelationID
8.JMSReplyTo：提供本消息回复消息的目的地址。由开发者设置。
9.JMSType
10.JMSRedelivered
消息体:
JMS API定义了5种消息体格式，也叫消息类型，可以使用不同形式发送接收数据，并可以兼容现有的消息格式
- Text message : javax.jms.TextMessage，表示一个文本对象。
- Map message : javax.jms.MapMessage，表示键值对。
- Object message : javax.jms.ObjectMessage，表示一个JAVA对象。
- Bytes message : javax.jms.BytesMessage，表示字节数据。
- Stream message :javax.jms.StreamMessage，表示java原始值数据流。
生产者生产不同类型的信息
//通过session创建消息, TextMessage textMessage = session.createTextMessage("this is msg\t"+i); MapMessage mapMessage = session.createMapMessage(); mapMessage.setString("key","mapMessage"); //用producer将消息发送至MQ的队列里 producer.send(textMessage); producer.send(mapMessage);
消费者消费不同类型的信息
consumer.setMessageListener(new MessageListener(){ @Override public void onMessage(Message message) { //获取字符串类型的消息 if (message!=null&&message instanceof TextMessage) { TextMessage message1 =(TextMessage)message; try { String text = message1.getText(); System.out.println(text); } catch (JMSException e) { e.printStackTrace(); } } //获取map类型的消息 if (message!=null&&message instanceof MapMessage) { MapMessage mapMessage =(MapMessage)message; try { String text = mapMessage.getString("key"); System.out.println(text); } catch (JMSException e) { e.printStackTrace(); } } } });
消息属性
我们可以给消息设置自定义属性，这些属性主要是提供给应用程序的。对于实现消息过滤功能，消息属性非常有用，JMS API定义了一些标准属性，JMS服务提供者可以选择性的提供部分标准属性。
一系列的setXXXProperty的方法,参数类型为键值对的方式,设消息附加一些属性
生产者生产消息时给消息附带消息属性,可以用于区别消息。
TextMessage textMessage = session.createTextMessage("this is msg\t"+i);
textMessage.setStringProperty("key1","消息属性");
producer.send(textMessage);
消费者获取消息时也可以通过key获取到消息的属性
consumer.setMessageListener(new MessageListener(){ @Override public void onMessage(Message message) { //获取字符串类型的消息 if (message!=null&&message instanceof TextMessage) { TextMessage message1 =(TextMessage)message; try { String text = message1.getText(); String key1 = message1.getStringProperty("key1"); System.out.println(key1); System.out.println(text); } catch (JMSException e) { e.printStackTrace(); } } }
4.消息的可靠性
- 持久化
- 签收
- 事务
持久化:当服务器突然宕机的时候,队列中未被消费的的信息,是否会消失。
可靠性的一个重要方面是确保持久性消息传送至目标后，消息服务在向消费者传送它们之前不会丢失这些消息。
在队列模式中默认是持久化的
//.创建消息的生产者
MessageProducer producer = session.createProducer(queue);
//持久化,当服务器宕机的时候,消息依然存在
producer.setDeliveryMode(DeliveryMode.PERSISTENT);
//非持久化,当服务器宕机的时候消息不存在
producer.setDeliveryMode(DeliveryMode.NON_PERSISTENT);
持久化Topic
- 一定要先运行次消费者，等于应MQ注册， 类似我订阅了这个主题，
- 然后再运行生产者发送信息，
- 此时，无论消费者是否在线，都会接收到，不在我的话，下次还接的时候， 公把没有收过的消息都接收下来。
生产者(start的时机要在设置好DeliveryMode)之后,这样的话就可以实现持久化了
package com.yjc.activemq; import org.apache.activemq.ActiveMQConnectionFactory; import javax.jms.*; public class JMSProducer_Topic { //ActiveMQ的url private static final String ACTIVEMQ_URL="tcp://192.168.118.3:61616"; //Topic的名称 private static final String TOPIC_NAME="topic001"; public static void main(String[] args) throws JMSException { //1.创建ActiveMQ的连接工程,给定ActiveMQ的url,使用默认账号和密码 ActiveMQConnectionFactory activeFactory=new ActiveMQConnectionFactory(ACTIVEMQ_URL); //2.创建active的连接对象,抛出或捕获异常,并启动connection Connection connection = activeFactory.createConnection(); //3.创建会话对象,两个参数前者为事务,后者为签收 Session session = connection.createSession(false, Session.AUTO_ACKNOWLEDGE); //4.创建目的地,目的地的类型为队列(Queue),参数为队列的名称 //Queue和Topic都继承自Destination接口 Topic topic = session.createTopic(TOPIC_NAME); //5.创建消息的生产者 MessageProducer producer = session.createProducer(topic); producer.setDeliveryMode(DeliveryMode.NON_PERSISTENT); connection.start();//设置完持久化再start之后就可以实现持久化了 for (int i=1;i<=3;i++){ //6.通过session创建消息, TextMessage textMessage = session.createTextMessage("this is msg\t"+i); textMessage.setStringProperty("key1","消息属性"); //7.用producer将消息发送至MQ的队列里 producer.send(textMessage); } //8.释放资源,先开后关 producer.close(); session.close(); connection.close(); System.out.println("将消息发送至MQ队列中成功!!!"); } }
消费者
start()方法的调用时机为durableSubscriber 对象创建完毕之后
package com.yjc.activemq; import org.apache.activemq.ActiveMQConnectionFactory; import javax.jms.*; import java.io.IOException; public class JMSConsumer_Topic { //ActiveMQ的url private static final String ACTIVEMQ_URL="tcp://192.168.118.3:61616"; //Topic的名称 private static final String TOPIC_NAME="topic001"; public static void main(String[] args) throws JMSException, IOException { //1.创建ActiveMQ的连接工程,给定ActiveMQ的url,使用默认账号和密码 ActiveMQConnectionFactory activeFactory=new ActiveMQConnectionFactory(ACTIVEMQ_URL); //2.创建active的连接对象,抛出或捕获异常,并启动connection Connection connection = activeFactory.createConnection(); //设置客户端的id connection.setClientID("yjc"); //3.创建会话对象,两个参数前者为事务,后者为签收 Session session = connection.createSession(false, Session.AUTO_ACKNOWLEDGE); //4.创建目的地,目的地的类型为队列(Queue),参数为队列的名称 //Queue和Topic都继承自Destination接口 Topic topic=session.createTopic(TOPIC_NAME); //----------------------上面的步骤和Producer的一样------------------------------------------------ //5.创建订阅者 TopicSubscriber durableSubscriber = session.createDurableSubscriber(topic, "remake....."); connection.start();//此处启动 Message message = durableSubscriber.receive(); while (message!=null){ TextMessage textMessage=(TextMessage)message; System.out.println("消息内容为"+textMessage.getText()); message=durableSubscriber.receive(1000L); } //7.释放资源先开后关 durableSubscriber.close(); session.close(); connection.close(); System.out.println("消费完毕!!!"); } }
5.消息的事务
Session session = connection.createSession(false, Session.AUTO_ACKNOWLEDGE);//代表生产者不开启事务
生产者
false:代表生产者执行完send()方法之后,该信息就会被提交到队列之中
true:代表生产者做的操作不会被立即提交,需要使用session对象调用commit()方法,之前的操作才会被真正提交,当然也可以回滚
消费者
false:代表消费者消费完一条信息之后,消息会立马从消息队列中出列
true:代表消费者消费完信息之后,如果不commit的话,所消费的消息就不会出列,这样的话就会有重复消费的可能性
6.签收
事务偏生产者,签收偏消费者
非事务下的签收
Session session = connection.createSession(false, Session.AUTO_ACKNOWLEDGE);//代表不开事务,默认为自动签收
即使消费了消息,不签收成功的话,消息也是不会出列的
[ Session.AUTO_ACKNOWLEDGE ] 自动签收(默认)
当客户端从receiver或onMessage成功返回时，Session自动签收客户端的这条消息的收条。
[ Session.CLIENT_ACKNOWLEDGE ]手动签收
客户端通过调用消息(Message)的acknowledge方法签收消息。在这种情况下，签收发生在Session层面：签收一个已经消费的消息会自动地签收这个Session所有已消费的收条。
[ Session.DUPS_OK_ACKNOWLEDGE ]允许重复消息
Session不必确保对传送消息的签收，这个模式可能会引起消息的重复，但是降低了Session的开销，所以只有客户端能容忍重复的消息，才可使用。不常用
事务下的签收
事务性会话中，当一个事务被成功提交则消息被自动签收。也就是说,在事务的开启的情况下,无论是自动签收或者是手动签收,只要事务成功提交了,消息就会被自动签收,在手动签收的情况下
不调用消息(Message)的acknowledge方法消息也会被签收,消息也会出列。而如果你调用消息(Message)的acknowledge方法进行签收,但是没有commit的话也是不会签收的。
如果事务回滚，则消息会被再次传送。
非事务性会话中，消息何时被确认取决于创建会话时的应答模式(acknowledgementmode)