JMS -ActiveMQ Artemi
JMS:它是一个规范,类似于jdbctemplate
Spring提供了jmstemplate来发送和接收消息。
搭建JMS环境
1.引入依赖
我们要使用的消息中间件代理是ActiveMQ Artemi,他是ActiveMQ的进阶版
这里我们要引入的依赖是ActiveMQ Artemis的依赖
<dependency> <groupId>org.springframework.boot</groupId> <artifactId>spring-boot-starter-artemis</artifactId> </dependency>
2.配置属性
spring: artemis: host: 消息中间件(ActiveMQ Artemi)所在主机地址 port: 61617 user: admin password: 123456
备注说明:这个配置,如果是在本地开发运行,这个配置不需要
3.安装ActiveMQ Artemi
http://activemq.apache.org/artemis/download.html
解压到
D:\DevTools\apache-artemis-2.6.3-bin
执行 cmd
cd /d D:\DevTools\apache-artemis-2.6.3-bin\apache-artemis-2.6.3\bin
artemis create D:\DevTools\apache-artemis-2.6.3-bin\myartemis
//需要设置一个账号
Please provide the default username:
admin
//需要为这个账号密码设置
Please provide the default password:
admin
//需要设置是否允许匿名登录
Allow anonymous access?, valid values are Y,N,True,False
Y
继续 执行 cmd
cd /d D:\DevTools\apache-artemis-2.6.3-bin\myartemis\bin
启动实例
artemis run
PS: 卸载系统服务
sc delete 服务名
打开主页
http://localhost:8161/
8161是它的默认端口
4.使用JMS发送消息
4.1 我们在之前引入的ActiveMQ Artemis的依赖,springboot会为我们创建一个JMSTemplate对象,我们只需要注入就可以使用
@Autowired
private JmsTemplate jms;
4.2 JMSTemplate发送消息的方法可以分为三类,每一类又有三个重载方法
下面三个方法,传输的是Message对象,需要使用转换器把数据对象转换成Message
send(Message me) //传输Message对象,采用默认地址 Send(Destination dest,Message me) //传输Message对象,采用Destination 的地址 Send(String dest,Message me)//传输Message对象,采用String地址
下面三个方法,与上面相比,直接传输数据对象而不是message,少了吧对象转换成message的步骤。自动完成转换,转换器使用的是默认的转换器,如果要使用其他转换器,也可以配置
convertAndSend(Object o)
convertAndSend(Destination dest,Object o)
convertAndSend(String dest,Object o)
//下面三个方法,与上面相比,多传输了一个对象MessagePostProsser,在这里面可以传入一些数据对象无法传输的信息
convertAndSend(Object o,MessagePostProsser p)
convertAndSend(Destination dest,Object o,MessagePostProsser p)
convertAndSend(String dest,Object o,MessagePostProsser p)
关于转换器
Spring提供了转换器,当然,我们也可以自定义转换器,不过spring提供的已经够用了
默认使用的是SimpleMessageConverter
如果我们想要使用别的,比如MappingJackson2MessageConverter ,只需要
package tacos.config; import javax.jms.Destination; import org.apache.activemq.artemis.jms.client.ActiveMQQueue; import org.springframework.context.annotation.Bean; import org.springframework.context.annotation.Configuration; import org.springframework.jms.support.converter.MappingJackson2MessageConverter; @Configuration public class JmsConfig { @Bean public MappingJackson2MessageConverter getMessageConverter(){ MappingJackson2MessageConverter m = new MappingJackson2MessageConverter(); //下面是为了让接受者知道是什么类型 在接收端,也要做相应的配置 m.setTypeIdPropertyName("_typeId"); Map<String,Class<?>> ma = new HashMap<>(); ma.put("orga", Organization.class); m.setTypeIdMappings(ma); return m; } }
4.3第一类send方法
1)第一种:一个参数MessageCreator-生成消息
@RequestMapping(value="/jms0") public void test0(){ Organization o = new Organization(); o.setOrgname("jms测试"); jms.send(new MessageCreator() { 第一种使用lamada表达式简写 @Override public Message createMessage(Session arg0) throws JMSException { arg0.createObjectMessage(o); return null; } }); //1个参数 MessageCreator 这个参数用来构建message System.out.println("发送成功"); }
2) 第二种://2个参数 1.指定目的地及其他信息 2. MessageCreator 这个参数用来构建message
package tacos.config; import javax.jms.Destination; import org.apache.activemq.artemis.jms.client.ActiveMQQueue; import org.springframework.context.annotation.Bean; import org.springframework.context.annotation.Configuration; @Configuration public class JmsConfig { @Bean public Destination getDestination(){ return new ActiveMQQueue("tacocloud.order.queue"); } } @Autowired private Destination dist; @RequestMapping(value="/jms2") public void test2(){ Organization o = new Organization(); o.setOrgname("jms测试"); jms.send(dist,session -> session.createObjectMessage(o));//2个参数 1.Destination 指定目的地(还可以指定一些其他信息,不过一般不用) 2. MessageCreator 这个参数用来构建message System.out.println("发送成功"); }
3)第三种://2个参数 1.指定目的地 2. MessageCreator 这个参数用来构建message
@RequestMapping(value="/jms3") public void test3(){ Organization o = new Organization(); o.setOrgname("jms测试"); jms.send("tacocloud.order.mytest",session -> session.createObjectMessage(o));//2个参数 1.指定目的地 2. MessageCreator 这个参数用来构建message System.out.println("发送成功"); }
4.4第二类方法convertAndSend
1) 第一种:一个参数,要发送的对象,不需要构建MessageCreator来转换对象,它会自动转换,更为简单
@RequestMapping(value="/jms4") public void test4(){ Organization o = new Organization(); o.setOrgname("jms测试"); jms.convertAndSend(o);//1个参数 要发送的对象 System.out.println("发送成功"); }
2) 第二种:2个参数。1:目的地及其他信息,2:要发送的对象,不需要构建MessageCreator来转换对象,它会自动转换,更为简单
@RequestMapping(value="/jms5") public void test5(){ Organization o = new Organization(); o.setOrgname("jms测试"); jms.convertAndSend(dist,o);//2个参数 1.Destination 指定目的地(还可以指定一些其他信息,不过一般不用) 2.要发送的对象 System.out.println("发送成功"); }
3) 第三种2个参数 1:目的地,2:要发送的对象,不需要构建MessageCreator来转换对象,它会自动转换,更为简单
@RequestMapping(value="/jms6") public void test6(){ Organization o = new Organization(); o.setOrgname("jms测试"); jms.convertAndSend("tacocloud.order.mytest2",o);//1个参数 要发送的对象 System.out.println("发送成功"); }
4.5第三类convertAndSend
1)第一种,两个参数 1:要传输的对象 2.MessagePostProcessor对象,它可以携带除了要参数的对象以外的信息。比如我传一个USER对象,我还想传本次传输的时间,但是User对象里面没有这个属性,那么就可以在MessagePostProcessor里面传过去
@RequestMapping(value="/jms7") public void test7(){ //发送消息本身 和 其他信息 Organization o = new Organization(); o.setOrgname("jms测试"); jms.convertAndSend(o,new MessagePostProcessor() { @Override public Message postProcessMessage(Message arg0) throws JMSException { arg0.setStringProperty("source", "mytest"); return arg0; } });//1个参数 要发送的对象 System.out.println("发送成功"); } 使用lamada表达式简写 @RequestMapping(value="/jms8") public void test8(){ //更简便的写法 Organization o = new Organization(); o.setOrgname("jms测试"); jms.convertAndSend(o,this::getMessage);//1个参数 要发送的对象 System.out.println("发送成功"); } public Message getMessage(Message me) throws JMSException{ me.setStringProperty("source", "mytest"); return me; }
2)第二种
三个参数 1:目的地及其他信息 2.要参数的对象 3.MessagePostProcessor对象
@RequestMapping(value="/jms9") public void test9(){ //更简便的写法 Organization o = new Organization(); o.setOrgname("jms测试"); jms.convertAndSend(dist,o,this::getMessage);//1个参数 要发送的对象 System.out.println("发送成功"); }
3)第三种
三个参数 1:目的地 2.要参数的对象 3.MessagePostProcessor对象
@RequestMapping(value="/jms10") public void test10(){ //更简便的写法 Organization o = new Organization(); o.setOrgname("jms测试"); jms.convertAndSend("tacocloud.order.mytest2",o,this::getMessage);//1个参数 要发送的对象 System.out.println("发送成功"); }
三类方法做一个小结
三类方法
第一类:最为基础,需要使用MessageCreator 来构建message
第二类:第一类的升级,更为渐变,不需要MessageCreator 来转换,直接传入要传输的对象即可
底三类:第二类的升级,除了可以参数对象,还可以参数MessagePostProcessor对象来传输其它的任何信息
每3类方法都有3个重载方法
- 不带目的地参数
- 带Destination 参数,里面可以包含目的地和其它的一些信息
- 待String参数,也就是目的地
5.接收JMS消息(拉取模式)
发送消息的条件
- 配置默认目的地 tacocloud.order.mytest3
spring: jms: template: default-destination: tacocloud.order.mytest3
2.使用Destination
@Bean public Destination getDestination(){ return new ActiveMQQueue("tacocloud.order.jms2"); }
3.转换器 MappingJackson2MessageConverter- 和发送消息的转换器对应-如果是默认的转换器,不需要配置
@Bean public MappingJackson2MessageConverter getMessageConverter(){ MappingJackson2MessageConverter m = new MappingJackson2MessageConverter(); //下面是为了让接受者知道是什么类型 在接收端,也要做相应的配置 m.setTypeIdPropertyName("_typeId"); Map<String,Class<?>> ma = new HashMap<>(); ma.put("orga", Organization.class); m.setTypeIdMappings(ma); return m; }
接收消息有两个方法receive和receiveAndConvert,前者返回message对象,后者返回数据对象。他们也都有3个重载方法。和发送消息一一对应。不论发送消息用的是哪个方法,这两个接收方法都可以接收。注意:目的地要对应,转换器也要对应。
由于发送和接受在一个项目写的,发送消息转换器已配置了,接收这里转换器就不用配置了
1)
@RequestMapping(value="/receivejms1") public void receivejms1() throws MessageConversionException, JMSException{ //接收消息,没有参数,接收的是默认地址 接收到的是messsage对象,要获取数据对象,需要使用转换器,这个转换器需要和发送的转换器一致 Message receive = jms.receive(); Organization fromMessage = (Organization) con.fromMessage(receive); System.out.println(fromMessage.toString()); Destination jmsDestination = receive.getJMSDestination(); System.out.println(jmsDestination.toString()); }
2)
@RequestMapping(value="/receivejms2") public void receivejms2() throws MessageConversionException, JMSException{ //接收消息,多了个参数Destination,接收的是Destination里面的地址 接收到的是messsage对象,要获取数据对象,需要使用转换器,这个转换器需要和发送的转换器一致 //receive 方法 Message receive = jms.receive(dist); Organization fromMessage = (Organization) con.fromMessage(receive); System.out.println(fromMessage.toString()); Destination jmsDestination = receive.getJMSDestination(); System.out.println(jmsDestination.toString()); String source = receive.getStringProperty("source"); System.out.println(source); }
3)
@RequestMapping(value="/receivejms3") public void receivejms3() throws MessageConversionException, JMSException{ //接收消息,多了个参数地址,接收到的是messsage对象,要获取数据对象,需要使用转换器,这个转换器需要和发送的转换器一致 Message receive = jms.receive("tacocloud.order.jms2"); Organization fromMessage = (Organization) con.fromMessage(receive); System.out.println(fromMessage.toString()); Destination jmsDestination = receive.getJMSDestination(); System.out.println(jmsDestination.toString()); }
4)
@RequestMapping(value="/receivejms4") public void receivejms4() throws MessageConversionException, JMSException{ // receiveAndConvert 接收消息 ,没有参数,使用默认地址,接收到的是数据对象,不需要手动转换,自动就转换了 Organization receiveAndConvert = (Organization) jms.receiveAndConvert(); System.out.println(receiveAndConvert.toString()); }
5)
@RequestMapping(value="/receivejms5") public void receivejms5() throws MessageConversionException, JMSException{ // receiveAndConvert 接收消息 ,一个参数Destination,使用Destination地址,接收到的是数据对象,不需要手动转换,自动就转换了 Organization receiveAndConvert = (Organization) jms.receiveAndConvert(dist); System.out.println(receiveAndConvert.toString()); }
6)
@RequestMapping(value="/receivejms6") public void receivejms6() throws MessageConversionException, JMSException{ // receiveAndConvert 接收消息 ,一个参数地址,接收到的是数据对象,不需要手动转换,自动就转换了 Organization receiveAndConvert = (Organization) jms.receiveAndConvert("tacocloud.order.jms2"); System.out.println(receiveAndConvert.toString()); }
小结:receive方法和receiveAndConvert方法,前者接收到的是message对象,包含了数据对象以及其他的一些消息,后者直接接收的是数据对象。两种都有3个重载方法。分别使用默认地址,Destination指定地址,String地址。备注说明(发送消息第三类方法convertAndSend的参数MessagePostProcessor需要使用receive方法获取message对象,在调用getStringProperty方法获取里面的数据。看上面的第二个接收消息方法)
- 接收JMS消息(推送模式)
package tacos; import javax.jms.JMSException; import org.springframework.jms.support.converter.MessageConversionException; import org.springframework.stereotype.Component; @Component public class JmsListener { @org.springframework.jms.annotation.JmsListener(destination="tacocloud.order.mytest3") public void receivejms13(Organization fromMessage) throws MessageConversionException, JMSException{ System.out.println("推送"+fromMessage); } }
这种模式采用的是@JmsListener注解去指定目的地,相当于加了一个监听器,当有消息发送来的时候,该方法被调用
拉取模式和推送模式
- 拉取模式,消费者是主动地,需要主动调用消费消息的方法去拉取消息,若存在消息,拉取,若没有消息,等待,线程一致被占用,一直到拉取到消息
- 推送模式,生产者是主动的。监听器一直在舰艇生产者的消息,生成者发送消息,被监听器监听到,调用消费者方法消费。这种方法不会一致占用资源
两种模式优劣:
比如说在蛋糕店订蛋糕,客人订蛋糕,蛋糕店接受订单。若采取拉取模式,蛋糕店作为消息的消费者,是主动的去获取订单,那么他们可以在一个订单做完了,再去拉取下一个订单。不会出现一下子来大量订单使得无法完成。
比如说快餐店外卖。快餐店作为消息的消费者。正常情况下不用考虑来不及的情况。可以采取推送模式。顾客点单,快餐店就接收。
6.发布-订阅模式
前面我们讲的都是顶对点模式,现在看怎么用发布订阅模式。在点对点的基础上。
1) 添加配置
spring: jms: pub-sub-domain: true
2) 发送消息-前面点对点模式Destination 采用ActiveMQQueue
Destination d = new ActiveMQQueue("tacocloud.order.jms2");
现在
Destination dest = new ActiveMQTopic("tacocloud.order.dingyue1");
3) 接收消息-只能采用推送模式
package tacos; import javax.jms.JMSException; import org.springframework.jms.support.converter.MessageConversionException; import org.springframework.stereotype.Component; @Component public class JmsListener { @org.springframework.jms.annotation.JmsListener(destination="tacocloud.order.mytest3") @org.springframework.jms.annotation.JmsListener(destination="tacocloud.order.dingyue1") public void receivejms14(Organization fromMessage) throws MessageConversionException, JMSException{ System.out.println("订阅模式消费者1"+fromMessage); } @org.springframework.jms.annotation.JmsListener(destination="tacocloud.order.dingyue1") public void receivejms15(Organization fromMessage) throws MessageConversionException, JMSException{ System.out.println("订阅模式消费者2"+fromMessage); } }
点对点/发布订阅两种模式由生产者端的代码来决定
拉取/推送两种消费方式由消费者端代码来决定
JMS缺点:只能作用于JAVA应用中。