1 JMS
在介绍ActiveMQ之前,首先简要介绍一下JMS规范。
1.1 JMS的基本构件
1.1.1 连接工厂
连接工厂是客户用来创建连接的对象,例如ActiveMQ提供的ActiveMQConnectionFactory。
ConnectionFactory connectionFactory = new ActiveMQConnectionFactory(username ,password ,brokerUrl);
1.1.2 连接
JMS Connection封装了客户与JMS提供者之间的一个虚拟的连接。
Connection conn = connectionFactory.createConnection();
1.1.3 会话
JMS Session是生产和消费消息的一个单线程上下文。会话用于创建消息生产者(producer)、消息消费者(consumer)和消息(message)等。会话提供了一个事务性的上下文,在这个上下文中,一组发送和接收被组合到了一个原子操作中。
Session session = conn.createSession(Boolean.FALSE, Session.AUTO_ACKNOWLEDGE);
1.1.4 目的地
目的地是客户用来指定它生产的消息的目标和它消费的消息的来源的对象。JMS1.0.2规范中定义了两种消息传递域:
点对点(PTP)消息传递域和发布/订阅消息传递域。
点对点消息传递域的特点如下: • 每个消息只能有一个消费者。 • 消息的生产者和消费者之间没有时间上的相关性。无论消费者在生产者发送消息的时候是否处于运行状态,它都可以提取消息。 发布/订阅消息传递域的特点如下: • 每个消息可以有多个消费者。 • 生产者和消费者之间有时间上的相关性。订阅一个主题的消费者只能消费自它订阅之后发布的消息。JMS规范允许客户创建持久订阅,这在一定程度上放松了时间上的相关性要求。持久订阅允许消费者消费它在未处于激活状态时发送的消息。 在点对点消息传递域中,目的地被成为队列(queue);在发布/订阅消息传递域中,目的地被成为主题(topic)。
Topic topic = session.createTopic(topicId);
Queue queue = session.createQueue(queueId);
1.1.5 消息生产者
消息生产者是由会话创建的一个对象,用于把消息发送到一个目的地。
MessageProducer producer = session.createProducer(topic);
MessageProducer producer = session.createProducer(queueId);
1.1.6 消息消费者
消息消费者是由会话创建的一个对象,它用于接收发送到目的地的消息。消息的消费可以采用以下两种方法之一: • 同步消费。通过调用消费者的receive方法从目的地中显式提取消息。receive方法可以一直阻塞到消息到达。 • 异步消费。客户可以为消费者注册一个消息监听器,以定义在消息到达时所采取的动作。
MessageConsumer consumer = session.createComsumer(topic);
MessageConsumer consumer = session.createComsumer(queueId);
1.1.7 消息
JMS消息由以下三部分组成的: • 消息头。每个消息头字段都有相应的getter和setter方法。 • 消息属性。如果需要除消息头字段以外的值,那么可以使用消息属性。 • 消息体。JMS定义的消息类型有TextMessage、MapMessage、BytesMessage、StreamMessage和ObjectMessage。
session.createTextMessage(msg)
1.2 JMS的可靠性机制
1.2.1 确认 JMS消息
只有在被确认之后,才认为已经被成功地消费了。消息的成功消费通常包含三个阶段:客户接收消息、客户处理消息和消息被确认。
在事务性会话中,当一个事务被提交的时候,确认自动发生。
在非事务性会话中,消息何时被确认取决于创建会话时的应答模式(acknowledgement mode)。该参数有以下三个可选值: • Session.AUTO_ACKNOWLEDGE。自动应答。当客户成功的从receive方法返回的时候,或者从MessageListener.onMessage方法成功返回的时候,会话自动确认客户收到的消息。 • Session.CLIENT_ACKNOWLEDGE。手动应答。客户通过消息的acknowledge方法确认消息。需要注意的是,在这种模式中,确认是在会话层上进行:确认一个被消费的消息将自动确认所有已被会话消费的消息。例如,如果一个消息消费者消费了10个消息,然后确认第5个消息,那么所有10个消息都被确认。 • Session.DUPS_ACKNOWLEDGE。该选择只是会话迟钝的确认消息的提交。如果JMS Provider失败,那么可能会导致一些重复的消息。如果是重复的消息,那么JMS Provider必须把消息头的JMSRedelivered字段设置为true。
1.2.2 持久性
JMS 支持以下两种消息提交模式: • PERSISTENT。存储在某种持久化介质上,可支持的持久化介质有:KahaBD、AMQ和关系型数据 • NON_PERSISTENT。只存储在JMS服务节点的内存区域,不会存储在某种持久化介质上,下次开启mq的时候之前存储的数据不再存在。
1.2.3 优先级
可以使用消息优先级来指示JMS Provider首先提交紧急的消息。优先级分10个级别,从0(最低)到9(最高)。如果不指定优先级,默认级别是4。需要注意的是,JMS Provider并不一定保证按照优先级的顺序提交消息。
1.2.4 消息过期
可以设置消息在一定时间后过期,默认是永不过期。
1.2.5 临时目的地
可以通过会话上的createTemporaryQueue方法和createTemporaryTopic方法来创建临时目的地。它们的存在时间只限于创建它们的连接所保持的时间。只有创建该临时目的地的连接上的消息消费者才能够从临时目的地中提取消息。
1.2.6 持久订阅
首先消息生产者必须使用PERSISTENT提交消息。客户可以通过会话上的createDurableSubscriber方法来创建一个持久订阅,该方法的第一个参数必须是一个topic,第二个参数是订阅的名称。 JMS Provider会存储发布到持久订阅对应的topic上的消息。如果最初创建持久订阅的客户或者任何其它客户使用相同的连接工厂和连接的客户ID、相同的主题和相同的订阅名再次调用会话上的createDurableSubscriber方法,那么该持久订阅就会被激活。JMS Provider会向客户发送客户处于非激活状态时所发布的消息。 持久订阅在某个时刻只能有一个激活的订阅者。持久订阅在创建之后会一直保留,直到应用程序调用会话上的unsubscribe方法。
1.2.7 本地事务
在一个JMS客户端,可以使用本地事务来组合消息的发送和接收。JMS Session接口提供了commit和rollback方法。事务提交意味着生产的所有消息被发送,消费的所有消息被确认;事务回滚意味着生产的所有消息被销毁,消费的所有消息被恢复并重新提交,除非它们已经过期。 事务性的会话总是牵涉到事务处理中,commit或rollback方法一旦被调用,一个事务就结束了,而另一个事务被开始。关闭事务性会话将回滚其中的事务。 需要注意的是,如果使用请求/回复机制,即发送一个消息,同时希望在同一个事务中等待接收该消息的回复,那么程序将被挂起,因为知道事务提交,发送操作才会真正执行。 需要注意的还有一个,消息的生产和消费不能包含在同一个事务中。
2.ActiveMQ
2.1 创建producer
@Slf4j
@Component
public class Producer {
@Value("${Mq.topicId}")
private String topicId;
@Value("${Mq.brokerURL}")
private String brokerUrl;
@Value("${Mq.username}")
private String username;
@Value("${Mq.password}")
private String password;
private MessageProducer producer;// 消息生产者
private Connection conn;// 消息连接
private Session session;//事务管理
private Topic topic;//发布订阅模式
public void producerSendMsg(String msg){
ThreadPoolUtil.getPool().execute(() -> {
initMQ();
});
}
/**
* 初始化消息队列
*/
private void initMQ() {
try {
/**
* 创建ConnectionFactory对象,指定服务端ip及端口号。
*/
ConnectionFactory connectionFactory = new ActiveMQConnectionFactory(username ,password ,brokerUrl);
/**
* 使用ConnectionFactory对象创建一个Connection对象。
* 开启连接,调用Connection对象的start方法。
*/
conn = connectionFactory.createConnection();
if (conn instanceof ActiveMQConnection) {
ActiveMQConnection amc = (ActiveMQConnection) conn;
//异步转发,默认true
amc.setDispatchAsync(true);
//关闭消息的复制功能
amc.setCopyMessageOnSend(false);
}
conn.start();
/**
* 使用Connection对象创建一个Session对象。
* 第一个参数:是否开启事务。true:开启事务,第二个参数忽略。
* 第二个参数:当第一个参数为false时,才有意义。消息的应答模式。1、自动应答2、手动应答。一般是自动应答。
*/
session = conn.createSession(Boolean.FALSE, Session.AUTO_ACKNOWLEDGE);
/**
* 使用Session对象创建一个Destination对象(topic、queue)
* 发布-订阅模式下,需要订阅者先订阅该主题
*/
topic = session.createTopic(topicId);
/**
* 使用Session对象创建一个Producer对象。
*/
producer = session.createProducer(topic);
/**
* 是否进行持久化存储
* NON_PERSISTENT 只存储在JMS服务节点的内存区域,不会存储在某种持久化介质上,下次开启mq的时候之前存储的数据不再存在。
* PERSISTENT 存储在某种持久化介质上,可支持的持久化介质有:KahaBD、AMQ和关系型数据
*/
producer.setDeliveryMode(DeliveryMode.NON_PERSISTENT);
/**
* 为所有的消息设置过期时间,默认是永不过期。
* 如果 timeToLive 值等于零,则 JMSExpiration 被设为零, 表示该消息永不过期。
*/
// producer.setTimeToLive(1000);
/**
* 通过session对象使用JMS规范的TextMessage形式创建数据
* 并通过producer的send方法发送数据
* 或者 MessageProducer.send(message, deliveryMode, priority, timeToLive);
*/
String msg = "";
producer.send(session.createTextMessage(msg));
}catch (JMSException e) {
log.error("ActiveMq初始化异常",e);
}finally {
/**
* 关闭连接
* 内部递归关闭
*/
if(conn != null){
try {
conn.close();
} catch (JMSException e) {
log.error("连接关闭异常",e);
}
}
}
}
}
2.2 创建consumer
@Slf4j
@Component
public class Consumer implements MessageListener{
@Value("${Mq.topicId}")
private String topicId;
@Value("${Mq.brokerURL}")
private String brokerUrl;
@Value("${Mq.username}")
private String username;
@Value("${Mq.password}")
private String password;
private MessageConsumer consumer;//消息消费者
private Connection conn;// 消息连接
private Session session;//事务管理
private Topic topic;//发布订阅模式
@PostConstruct
public void initMQ() {
try {
ConnectionFactory connectionFactory = new ActiveMQConnectionFactory(username ,password ,brokerUrl);
conn = connectionFactory.createConnection();
conn.start();
session = conn.createSession(Boolean.FALSE, Session.AUTO_ACKNOWLEDGE);
topic = session.createTopic(topicId);
consumer = session.createConsumer(topic);
consumer.setMessageListener(this);
log.info("启动消费者");
} catch (JMSException e) {
log.error("ActiveMq初始化异常",e);
}
}
/**
* 通过注册MessageListener异步接收消息
* @param message
*/
@Override
public void onMessage(Message message) {
if(message instanceof TextMessage) {
try {
log.info("消费者取出消息并消费:{}",((TextMessage) message).getText());
/**
* 处理逻辑
*/
} catch (JMSException e) {
e.printStackTrace();
}
}
}
}
2.3 安全机制Simple Authentication Plugin
Simple Authentication Plugin适用于简单的认证需求,或者用于建立测试环境。它允许在XML配置文件中指定用户、用户组和密码等信息。
<plugins>
<simpleAuthenticationPlugin>
<users>
<authenticationUser username="admin" password="admin" groups="users,admins"/>
</users>
</simpleAuthenticationPlugin>
</plugins>