activemq使用教程.docx
- 文档编号:9684264
- 上传时间:2023-05-20
- 格式:DOCX
- 页数:37
- 大小:41.22KB
activemq使用教程.docx
《activemq使用教程.docx》由会员分享,可在线阅读,更多相关《activemq使用教程.docx(37页珍藏版)》请在冰点文库上搜索。
activemq使用教程
activemq目前最新版本是5.2.0,很多开源项目都使用activemq作为message的收发.
下载网址是:
http:
//activemq.apache.org/download.html
一下是网上收集的资料
1JMS
在介绍ActiveMQ之前,首先简要介绍一下JMS规范。
1.1JMS的基本构件
1.1.1连接工厂
连接工厂是客户用来创建连接的对象,例如ActiveMQ提供的ActiveMQConnectionFactory。
1.1.2连接
JMSConnection封装了客户与JMS提供者之间的一个虚拟的连接。
1.1.3会话
JMSSession是生产和消费消息的一个单线程上下文。
会话用于创建消息生产者(producer)、消息消费者(consumer)和消息(message)等。
会话提供了一个事务性的上下文,在这个上下文中,一组发送和接收被组合到了一个原子操作中。
1.1.4目的地
目的地是客户用来指定它生产的消息的目标和它消费的消息的来源的对象。
JMS1.0.2规范中定义了两种消息传递域:
点对点(PTP)消息传递域和发布/订阅消息传递域。
点对点消息传递域的特点如下:
•每个消息只能有一个消费者。
•消息的生产者和消费者之间没有时间上的相关性。
无论消费者在生产者发送消息的时候是否处于运行状态,它都可以提取消息。
发布/订阅消息传递域的特点如下:
•每个消息可以有多个消费者。
•生产者和消费者之间有时间上的相关性。
订阅一个主题的消费者只能消费自它订阅之后发布的消息。
JMS规范允许客户创建持久订阅,这在一定程度上放松了时间上的相关性要求。
持久订阅允许消费者消费它在未处于激活状态时发送的消息。
在点对点消息传递域中,目的地被成为队列(queue);在发布/订阅消息传递域中,目的地被成为主题(topic)。
1.1.5消息生产者
消息生产者是由会话创建的一个对象,用于把消息发送到一个目的地。
1.1.6消息消费者
消息消费者是由会话创建的一个对象,它用于接收发送到目的地的消息。
消息的消费可以采用以下两种方法之一:
•同步消费。
通过调用消费者的receive方法从目的地中显式提取消息。
receive方法可以一直阻塞到消息到达。
•异步消费。
客户可以为消费者注册一个消息监听器,以定义在消息到达时所采取的动作。
1.1.7消息
JMS消息由以下三部分组成:
•消息头。
每个消息头字段都有相应的getter和setter方法。
•消息属性。
如果需要除消息头字段以外的值,那么可以使用消息属性。
•消息体。
JMS定义的消息类型有TextMessage、MapMessage、BytesMessage、StreamMessage和ObjectMessage。
1.2JMS的可靠性机制
1.2.1确认
JMS消息只有在被确认之后,才认为已经被成功地消费了。
消息的成功消费通常包含三个阶段:
客户接收消息、客户处理消息和消息被确认。
在事务性会话中,当一个事务被提交的时候,确认自动发生。
在非事务性会话中,消息何时被确认取决于创建会话时的应答模式(acknowledgementmode)。
该参数有以下三个可选值:
•Session.AUTO_ACKNOWLEDGE。
当客户成功的从receive方法返回的时候,或者从MessageListener.onMessage方法成功返回的时候,会话自动确认客户收到的消息。
•Session.CLIENT_ACKNOWLEDGE。
客户通过消息的acknowledge方法确认消息。
需要注意的是,在这种模式中,确认是在会话层上进行:
确认一个被消费的消息将自动确认所有已被会话消费的消息。
例如,如果一个消息消费者消费了10个消息,然后确认第5个消息,那么所有10个消息都被确认。
•Session.DUPS_ACKNOWLEDGE。
该选择只是会话迟钝第确认消息的提交。
如果JMSprovider失败,那么可能会导致一些重复的消息。
如果是重复的消息,那么JMSprovider必须把消息头的JMSRedelivered字段设置为true。
1.2.2持久性
JMS支持以下两种消息提交模式:
•PERSISTENT。
指示JMSprovider持久保存消息,以保证消息不会因为JMSprovider的失败而丢失。
•NON_PERSISTENT。
不要求JMSprovider持久保存消息。
1.2.3优先级
可以使用消息优先级来指示JMSprovider首先提交紧急的消息。
优先级分10个级别,从0(最低)到9(最高)。
如果不指定优先级,默认级别是4。
需要注意的是,JMSprovider并不一定保证按照优先级的顺序提交消息。
1.2.4消息过期
可以设置消息在一定时间后过期,默认是永不过期。
1.2.5临时目的地
可以通过会话上的createTemporaryQueue方法和createTemporaryTopic方法来创建临时目的地。
它们的存在时间只限于创建它们的连接所保持的时间。
只有创建该临时目的地的连接上的消息消费者才能够从临时目的地中提取消息。
1.2.6持久订阅
首先消息生产者必须使用PERSISTENT提交消息。
客户可以通过会话上的createDurableSubscriber方法来创建一个持久订阅,该方法的第一个参数必须是一个topic。
第二个参数是订阅的名称。
JMSprovider会存储发布到持久订阅对应的topic上的消息。
如果最初创建持久订阅的客户或者任何其它客户使用相同的连接工厂和连接的客户ID、相同的主题和相同的订阅名再次调用会话上的createDurableSubscriber方法,那么该持久订阅就会被激活。
JMSprovider会象客户发送客户处于非激活状态时所发布的消息。
持久订阅在某个时刻只能有一个激活的订阅者。
持久订阅在创建之后会一直保留,直到应用程序调用会话上的unsubscribe方法。
1.2.7本地事务
在一个JMS客户端,可以使用本地事务来组合消息的发送和接收。
JMSSession接口提供了commit和rollback方法。
事务提交意味着生产的所有消息被发送,消费的所有消息被确认;事务回滚意味着生产的所有消息被销毁,消费的所有消息被恢复并重新提交,除非它们已经过期。
事务性的会话总是牵涉到事务处理中,commit或rollback方法一旦被调用,一个事务就结束了,而另一个事务被开始。
关闭事务性会话将回滚其中的事务。
需要注意的是,如果使用请求/回复机制,即发送一个消息,同时希望在同一个事务中等待接收该消息的回复,那么程序将被挂起,因为知道事务提交,发送操作才会真正执行。
需要注意的还有一个,消息的生产和消费不能包含在同一个事务中。
1.3JMS规范的变迁
JMS的最新版本的是1.1。
它和同1.0.2版本之间最大的差别是,JMS1.1通过统一的消息传递域简化了消息传递。
这不仅简化了JMSAPI,也有利于开发人员灵活选择消息传递域,同时也有助于程序的重用和维护。
以下是不同消息传递域的相应接口:
JMS公共点对点域发布/订阅域
ConnectionFactoryQueueConnectionFactoryTopicConnectionFactory
ConnectionQueueConnectionTopicConnection
DestinationQueueTopic
SessionQueueSessionTopicSession
MessageProducerQueueSenderTopicPublisher
MessageConsumerQueueReceiverTopicSubscriber
2ActiveMQ
2.1Broker
2.1.1RunningBroker
ActiveMQ5.0的二进制发布包中bin目录中包含一个名为activemq的脚本,直接运行这个脚本就可以启动一个broker。
此外也可以通过BrokerConfigurationURI或BrokerXBeanURI对broker进行配置,以下是一些命令行参数的例子:
ExampleDescription
activemqRunsabrokerusingthedefault'xbean:
activemq.xml'asthebrokerconfigurationfile.
activemqxbean:
myconfig.xmlRunsabrokerusingthefilemyconfig.xmlasthebrokerconfigurationfilethatislocatedintheclasspath.
activemqxbean:
file:
./conf/broker1.xmlRunsabrokerusingthefilebroker1.xmlasthebrokerconfigurationfilethatislocatedintherelativefilepath./conf/broker1.xml
activemqxbean:
file:
C:
/ActiveMQ/conf/broker2.xmlRunsabrokerusingthefilebroker2.xmlasthebrokerconfigurationfilethatislocatedintheabsolutefilepathC:
/ActiveMQ/conf/broker2.xml
activemqbroker:
(tcp:
//localhost:
61616,tcp:
//localhost:
5000)?
useJmx=trueRunsabrokerwithtwotransportconnectorsandJMXenabled.
activemqbroker:
(tcp:
//localhost:
61616,network:
tcp:
//localhost:
5000)?
persistent=falseRunsabrokerwith1transportconnectorand1networkconnectorwithpersistencedisabled.
2.1.2EmbeddedBroker
可以通过在应用程序中以编码的方式启动broker,例如:
Java代码
1.BrokerServicebroker=newBrokerService();
2.broker.addConnector("tcp:
//localhost:
61616");
3.broker.start();
如果需要启动多个broker,那么需要为broker设置一个名字。
例如:
Java代码
1.BrokerServicebroker=newBrokerService();
2.broker.setName("fred");
3.broker.addConnector("tcp:
//localhost:
61616");
4.broker.start();
如果希望在同一个JVM内访问这个broker,那么可以使用VMTransport,URI是:
vm:
//brokerName。
关于更多的broker属性,可以参考Apache的官方文档。
此外,也可以通过BrokerFactory来创建broker,例如:
Java代码
1.BrokerServicebroker=BrokerFactory.createBroker(newURI(someURI));
someURI的可选值如下:
URIschemeExampleDescription
xbean:
xbean:
activemq.xmlSearchestheclasspathforanXMLdocumentwiththegivenURI(activemq.xmlinthiscase)whichwillthenbeusedastheXmlConfiguration
file:
file:
foo/bar/activemq.xmlLoadsthegivenfile(inthisexamplefoo/bar/activemq.xml)astheXmlConfiguration
broker:
broker:
tcp:
//localhost:
61616UsestheBrokerConfigurationURItoconfigurethebroker
当使用XBean的配置方式的时候,需要指定一个xml配置文件,例如:
Java代码
1.BrokerServicebroker=BrokerFactory.createBroker(newURI("xbean:
com/test/activemq.xml"));
使用Spring的配置方式如下:
Xml代码
1.
2. org/apache/activemq/xbean/activemq.xml"/> 3. 4. 2.1.3MonitoringBroker 2.1.3.1JMX 在使用JMX监控broker之前,首先要启用broker的JMX监控功能,例如在配置文件中设置useJmx="true",如下: Xml代码 1. 2. 3. 4. 5. ... 6. 接下来运行JDK自带的jconsole。 在运行了jconsole后,它会弹出对话框来选择需要连接到的agent。 如果是在启动broker的主机上运行jconsole,那么ActiveMQbroker会出现在jconsole的Local标签中。 如果要连接到远程的broker,那么可以在Advanced标签中指定JMXURL,以下是一个连接到本机的JMXURL: service: jmx: rmi: ///jndi/rmi: //localhost: 1099/jmxrmi 在jconsole的MBeans标签中,可以查看详细信息,也可以执行相应的operation。 需要注意的是,在jconsole连接到broker的时候,并不需要输入用户名和密码,如果这存在潜在的安全问题,那么就需要为JMXConnector配置密码保护(需要使用1.5以上版本的JDK)。 首先要禁止ActiveMQ创建自己的connector,例如: Xml代码 1. //activemq.org/config/1.0"brokerName="localhost"useJmx="true"> 2. 3. 4. 5. 然后在ActiveMQ的conf目录下创建一个访问控制文件和密码文件,如下: conf/jmx.access: #The"monitorRole"rolehasreadonlyaccess. #The"controlRole"rolehasreadwriteaccess. monitorRolereadonly controlRolereadwrite conf/jmx.password: #The"monitorRole"rolehaspassword"abc123". #The"controlRole"rolehaspassword"abcd1234". monitorRoleabc123 controlRoleabcd1234 然后修改ActiveMQ的bin目录下activemq的启动脚本,查找包含"SUNJMX="的一行如下: REMsetSUNJMX=-Dcom.sun.management.jmxremote.port=1616-Dcom.sun.management.jmxremote.authenticate=false-Dcom.sun.management.jmxremote.ssl=false 把它替换成 setSUNJMX=-Dcom.sun.management.jmxremote.port=1616-Dcom.sun.management.jmxremote.authenticate=true-Dcom.sun.management.jmxremote.ssl=false-Dcom.sun.management.jmxremote.password.file=%ACTIVEMQ_BASE%/conf/jmx.password-Dcom.sun.management.jmxremote.access.file=%ACTIVEMQ_BASE%/conf/jmx.access 最后重启ActiveMQ和jconsole,这时候需要强制login。 如果在启动activemq的过程中出现以下错误,那么需要为这个文件增加访问控制。 Windows平台上的具体解决方法请参考如下网址: /management/security-windows.html Error: Passwordfilereadaccessmustberestricted: D: \apache-activemq-5.0.0\bin\../conf/jmx.password 2.1.3.2WebConsole WebConsole被集成到了ActiveMQ的二进制发布包中,因此缺省访问http: //localhost: 8161/admin即可访问WebConsole。 在配置文件中,可以通过修改nioConnector的port属性来修改Webconsole的缺省端口: Xml代码 1. 2. 3. 4. 5. ... 6. 出于安全性或者可靠性的考虑,WebConsole可以被部署到不同于ActiveMQ的进程中。 例如把activemq-web-console.war部署到一个单独的web容器中(Tomcat,Jetty等)。 在ActiveMQ5.0的二进制发布包中不包含activemq-web-console.war,因此需要下载ActiveMQ的源码,然后进入到${activemq.base}/src/activemq-web-console目录中执行mvninstanll。 如果一切正常,那么缺省会在${activemq.base}/src/activemq-web-console/target目录中生成activemq-web-console-5.0.0.war。 然后将activemq-web-console-5.0.0.war拷贝到Tomcat的webapps目录中,并重命名成activemq-web-console.war。 需要注意的是,要将activemq-all-5.0.0.jar拷贝到WEB-INF\lib目录中(可能还需要拷贝jms.jar)。 还要为Tomcat设置以下五个系统属性(修改catalina.bat文件): setJAVA_OPTS=%JAVA_OPTS%-Dwebconsole.type="properties" setJAVA_OPTS=%JAVA_OPTS%-Dwebconsole.jms.url="tcp: //localhost: 61616" setJAVA_OPTS=%JAVA_OPTS%-Dwebconsole.jmx.url="service: jmx: rmi: ///jndi/rmi: //localhost: 1099/jmxrmi" setJAVA_OPTS=%JAVA_OPTS%-Dwebconsole.jmx.role="" setJAVA_OPTS=%JAVA_OPTS%-Dwebconsole.jmx.password="" 如果JMX没有配置密码保护,那么webconsole.jmx.role和webconsole.jmx.password设置成""即可。 如果broker被配置成了Master/Slave模式,那么可以配置成使用failovertransport,例如: -Dwebconsole.jms.url=failover: (tcp: //serverA: 61616,tcp: //serverB: 61616) 顺便说一下,由于webconsole.type属性是properties,因此实际上起作用的WebConsole的配置文件是WEB-INF/webconsole-properties.xml。 最后启动被监控的ActiveMQ,访问http: //localhost: 8080/activemq-web-console/,查看显示是否正常。 2.1.3.3AdvisoryMessage ActiveMQ支持AdvisoryMessages,它允许你通过标准的JMS
- 配套讲稿:
如PPT文件的首页显示word图标,表示该PPT已包含配套word讲稿。双击word图标可打开word文档。
- 特殊限制:
部分文档作品中含有的国旗、国徽等图片,仅作为作品整体效果示例展示,禁止商用。设计者仅对作品中独创性部分享有著作权。
- 关 键 词:
- activemq 使用 教程