消息持久性对于可靠消息传递来说应该是一种比较好的方法，有了消息持久化，即使发送者和接受者不是同时在线或者消息中心在发送者发送消息后宕机了，在消息 中心重新启动后仍然可以将消息发送出去，如果把这种持久化和ReliableMessaging结合起来应该是很好的保证了消息的可靠传送。

消息持久性的原理很简单，就是在发送者将消息发送出去后，消息中心首先将消息存储到本地数据文件、内存数据库或者远程数据库等，然后试图将消息发送 给接收者，发送成功则将消息从存储中删除，失败则继续尝试。消息中心启动以后首先要检查制定的存储位置，如果有未发送成功的消息，则需要把消息发送出去。

ActiveMQ持久化方式：AMQ、KahaDB、JDBC、LevelDB。

AMQ

AMQ是一种文件存储形式，它具有写入速度快和容易恢复的特点。消息存储在一个个文件中，文件的默认大小为32M，如果一条消息的大小超过了 32M，那么这个值必须设置大一点。当一个存储文件中的消息已经全部被消费，那么这个文件将被标识为可删除，在下一个清除阶段，这个文件被删除。AMQ适用于ActiveMQ5.3之前的版本。默认配置如下：

  1. <persistenceAdapter>
  2.    <amqPersistenceAdapter directory="activemq-data"maxFileLength="32mb"/>
  3. </persistenceAdapter>

属性如下：

属性名称 默认值 描述
directory activemq-data 消息文件和日志的存储目录
useNIO true 使用NIO协议存储消息
syncOnWrite false 同步写到磁盘，这个选项对性能影响非常大
maxFileLength 32Mb 一个消息文件的大小
persistentIndex true 消息索引的持久化，如果为false，那么索引保存在内存中
maxCheckpointMessageAddSize 4kb 一个事务允许的最大消息量
cleanupInterval 30000 清除操作周期，单位ms
indexBinSize 1024 索引文件缓存页面数，缺省为1024，当amq扩充或者缩减存储时，会锁定整个broker，导致一定时间的阻塞，所以这个值应该调整到比较大，但是代码中实现会动态伸缩，调整效果并不理想。
indexKeySize 96 索引key的大小，key是消息ID
indexPageSize 16kb 索引的页大小
directoryArchive archive 存储被归档的消息文件目录
archiveDataLogs false 当为true时，归档的消息文件被移到directoryArchive,而不是直接删除

KahaDB

KahaDB是基于文件的本地数据库储存形式，虽然没有AMQ的速度快，但是它具有强扩展性，恢复的时间比AMQ短，从5.4版本之后KahaDB做为默认的持久化方式。默认配置如下：

KahaDB的属性如下：

属性名称 默认值 描述
directory activemq-data 消息文件和日志的存储目录
indexWriteBatchSize 1000 一批索引的大小，当要更新的索引量到达这个值时，更新到消息文件中
indexCacheSize 10000 内存中，索引的页大小
enableIndexWriteAsync false 索引是否异步写到消息文件中
journalMaxFileLength 32mb 一个消息文件的大小
enableJournalDiskSyncs true 是否讲非事务的消息同步写入到磁盘
cleanupInterval 30000 清除操作周期，单位ms
checkpointInterval 5000 索引写入到消息文件的周期，单位ms
ignoreMissingJournalfiles false 忽略丢失的消息文件，false，当丢失了消息文件，启动异常
checkForCorruptJournalFiles false 检查消息文件是否损坏，true，检查发现损坏会尝试修复
checksumJournalFiles false 产生一个checksum，以便能够检测journal文件是否损坏。
5.4版本之后有效的属性:

archiveDataLogs		 false 当为true时，归档的消息文件被移到directoryArchive,而不是直接删除
directoryArchive null 存储被归档的消息文件目录
databaseLockedWaitDelay 10000 在使用负载时，等待获得文件锁的延迟时间，单位ms
maxAsyncJobs 10000 同个生产者产生等待写入的异步消息最大量
concurrentStoreAndDispatchTopics false 当写入消息的时候，是否转发主题消息
concurrentStoreAndDispatchQueues true 当写入消息的时候，是否转发队列消息
5.6版本之后有效的属性:

