activemq使用教程

整理文档很辛苦,赏杯茶钱您下走!

免费阅读已结束,点击下载阅读编辑剩下 ...

阅读已结束,您可以下载文档离线阅读编辑

资源描述

activemq目前最新版本是5.2.0,很多开源项目都使用activemq作为message的收发.下载网址是:一下是网上收集的资料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公共点对点域发布/订阅域ConnectionFactoryQueueConnectionFactoryTopicConnectionFactoryConnectionQueueConnectionTopicConnectionDestinationQueueTopicSessionQueueSessionTopicSessionMessageProducerQueueSenderTopicPublisherMessageConsumerQueueReceiverTopicSubscriber2ActiveMQ2.1Broker2.1.1RunningBrokerActiveMQ5.0的二进制发布包中bin目录中包含一个名为activemq的脚本,直接运行这个脚本就可以启动一个broker。此外也可以通过BrokerConfigurationURI或BrokerXBeanURI对broker进行配置,以下是一些命令行参数的例子:ExampleDescriptionactivemqRunsabrokerusingthedefault'xbean:activemq.xml'asthebrokerconfigurationfile.activemqxbean:myconfig.xmlRunsabrokerusingthefilemyconfig.xmlasthebrokerconfigurationfilethatislocatedintheclasspath.activemqxbean:file:./conf/broker1.xmlRunsabrokerusingthefilebroker1.xmlasthebrokerconfigurationfilethatislocatedintherelativefilepath./conf/broker1.xmlactivemqxbean:file:C:/ActiveMQ/conf/broker2.xmlRunsabrokerusingthefilebroker2.xmlasthebrokerconfigurationfilethatislocatedintheabsolutefilepathC:/ActiveMQ/conf/broker2.xmlactivemqbroker:(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的可选值如下:URIschemeExampleDescriptionxbean:xbean:activemq.xmlSearchestheclasspathforanXMLdocumentwiththegivenURI(activemq.xmlinthiscase)whichwillthenbeusedastheXmlConfigurationfile:file:foo/bar/activemq.xmlLoadsthegivenfile(inthisexamplefoo/bar/activemq.xml)astheXmlConfigurationbroker:broker:tcp://localhost:61616UsestheBrokerConfigurationURItoconfigurethebroker当

1 / 31
下载文档,编辑使用

©2015-2020 m.777doc.com 三七文档.

备案号:鲁ICP备2024069028号-1 客服联系 QQ:2149211541

×
保存成功