02_ActiveMQ入门
【ActiveMQ 入门HelloWorld例子】
【启动ActiveMQ】
1.由于本人PC是64位的，选择在bin目录下的win64/activemq.bat启动。
2.启动成功后，访问http://localhost:8161/admin/ ，输入用户名密码，默认均为admin。进入ActiveMq的web页面的控制台。
【工程截图】
【生产者Sender.java】
package test.activemq.demo; import javax.jms.Connection; import javax.jms.ConnectionFactory; import javax.jms.DeliveryMode; import javax.jms.Destination; import javax.jms.JMSException; import javax.jms.MessageProducer; import javax.jms.Session; import javax.jms.TextMessage; import org.apache.activemq.ActiveMQConnectionFactory; public class Sender { public static void main(String[] args) throws JMSException { /** * 1.建立ConnectionFactory工厂对象,需要填入用户名、密码、以及要连接的地址，均使用默认，端口默认为"tcp://localhost:61616" */ ConnectionFactory connectionFactory = new ActiveMQConnectionFactory( ActiveMQConnectionFactory.DEFAULT_USER, ActiveMQConnectionFactory.DEFAULT_PASSWORD, "tcp://localhost:61616"); /** * 2.通过ConnectionFactory工厂对象创建一个Connection连接，并且调用Connection的start()方法开启连接，Connection默认是关闭的 */ Connection connection = connectionFactory.createConnection(); connection.start(); /** * 3.通过Connection对象创建Session会话（上下文环境对象），用于接收消息。 * 参数1：是否启用事务 * 参数2：签收模式，一般设置为自动签收 */ Session session = connection.createSession(Boolean.FALSE, Session.AUTO_ACKNOWLEDGE); /** * 4.通过Session创建Destination对象，即一个客户端用来指定 生产者目标 和 消费者来源的 对象。 * PTP模式中：Destination被称为Queue，队列 * Pub/Sub模式中：Destination被称为Topic，主题 * 在程序中可以使用多个Queue 和 Topic */ Destination destination = session.createQueue("queue1"); /** * 5.需要通过Session对象创建消息的发送或接受对象（生产者或消费者，MessageProducer/MessageConsumer） */ MessageProducer messageProducer = session.createProducer(destination); /** * 6.使用MessageProducer的serDeliveryMode方法为其设置持久化特性和非持久化特性（DeliveryMode） */ messageProducer.setDeliveryMode(DeliveryMode.NON_PERSISTENT); //设置为不持久化 /** * 7.最后，使用JMS规范的TextMessage形式创建数据（通过Session对象）， * 发送端使用MessageProducer的Send方法发送数据。 * 接受端使用receive方法接收数据。 */ for(int i=0;i<5;i++){ TextMessage testMessage = session.createTextMessage(); testMessage.setText("我的Id的是："+i); messageProducer.send(testMessage); System.out.println("【生产者发送】"+testMessage.getText()); } /** * 8.最后记得关闭Connection连接 */ if(connection!=null){ connection.close(); } } }
【Sender运行结果：Eclipse控制台】
【Sender运行结果：web控制台】
Number Of Pending Messages :等待消费的队列
Messages Enqueued : 进入队列的消息的总数量（总数量只增不减）
Messages Dequeued ：出了队列的消息的总数量（即消费了的消息数量）
【Sender运行结果：点击"queue1"查看队列详情】
【消费者Receiver.java】
package test.activemq.demo; import javax.jms.Connection; import javax.jms.ConnectionFactory; import javax.jms.Destination; import javax.jms.JMSException; import javax.jms.MessageConsumer; import javax.jms.Session; import javax.jms.TextMessage; import org.apache.activemq.ActiveMQConnectionFactory; public class Receiver { public static void main(String[] args) throws JMSException { /** * 1.建立ConnectionFactory工厂对象，需要填入用户名、密码、以及要连接的地址，均使用默认，端口默认为"tcp://localhost:61616" */ ConnectionFactory connectionFactory = new ActiveMQConnectionFactory( ActiveMQConnectionFactory.DEFAULT_USER, ActiveMQConnectionFactory.DEFAULT_PASSWORD, "tcp://localhost:61616"); /** * 2.通过ConnectionFactory工厂对象创建一个Connection连接，并且调用Connection的start()方法开启连接，Connection默认是关闭的 */ Connection connection = connectionFactory.createConnection(); connection.start(); /** * 3.通过Connection对象创建Session会话（上下文环境对象），用于接收消息。参数1：是否启用事务 参数2：签收模式，一般设置为自动签收 */ Session session = connection.createSession(Boolean.FALSE, Session.AUTO_ACKNOWLEDGE); /** * 4.通过Session创建Destination对象，即一个客户端用来指定生产者目标 和 消费者来源的 对象。 * PTP模式中：Destination被称为Queue，队列 * Pub/Sub模式中：Destination被称为Topic，主题 * 在程序中可以使用多个Queue 和 Topic */ Destination destination = session.createQueue("queue1"); //注意要和消息生产者的队列名一致！！ /** * 5.需要通过Session对象创建消息的发送或接受对象（生产者或消费者，MessageProducer/MessageConsumer） */ MessageConsumer messageConsumer = session.createConsumer(destination); /** * 7.最后，使用JMS规范的TextMessage形式创建数据（通过Session对象）， * 发送端使用MessageProducer的Send方法发送数据。 * 接受端使用receive方法接收数据。 */ while(true){ TextMessage msg = (TextMessage)messageConsumer.receive(); if(msg==null) break; System.out.println("【消费者接收】"+msg.getText()); } /** * 8.最后记得关闭Connection连接 */ if(connection!=null){ connection.close(); } } }
【Receiver运行结果：Eclipse控制台】
【Receiver运行结果：Web页面控制台】
【Receiver运行结果：点击"queue1"查看队列详情】
【重点：Connection方法使用】
在成功创建ConnectionFactory后，下一步是创建一个连接，它是JMS定义的一个接口。
ConnectionFactory负责返回Connection实现。
Connection可以与底层消息传递系统进行通信，通常客户端只使用单一连接。
根据JMS文档，Connection的目的是“利用JMS提供者封装开放的连接”，以及“客户端与提供者服务例程之间的开放TCP/IP套接字”。
Connection还应该是进行客户端身份验证的地方。
当一个Connection被创建时，它的传输默认是关闭的，必须使用start方法开启。
一个Connection可以建立一个或多个Session。
当一个程序执行完成之后，必须关闭之前创建的Connection，否则ActiveMQ不能释放资源，关闭一个Connection同样也关闭了Session、MessageProducer、MessageConsumer。
ConnectingFactory有两个创建的方法：
1.Connection createConnection();
2.Connection createConnection(String username,String password,String url);
【重点：Session方法使用】
一旦从ConnectionFactory中获得一个Connection，必须从Connection中创建一个或多个Session。
Session是一个发送或者接收消息的线程，可以使用Session创建MessageProducer、MessageConsumer 和 Message。
Session可以被事务化，也可以不被事务化。通常可通过向Connection上的创建Session方法传递一个布尔参数对其进行设置。
connection.createSession( boolean transacted , int acknowledgeMode );
transacted 使用事务标记
acknowledgeMode 签收模式
[ 结束事务有两种方法：提交、回滚。]
如果一个事务提交，消息被处理。
如果事务中有一个步骤失败，事务就回滚，这个事务中的已经被执行的动作将被撤销。
在发送消息的最后也必须要使用session.commit()方法提交事务。
[ 签收模式有三种 ]
Session.AUTO_ACKNOWLEDGE：当客户端从receiver或onMessage成功返回时，Session自动签收客户端的这条消息的收条。
Session.CLIENT_ACKNOWLEDGE：客户端通过调用消息(Message)的acknowledge方法签收消息。在这种情况下，签收发生在Session层面：签收一个已经消费的消息会自动地签收这个Session所有已消费的收条。
Session.DUPS_OK_ACKNOWLEDGE：Session不必确保对传送消息的签收，这个模式可能会引起消息的重复，但是降低了Session的开销，所以只有客户端能容忍重复的消息，才可使用。
【重点：MessageProducer】
MessageProducer是一个由Session创建的对象，用来向Destination发送消息。
void send( Destination destination , Message message );
void send( Destination destination , Message message , int deliveryMode , int priority, long timeToLive );
void send( Message message );
void send( Message message , int deliveryMode , int priority, long timeToLive );
deliveryMode：发送模式
timeToLive：消息过期时间
ActiveMQ支持两种消息传递模式：PERSISTENT（默认）、NO_PERSOSTENT两种。
如果容忍消息丢失，那么使用非持久化(NO_PESISTENT)消息可以改善性能和减少存储的开销。
priority：消息优先级
消息的优先级从0-9共10个级别，默认4。0-4是普通消息，5-9是加急消息。JMS不要求严格按照这10个优先级发送消息，但必须保证加急消息要先于普通消息到达。
timeToLive ：消息存活时间
默认情况下，消息永不会过期，如果消息在特定周期内失去意义，那么可以设置过期时间，时间为毫秒。
【重点：MessageConsumer 】
MessageConsumer是一个由Session创建的对象，用来从Destination中接收消息。
MessageConsumer createConsumer( Destionation destination ) ;
MessageConsumer createConsumer( Destionation destination , String MessageSelector ) ;
MessageConsumer createConsumer( Destionation destination , String MessageSelector , boolean noLocal) ;
MessageConsumer createConsumer( Topic topic , String name ) ;
MessageConsumer createConsumer( Topic topic , String name , String MessageSelector , boolean noLocal ) ;
MessageSelector：消息选择器
noLocal：默认为false，当设置为true时，限制消费者只能接收和自己相同的连接（Connection）所发布的消息，此标志适用于主题（Topic），不适用于队列（Queue）。
name ：标志订阅所对应的订阅名称，持久订阅时需要设置此参数。
public final SELECTOR = "JMS_TYPE "="MY_TAG1";该选择器检查了传入消息的JMS_TYPE属性，并确定了这个属性的值是否等于MY_TAG1，如果相等，则消息被消费，否则忽略该消息。（ 消息过滤可以使用 ）
【重点：Message】
JMS程序的最终目的是生产和消费的消息能被其他程序使用，JMS的Message是一个即简单又不缺乏灵活性的基本格式，允许创建不同平台上符合非JMS的程序格式的消息。
Message由以下部分组成：消息头、属性、和消息体。
BlobMessage createBlobMessage(File file);
BlobMessage createBlobMessage(InputStream in) ;
BlobMessage createBlobMessage(URL url);
BlobMessage createBlobMessage(URL url , boolean deletedByBroker);
BlobMessage createBlobMessage( );
MapMessage createBlobMessage( );
Message createBlobMessage( );
ObjectMessage createBlobMessage( );
ObjectMessage createBlobMessage( Serializable object );
TextMessage createTextMessage();
TextMessage createTextMessage( String text );
注意：我们一般会在接收端使用instanceOf方法区别数据类型。