archiveCorruptedIndex		 false 是否归档错误的索引

每个KahaDB的实例都可以配置单独的适配器，如果没有目标队列提交给filteredKahaDB，那么意味着对所有的队列有效。如果一个队列没有对应的适配器，那么将会抛出一个异常。配置如下：

  1. <persistenceAdapter>
  2.   <mKahaDBdirectory="${activemq.base}/data/kahadb">
  3.     <filteredPersistenceAdapters>
  4.       <!-- match all queues -->
  5.       <filteredKahaDBqueue=">">
  6.         <persistenceAdapter>
  7.           <kahaDBjournalMaxFileLength="32mb"/>
  8.         </persistenceAdapter>
  9.       </filteredKahaDB>
  11.       <!-- match all destinations -->
  12.       <filteredKahaDB>
  13.         <persistenceAdapter>
  14.           <kahaDBenableJournalDiskSyncs="false"/>
  15.         </persistenceAdapter>
  16.       </filteredKahaDB>
  17.     </filteredPersistenceAdapters>
  18.   </mKahaDB>
  19. </persistenceAdapter>

如果filteredKahaDB的perDestination属性设置为true，那么匹配的目标队列将会得到自己对应的KahaDB实例。配置如下：

  1. <persistenceAdapter>
  2.   <mKahaDBdirectory="${activemq.base}/data/kahadb">
  3.     <filteredPersistenceAdapters>
  4.       <!-- kahaDB per destinations -->
  5.       <filteredKahaDB perDestination="true">
  6.         <persistenceAdapter>
  7.           <kahaDBjournalMaxFileLength="32mb" />
  8.         </persistenceAdapter>
  9.       </filteredKahaDB>
  10.     </filteredPersistenceAdapters>
  11.   </mKahaDB>
  12. </persistenceAdapter>

JDBC

可以将消息存储到数据库中，例如：Mysql、SQL Server、Oracle、DB2。

配置JDBC适配器：

  1. <persistenceAdapter>
  2.     <jdbcPersistenceAdapterdataSource="#mysql-ds" createTablesOnStartup="false" />
  3. </persistenceAdapter>

dataSource指定持久化数据库的bean，createTablesOnStartup是否在启动的时候创建数据表，默认值是true，这样每次启动都会去创建数据表了，一般是第一次启动的时候设置为true，之后改成false。

  1. Mysql持久化bean：
  2. <bean id="mysql-ds" class="org.apache.commons.dbcp.BasicDataSource" destroy-method="close">
  3.     <property name="driverClassName" value="com.mysql.jdbc.Driver"/>
  4.     <property name="url" value="jdbc:mysql://localhost/activemq?relaxAutoCommit=true"/>
  5.     <property name="username" value="activemq"/>
  6.     <property name="password" value="activemq"/>
  7.     <property name="poolPreparedStatements" value="true"/>
  8. </bean>
  9. SQL Server持久化bean：
  10. <bean id="mssql-ds" class="net.sourceforge.jtds.jdbcx.JtdsDataSource" destroy-method="close">
  11.    <property name="serverName" value="SERVERNAME"/>
  12.    <property name="portNumber" value="PORTNUMBER"/>
  13.    <property name="databaseName" value="DATABASENAME"/>
  14.    <property name="user" value="USER"/>
  15.    <property name="password" value="PASSWORD"/>
  16. </bean>
  17. Oracle持久化bean：
  18. <bean id="oracle-ds" class="org.apache.commons.dbcp.BasicDataSource" destroy-method="close">
  19.     <property name="driverClassName" value="oracle.jdbc.driver.OracleDriver"/>
  20.     <property name="url" value="jdbc:oracle:thin:@10.53.132.47:1521:activemq"/>
  21.     <property name="username" value="activemq"/>
  22.     <property name="password" value="activemq"/>
  23.     <property name="maxActive" value="200"/>
  24.     <property name="poolPreparedStatements" value="true"/>
  25. </bean>
  26. DB2持久化bean：
  27. <bean id="db2-ds" class="org.apache.commons.dbcp.BasicDataSource"  destroy-method="close">
  28.       <property name="driverClassName" value="com.ibm.db2.jcc.DB2Driver"/>
  29.       <property name="url" value="jdbc:db2://hndb02.bf.ctc.com:50002/activemq"/>
  30.       <property name="username" value="activemq"/>
  31.       <property name="password" value="activemq"/>
  32.       <property name="maxActive" value="200"/>
  33.       <property name="poolPreparedStatements" value="true"/>
  34.   </bean>

