一、常用配置属性
以下配置文件目录均为:${activemq_home}/conf/activemq.xml
1、定期扫描清理
ActiveMQ中有一项功能:Delete Inactive Destination。可以处理 “ 没有消费者且未处理的Destination”,也就是 queue 或者 topic 在规定时间内,没有入队记录或者有效订阅,会被清理删除。
下面基于Queue的配置,Topic的配置类似。
其中属性定义:schedulePeriodForDestinationPurge - 必填。声明扫描闲置队列的周期,单位毫秒。默认值0,为不扫描。
gcInactiveDestinations - 必填。针对Destination的配置,声明Broker扫描闲置队列时,是否扫描此队列。默认值false
inactiveTimoutBeforeGC - 选填。配合gcInactiveDestinations=true时才生效。声明Destination闲置多久可以进行删除,单位毫秒。默认值60。
2、存储空间设置
其中的配置标签: memoryUsage - 表示ActiveMQ使用的内存。这个值必须大于等于destinationPolicy中设置的所有Destination的内存之和。
storeUsage - 表示持久化存储文件的大小
tempUsage - 非持久化消息的临时内存大小
3、kahadb方式的持久化的刷盘方式
其中属性定义:journalDiskSyncStrategy - 声明持久化方式,可选值always :periodic :never 。默认always
journalDiskSyncInterval - 声明数据落盘的时间间隔。单位毫秒
4、JMX配置使用
broker标签增加:
managementContext标签修改:
5、消息过期时间
其中标签及属性定义:timeStampingBrokerPlugin - 为持久化的消息设置过期时间,zeroExpirationOverride 为没有设置有效时间的消息设置过期时间。
ttlCeiling 表示过期时间上线,如果程序中设置的时间超过这个值,以此值为准。
expireMessagesPeriod - 声明扫描过期消息的时间间隔,单位毫秒。
queue=">" 、topic=">" 表示匹配所有的Destination
queue="tp_>" 、topic="tp_>" 表示匹配所有的 tp_ 开头的Destination
二、消息的持久化
ActiveMQ的消息,Queue中的消息会根据配置的不同实现持久化,Topic如果不存在持久化订阅者的话会直接丢弃消息。
持久化的配置,在${activemq_home}/conf/activemq.xml配置文件中,标签 broker内部的 persistenceAdapter 中配置持久化方案
1、kahadb
5.4版本之后默认的持久化方式。文件型的数据库存储,配置如下:
<persistenceAdapter> <!-- directory:保存数据的目录; journalMaxFileLength:保存消息的文件大小 --> <kahaDB directory="${activemq.data}/kahadb" journalMaxFileLength="16mb"/> </persistenceAdapter>
2、JDBC
ActiveMQ将消息持久化保存到数据库中,没有限定使用某一个数据库。
配置成功后,需要在数据库中建立相应的database,后续ActiveMQ启动才能正常访问。ActiveMQ正常启动后,能够自动的创建相应的数据表:
activemq_msgs - 用于存储消息的表
activemq_acks - 存储订阅关系
activemq_lock - 集群环境中使用,同一时间只能有一个Master Broker
下文配置中以MySQL为例:
2.1、定义数据源bean(与broker同级)
<bean id="mysql-ds" class="org.apache.commons.dbcp.BasicDataSource" destroy-method="close"> <property name="driverClassName" value="com.mysql.jdbc.Driver"/> <property name="url" value="jdbc:mysql://localhost/activemq?relaxAutoCommit=true"/> <property name="username" value="activemq"/> <property name="password" value="activemq"/>
<!-- 属性雷同可根据具体连接池配置 --> <property name="maxActive" value="200"/> <property name="poolPreparedStatements" value="true"/> </bean>
其中数据连接池可以任意其他产品,只需要将相应的jar包拷贝到 ${activemq_home}/lib 目录下即可。
2.2、配置 persistenceAdapter 标签
<persistenceAdapter> <!-- createTablesOnStartup标签是否启动时创建数据表,默认值为true。一般第一次启动的时候true,后续修改为false --> <jdbcPersistenceAdapter dataSource="#mysql-ds" createTablesOnStartup="false"/> </persistenceAdapter>
三、ActiveMQ的桥接模式 (network)
${activemq_home}/conf/activemq.xml 配置文件中,broker标签中,增加如下:
<networkConnectors> <networkConnectoruri="static://(tcp://ip:61616)"/> </networkConnector>
在两个ActiveMQ应用中,分别配置对方的地址信息,则两个Broker就通过一个static协议进行网络连接。一个consumer连接到Broker1上目的地A,当producer发送到Broker2上的相同目的地A的时候,消息会转发到Broker1上面供消费使用。
四、虚拟Topic(Virtual Topic)
1、Topic的两种订阅模式
以下测试。为了能够清晰的查看消息是否持久化,可以配置成JDBC方式的持久化方案,数据库查看。
消息生产者
package com.cfang.prebo.activemq.topic; import javax.jms.Connection; import javax.jms.ConnectionFactory; import javax.jms.Destination; import javax.jms.JMSException; import javax.jms.Message; import javax.jms.MessageProducer; import javax.jms.Session; import javax.jms.Topic; import javax.jms.TopicPublisher; import org.apache.activemq.ActiveMQConnectionFactory; public class Producer { private static String brokerURL = "tcp://localhost:61618"; private static ConnectionFactory connectionFactory = null; private static Connection connection = null; private static Session session = null; private static MessageProducer messageProducer = null; public static void main(String[] args) throws JMSException { connectionFactory = new ActiveMQConnectionFactory(brokerURL); connection = connectionFactory.createConnection(); connection.start(); session = connection.createSession(false, Session.AUTO_ACKNOWLEDGE); Destination destination = session.createTopic("TP_TEST_03"); messageProducer = session.createProducer(destination); Message message = session.createTextMessage("test01"); messageProducer.send(message); connection.close(); } }
1.1、普通订阅
Topic不会持久化消息,如果不存在订阅关系,则Topic会直接丢弃消息,后续再订阅也不会收到之前的任何消息。
package com.cfang.prebo.activemq.topic; import javax.jms.Connection; import javax.jms.ConnectionFactory; import javax.jms.Destination; import javax.jms.JMSException; import javax.jms.Message; import javax.jms.MessageConsumer; import javax.jms.MessageListener; import javax.jms.Session; import javax.jms.Topic; import javax.jms.TopicSubscriber; import org.apache.activemq.ActiveMQConnectionFactory; /** * @author cfang * 普通订阅 */ public class SimpleSubscribe { private static String brokerURL = "tcp://localhost:61618"; private static ConnectionFactory connectionFactory = null; private static Connection connection = null; private static Session session = null; public static void main(String[] args) throws JMSException { connectionFactory = new ActiveMQConnectionFactory(brokerURL); connection = connectionFactory.createConnection(); connection.start(); session = connection.createSession(false, Session.AUTO_ACKNOWLEDGE); Destination topic = session.createTopic("TP_TEST_03"); MessageConsumer consumer = session.createConsumer(topic); consumer.setMessageListener(new MessageListener() { public void onMessage(Message message) { System.out.println(message); } }); } }
生产者发送消息,数据库不保存:
1.2、持久化订阅
持久化订阅者一定得预先加载一次,也就是向broker注册这个消费订阅者。之后,无论订阅者是否在线,最终都会收到消息。不在线的话,等到再次连接的时候,会将没有受过的消息全部接收处理。
package com.cfang.prebo.activemq.topic; import javax.jms.Connection; import javax.jms.ConnectionFactory; import javax.jms.JMSException; import javax.jms.Message; import javax.jms.MessageListener; import javax.jms.Session; import javax.jms.Topic; import javax.jms.TopicSubscriber; import org.apache.activemq.ActiveMQConnectionFactory; /** * @author cfang * 持久订阅 */ public class DurableSubscribe { private static String brokerURL = "tcp://localhost:61618"; private static ConnectionFactory connectionFactory = null; private static Connection connection = null; private static Session session = null; public static void main(String[] args) throws JMSException { connectionFactory = new ActiveMQConnectionFactory(brokerURL); connection = connectionFactory.createConnection(); connection.setClientID("test01"); connection.start(); session = connection.createSession(false, Session.AUTO_ACKNOWLEDGE); Topic topic = session.createTopic("TP_TEST_03"); TopicSubscriber consumer = session.createDurableSubscriber(topic, "Test-subscriber"); consumer.setMessageListener(new MessageListener() { public void onMessage(Message message) { System.out.println(message); } }); } }
运行上面订阅程序,然后关闭程序,订阅关系会保存到表 activemq_acks 中:
发送消息,会持久化到表 activemq_msgs中,消息会在持久化订阅者在线的时候供消费使用:
1.3、离线的持久订阅的清理
上述配置说明:broker每小时检查并删除离线1天以上的持久订阅者。
其中标签、属性定义: offlineDurableSubscriberTimeout - 删除的离线的持久订阅者时间,单位毫秒,默认 -1
offlineDurableSubscriberTaskSchedule - 声明扫描时间间隔,单位毫秒。
2、虚拟Topic的应用
Virtual Topic,对生产者来说是个topic,对消费者来说是个queue。内部处理机制是由Broker将接收到的消息进行二次分发到每个queue,然后不同的queue对应不同的应用实现持久化,不同的消费端只需要关注自己的queue就可以了。这样,对每个queue可以做应用内可以做failover处理,也可达到了对topic的多consumer共同处理。
下面是简单的代码测试
package com.cfang.prebo.activemq.topic; import javax.jms.Connection; import javax.jms.ConnectionFactory; import javax.jms.DeliveryMode; import javax.jms.Destination; import javax.jms.JMSException; import javax.jms.Message; import javax.jms.MessageProducer; import javax.jms.Session; import javax.jms.TextMessage; import org.apache.activemq.ActiveMQConnectionFactory; /** * VirtualTopic生产者 */ public class VirtualProducer { public static void main(String[] args) throws JMSException { ConnectionFactory factory = new ActiveMQConnectionFactory("tcp://localhost:61618"); Connection connection = factory.createConnection(); connection.start(); Session session = connection.createSession(false, Session.AUTO_ACKNOWLEDGE); Destination destination = session.createTopic("VirtualTopic.TP"); MessageProducer producer = session.createProducer(destination); producer.setDeliveryMode(DeliveryMode.PERSISTENT); Message message = session.createTextMessage("hello world"); message.setStringProperty("keys", "value-bak"); producer.send(message); session.close(); connection.close(); } }
package com.cfang.prebo.activemq.topic; import javax.jms.Connection; import javax.jms.ConnectionFactory; import javax.jms.Destination; import javax.jms.JMSException; import javax.jms.Message; import javax.jms.MessageConsumer; import javax.jms.MessageListener; import javax.jms.Session; import org.apache.activemq.ActiveMQConnectionFactory; /** * VirtualTopic 消费端 * */ public class VirtualConsumer { public static void main(String[] args) throws Exception { ConnectionFactory factory = new ActiveMQConnectionFactory("tcp://localhost:61618"); Connection connection = factory.createConnection(); connection.start(); Session session = connection.createSession(false, Session.AUTO_ACKNOWLEDGE); Destination destinationA = session.createQueue("Consumer.A.VirtualTopic.TP"); Destination destinationB = session.createQueue("Consumer.B.VirtualTopic.TP"); MessageConsumer consumerA1 = session.createConsumer(destinationA); consumerA1.setMessageListener(new MessageListener() { public void onMessage(Message message) { System.out.println("A1:"+message); } }); MessageConsumer consumerA2 = session.createConsumer(destinationA); consumerA2.setMessageListener(new MessageListener() { public void onMessage(Message message) { System.out.println("A2:"+message); } }); MessageConsumer consumerB = session.createConsumer(destinationB); consumerB.setMessageListener(new MessageListener() { public void onMessage(Message message) { System.out.println("B:"+message); } }); System.in.read(); } }
其中,消费端的A1和A2为一个应用,组成内部负载和failover。
VirtualTopic的消费端queue名称的前后缀可通过配置文件${activemq_home}/conf/activemq.xml修改,一般也不需要修改前后缀,极少应用
在 broker标签中,加入以下内容,则前缀就修改成了VT,之前例子中的消费端,监听的queue名称就改为 “VT.A.VirtualTopic.TP” 和 “VT.B.VirtualTopic.TP”
selectorAware 属性表明 consumer 有selector 的话,则对消息进行过滤,只有符合selector的消息才会分发到queue中。
<destinationInterceptors> <virtualDestinationInterceptor> <virtualDestinations> <virtualTopic name=">" prefix="VT.*." selectorAware="false"/> </virtualDestinations> </virtualDestinationInterceptor> </destinationInterceptors>
总结点VirtualTopic:
1、虚拟Topic是一种特殊命名的Topic,系统根据命名规则将该Topic内的消息分发给当前存在的名称对应的Queue,分发是非持久化的,新加入的Queue是接收不到过去的消息的。
2、虚拟Topic的功能完全是中间件本身额外附加的机制,对于生产者和消费者都是无感知的。