LevelDB

这种文件系统是从ActiveMQ5.8之后引进的，它和KahaDB非常相似，也是基于文件的本地数据库储存形式，但是它 提供比KahaDB更快的持久性。与KahaDB不同的是，它不是使用传统的B-树来实现对日志数据的提前写，而是使用基于索引的LevelDB。

默认配置如下：

  1. < persistenceAdapter >
  2.        <levelDBdirectory = "activemq-data" />
  3. </ persistenceAdapter >

属性如下：

属性名称 默认值 描述
directory “LevelDB” 数据文件的存储目录
readThreads 10 系统允许的并发读线程数量
sync true 同步写到磁盘
logSize 104857600 (100 MB) 日志文件大小的最大值
logWriteBufferSize 4194304 (4 MB) 日志数据写入文件系统的最大缓存值
verifyChecksums false 是否对从文件系统中读取的数据进行校验
paranoidChecks false 尽快对系统内部发生的存储错误进行标记
indexFactory org.fusesource.leveldbjni.JniDBFactory, org.iq80.leveldb.impl.Iq80DBFactory 在创建LevelDB索引时使用
indexMaxOpenFiles 1000 可供索引使用的打开文件的数量
indexBlockRestartInterval 16 Number keys between restart points for delta encoding of keys.
indexWriteBufferSize 6291456 (6 MB) 内存中索引数据的最大值
indexBlockSize 4096 (4 K) 每个数据块的索引数据大小
indexCacheSize 268435456 (256 MB) 使用缓存索引块允许的最大内存
indexCompression snappy 适用于索引块的压缩类型
logCompression none 适用于日志记录的压缩类型

持久化到Mysql数据库

Ø 需要将mysql的驱动包放置到ActiveMQ的lib目录下
Ø 修改activeMQ的配置文件：

  1. <persistenceAdapter>
  2.     <jdbcPersistenceAdapter dataDirectory = "${activemq.base}/data" dataSource = "#mysql-ds"createTablesOnStartup = "false" />
  3. </persistenceAdapter>

在配置文件中的broker节点外增加:

  1. < beanid = "mysql-ds" class = "org.apache.commons.dbcp.BasicDataSource" destroy-method = "close" >
  2.        < propertyname = "driverClassName" value = "com.mysql.jdbc.Driver" />
  3.        < property name = "url" value =
  4. "jdbc:mysql://localhost:3306/activemq?relaxAutoCommit=true" />
  5.        < property name = "username" value = "root" />
  6.        < property name = "password" value = "root" />
  7.        < property name = "maxActive" value = "200" />
  8.        < propertyname = "poolPreparedStatements" value = "true" />
  9. </ bean >

从配置中可以看出数据库的名称是activemq，需要手动在MySql中建立这个数据库。

然后重新启动activeMQ，会发现activemq多了三张表：

1：activemq_acks
2：activemq_lock
3：activemq_msgs

点到点类型

Sender类：

  1. import javax.jms.Connection;
  2. import javax.jms.ConnectionFactory;
  3. import javax.jms.DeliveryMode;
  4. import javax.jms.Destination;
  5. import javax.jms.JMSException;
  6. import javax.jms.MessageProducer;
  7. import javax.jms.Session;
  8. import javax.jms.TextMessage;
  9. import org.apache.activemq.ActiveMQConnection;
  10. import org.apache.activemq.ActiveMQConnectionFactory;
  11. public class Sender {
  12. private static final int SEND_NUMBER = 2000 ;
  13.      public static void main(String[] args) {
  14.         // ConnectionFactory ：连接工厂，JMS用它创建连接
  15.         ConnectionFactory connectionFactory;
  16.         // Connection ：JMS客户端到JMS Provider的连接
  17.         Connection connection = null ;
  18.          // Session：一个发送或接收消息的线程
  19.         Session session;
  20.         // Destination ：消息的目的地;消息发送给谁.
  21.         Destination destination;
  22.         // MessageProducer：消息发送者
  23.         MessageProducer producer;
  24.          // TextMessage message;
  25.          // 构造ConnectionFactory实例对象，此处采用ActiveMq的实现
  26.         connectionFactory = new ActiveMQConnectionFactory(
  27.                ActiveMQConnection.DEFAULT_USER,
  28.                ActiveMQConnection.DEFAULT_PASSWORD,
  29.                "tcp://localhost:61616" );
  30.         try {
  31.             // 构造从工厂得到连接对象
  32.             connection = connectionFactory.createConnection();
  33.             //启动
  34.             connection.start();
  35.             //获取操作连接
  36.             session = connection.createSession( false , Session.AUTO_ACKNOWLEDGE);
  38. //获取session，FirstQueue是一个服务器的queue                destination = session.createQueue("FirstQueue");
  39.             // 得到消息生成者【发送者】
  40.             producer = session.createProducer(destination);
  41.             //设置不持久化
  43. producer.setDeliveryMode(DeliveryMode.NON_PERSISTENT);
  44.             //构造消息
  45.             sendMessage(session, producer);
  46.             //session.commit();
  47.             connection.close();
  48.         }
  49.         catch (Exception e){
  50.             e.printStackTrace();
  51.         } finally {
  52.             if ( null != connection){
  53.                try {
  54.                    connection.close();
  55.                } catch (JMSException e) {
  56.                    // TODO Auto-generatedcatch block
  57.                    e.printStackTrace();
  58.                }
  59.             }   
  60.         }
  61.      }
  62.      public static void
  63. sendMessage(Session session, MessageProducer producer) throws Exception{
  64.         for ( int i= 1 ; i<=SEND_NUMBER; i++){
  65.             TextMessage message = session.createTextMessage( "ActiveMQ发送消息" +i);
  66.             System.out.println( "发送消息：ActiveMQ发送的消息" +i);
  67.             producer.send(message);
  68.         }
  69.      }
  70. }

Receiver类：

  1. import javax.jms.Connection;
  2. import javax.jms.ConnectionFactory;
  3. import javax.jms.Destination;
  4. import javax.jms.MessageConsumer;
  5. import javax.jms.Session;
  6. import javax.jms.TextMessage;
  7. import org.apache.activemq.ActiveMQConnection;
  8. import org.apache.activemq.ActiveMQConnectionFactory;
  9. public class Receiver {
  10.      public static void main(String[] args) {
  11.         // ConnectionFactory ：连接工厂，JMS用它创建连接
  12.          ConnectionFactory connectionFactory;
  13.          // Connection ：JMS客户端到JMS Provider的连接
  14.          Connection connection = null ;
  15.          // Session：一个发送或接收消息的线程
  16.          Session session;
  17.          // Destination ：消息的目的地;消息发送给谁.
  18.          Destination destination;
  19.          // 消费者，消息接收者
  20.          MessageConsumer consumer;
  21.          connectionFactory = newActiveMQConnectionFactory(
  22.                  ActiveMQConnection.DEFAULT_USER,
  23.                  ActiveMQConnection.DEFAULT_PASSWORD,
  24.                  "tcp://localhost:61616" );
  25.          try {
  26.              //得到连接对象
  27.              connection =connectionFactory.createConnection();
  28.              // 启动
  29.              connection.start();
  30.              // 获取操作连接
  31.              session = connection.createSession( false ,
  32.                      Session.AUTO_ACKNOWLEDGE);
  33.              // 创建Queue
  34.             destination = session.createQueue( "FirstQueue" );
  36. consumer =session.createConsumer(destination);       
  37.              while ( true ){
  38.                //设置接收者接收消息的时间，为了便于测试，这里定为100s
  40. TextMessagemessage = (TextMessage)consumer.receive( 100000 );
  41.                if ( null != message){
  42.                   System.out.println( "收到消息" +message.getText());
  43.                } else break ;
  44.              }
  45.          } catch (Exception e){
  46.          e.printStackTrace();
  47.          } finally {
  48.              try {
  49.                  if ( null != connection)
  50.                      connection.close();
  51.              } catch (Throwable ignore) {
  52.              }
  53.          }
  54.      }
  55. }

测试

测试一：

A、 先运行Sender类，待运行完毕后，运行Receiver类
B、 在此过程中activemq数据库的activemq_msgs表中没有数据
C、 再次运行Receiver，消费不到任何信息

测试二：

A、 先运行Sender类
B、 重启电脑
C、 运行Receiver类，无任何信息被消费

测试三：

A、 把Sender类中的producer.setDeliveryMode(DeliveryMode.NON_PERSISTENT);改为producer.setDeliveryMode(DeliveryMode.PERSISTENT);
B、 先运行Sender类，待运行完毕后，运行Receiver类
C、 在此过程中activemq数据库的activemq_msgs表中有数据生成，运行完Receiver类后，数据清除

测试四：

A、 把Sender类中的producer.setDeliveryMode(DeliveryMode.NON_PERSISTENT);改producer.setDeliveryMode(DeliveryMode.PERSISTENT);
B、 运行Sender类
C、 重启电脑
D、 运行Receiver类，有消息被消费

结论

通过以上测试，可以发现，在P2P类型中当DeliveryMode设置为NON_PERSISTENCE时，消息被保存在内存中，而当 DeliveryMode设置为PERSISTENCE时，消息保存在broker的相应的文件或者数据库中。而且P2P中消息一旦被Consumer消 费就从broker中删除。

发布/订阅类型

Sender类：

  1. import javax.jms.Connection;
  2. import javax.jms.ConnectionFactory;
  3. import javax.jms.DeliveryMode;
  4. import javax.jms.Destination;
  5. import javax.jms.JMSException;
  6. import javax.jms.MessageProducer;
  7. import javax.jms.Session;
  8. import javax.jms.TextMessage;
  9. import javax.jms.Topic;
  10. import org.apache.activemq.ActiveMQConnection;
  11. import org.apache.activemq.ActiveMQConnectionFactory;
  12. public class Sender {
  13.      private static final int SEND_NUMBER = 100 ;
  14.      public static void main(String[] args) {
  15.         // ConnectionFactory ：连接工厂，JMS用它创建连接
  16.         ConnectionFactory connectionFactory;
  17.         // Connection ：JMS客户端到JMS Provider的连接
  18.         Connection connection = null ;
  19.          // Session：一个发送或接收消息的线程
  20.         Session session;
  21.         // MessageProducer：消息发送者
  22.         MessageProducer producer;
  23.          // TextMessage message;
  24.          // 构造ConnectionFactory实例对象，此处采用ActiveMq的实现
  25.         connectionFactory = new ActiveMQConnectionFactory(
  26.                ActiveMQConnection.DEFAULT_USER,
  27.                 ActiveMQConnection.DEFAULT_PASSWORD,
  28.                "tcp://localhost:61616" );
  29.         try {
  30.             //得到连接对象
  31.             connection = connectionFactory.createConnection();
  32.             //启动
  33.             connection.start();
  34.             //获取操作连接
  35.             session = connection.createSession( false , Session.AUTO_ACKNOWLEDGE);       
  36.             Topic topic = session.createTopic( "MQ_test" );      
  37.             // 得到消息生成者【发送者】
  38.             producer = session.createProducer(topic);
  39.             //设置持久化
  40.             producer.setDeliveryMode(DeliveryMode.PERSISTENT);
  41.             //构造消息
  42.             sendMessage(session, producer);
  43.             //session.commit();
  44.             connection.close();
  45.         }
  46.         catch (Exception e){
  47.             e.printStackTrace();
  48.         } finally {
  49.             if ( null != connection){
  50.                try {
  51.                    connection.close();
  52.                } catch (JMSException e) {
  53.                    // TODO Auto-generatedcatch block
  54.                    e.printStackTrace();
  55.                }
  56.             }   
  57.         }
  58.      }
  59.      public static void
  60. sendMessage(Session session, MessageProducer producer) throws Exception{
  61.         for ( int i= 1 ; i<=SEND_NUMBER; i++){
  62.             TextMessage message = session.createTextMessage( "ActiveMQ发送消息" +i);
  63.             System.out.println( "发送消息：ActiveMQ发送的消息" +i);
  64.             producer.send(message);
  65.         }
  66.      }
  67. }

Receiver类：

  1. import javax.jms.Connection;
  2. import javax.jms.ConnectionFactory;
  3. import javax.jms.Destination;
  4. import javax.jms.MessageConsumer;
  5. import javax.jms.Session;
  6. import javax.jms.TextMessage;
  7. import javax.jms.Topic;
  9. import org.apache.activemq.ActiveMQConnection;
  10. import org.apache.activemq.ActiveMQConnectionFactory;
  11. public class Receiver {
  12.      public static void main(String[] args) {
  13.         // ConnectionFactory ：连接工厂，JMS用它创建连接
  14.          ConnectionFactory connectionFactory;
  15.          // Connection ：JMS客户端到JMS Provider的连接
  16.          Connection connection = null ;
  17.          // Session：一个发送或接收消息的线程
  18.          Session session;
  19.          // 消费者，消息接收者
  20.          MessageConsumer consumer;
  21.          connectionFactory = newActiveMQConnectionFactory(
  22.                 ActiveMQConnection.DEFAULT_USER,
  23.                  ActiveMQConnection.DEFAULT_PASSWORD,
  24.                  "tcp://localhost:61616" );
  25.          try {
  26.              // 构造从工厂得到连接对象
  27.              connection =connectionFactory.createConnection();
  29.              connection.setClientID( "clientID001" );
  30.              // 启动
  31.              connection.start();
  32.              // 获取操作连接
  33.              session = connection.createSession( false ,
  34.                      Session.AUTO_ACKNOWLEDGE);
  35.              // 获取session
  36.             Topic topic = session.createTopic( "MQ_test" );      
  37.             // 得到消息生成者【发送者】
  38.             consumer = session.createDurableSubscriber(topic, "MQ_sub" );
  40.              while ( true ){
  41.                //设置接收者接收消息的时间，为了便于测试，这里谁定为100s
  43. TextMessagemessage = (TextMessage)consumer.receive( 100000 );
  44.                if ( null != message){
  45.                   System.out.println( "收到消息" +message.getText());
  46.                } else break ;
  47.              }
  48.          } catch (Exception e){
  49.          e.printStackTrace();
  50.          } finally {
  51.              try {
  52.                  if ( null != connection)
  53.                      connection.close();
  54.              } catch (Throwable ignore) {
  55.              }
  56.          }
  57.      }
  59. }

测试

测试一：

A、先启动Sender类
B、再启动Receiver类
C、结果无任何记录被订阅

测试二：
A、先启动Receiver类，让Receiver在相关主题上进行订阅
B、停止Receiver类，再启动Sender类
C、待Sender类运行完成后，再启动Receiver类
D、结果发现相应主题的信息被订阅