收集网上关于ActiveMQ ,JMS 的入门知识

(注:本文内容来自互联网,大部分内容引用于http://whitesock.javaeye.com/,自己整理以作学习用)

JMS基础概念

强烈推荐参考:jms规范
http://cds-esd.sun.com/ESD4/JSCDL/jms/1.1-fr/jms-1_1-fr-spec.pdf?AuthParam=1251941497_cd0bdf66dcfd87835d5a7b024d2b7ae1&TicketId=nodzBVwUT3R%2Bn%2BQvkkSZV5yQcA%3D%3D&GroupName=CDS&FilePath=/ESD4/JSCDL/jms/1.1-fr/jms-1_1-fr-spec.pdf&File=jms-1_1-fr-spec.pdf

部分一 (引用:《ActiveMq in Action》charpeter1)
JMS Client            : An application written using 100% pure Java to send and receive messages.
Non-JMS Client     : An appliation in written in a language other than Java to send and receive messages.
JMS Producer       : A client application that creates and sends JMS messages.
JMS Consumer       : A client application that receives and processes JMS messages.
JMS Provider         : The implementation of the JMS interfaces which is ideally written in 100% pure Java.(ex.ActiveMQ)
JMS Message        : The most fundamental concept of JMS; sent and recevied by JMS clients.
JMS Domains        : The two styles of messaging that include point-to-point and publish/subscribe.
Administered Objects
                           : Preconfigured JMS objects that contain provider-specific configuration data for use by clients.
                       These objects are typically accessible by clients via JNDI.
Connection Factory : Clients use a connection factory to create connections to the JMS provider.
Destination        : An object to which messages are addressed and sent and from which messages are received.

部分二 (引用:http://whitesock.javaeye.com/blog/164925 )

1 JMS的基本构件
  1.1 连接工厂(ConnectionFactory)
      连接工厂是客户用来创建连接的对象，例如ActiveMQ提供的ActiveMQConnectionFactory。
  1.2 连接(Connection)
      JMS Connection封装了客户与JMS提供者之间的一个虚拟的连接。
  1.3 会话(Session)
      JMS Session是生产和消费消息的一个单线程上下文。会话用于创建消息生产者（producer）、消息消费者（consumer）和消息（message）等。会话提供了一个事务性的上下文，在这个上下文中，一组发送和接收被组合到了一个原子操作中。
  1.4 目的地(Destination)
    Destination:An object to which messages are addressed and sent and from which messages are received.
    目的地是客户用来指定它生产的消息的目标和它消费的消息的来源的对象。
    JMS1.0.2规范中定义了两种消息传递域: Point-to-Point (点对点)消息传递域 和 Publich/Subscribe (发布/订阅者)消息传递域。
    点对点消息传递域的特点如下：
       每个消息只能有一个消费者。
       消息的生产者和消费者之间没有时间上的相关性。无论消费者在生产者发送消息的时候是否处于运行状态，它都可以提取消息。
    发布/订阅消息传递域的特点如下：
       每个消息可以有多个消费者。
       生产者和消费者之间有时间上的相关性。订阅一个主题的消费者只能消费自它订阅之后发布的消息。JMS规范允许客户创建持久订阅，这在一定程度上放松了时间上的相关性要求。持       久订阅允许消费者消费它在未处于激活状态时发送的消息。
      在点对点消息传递域中,   目的地被成为队列（queue）.
      在发布/订阅消息传递域中,目的地被成为主题（topic）。
  1.5 消息生产者(MessageProducer)
      消息生产者是由会话创建的一个对象，用于把消息发送到一个目的地。
  1.6 消息消费者(MessageConsumer)
      消息消费者是由会话创建的一个对象，它用于接收发送到目的地的消息。
      消息的消费可以采用以下两种方法之一：
         同步消费,通过调用消费者的receive方法从目的地中显式提取消息。receive方法可以一直阻塞到消息到达。
         异步消费,客户可以为消费者注册一个消息监听器，以定义在消息到达时所采取的动作。
  1.7 消息
       JMS消息由以下三部分组成：
         消息头。每个消息头字段都有相应的getter和setter方法。
         消息属性。如果需要除消息头字段以外的值，那么可以使用消息属性。
         消息体。JMS定义的消息类型有TextMessage、MapMessage、BytesMessage、StreamMessage和ObjectMessage。

2 JMS的可靠性机制
  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。
  2.2 持久性
    JMS支持以下两种消息提交模式：
        PERSISTENT,指示JMS provider持久保存消息，以保证消息不会因为JMS provider的失败而丢失。
        NON_PERSISTENT,不要求JMS provider持久保存消息。
  2.3 优先级
      可以使用消息优先级来指示JMS provider首先提交紧急的消息。优先级分10个级别，从0（最低）到9（最高）。如果不指定优先级，默认级别是4。需要注意的是，JMS provider并不一定保证按照优先级的顺序提交消息。
  2.4 消息过期
      可以设置消息在一定时间后过期，默认是永不过期。
  2.5 临时目的地
      可以通过会话上的createTemporaryQueue方法和createTemporaryTopic方法来创建临时目的地。它们的存在时间只限于创建它们的连接所保持的时间。只有创建该临时目的地的连接上的消息消费者才能够从临时目的地中提取消息。
  2.6 持久订阅
      首先消息生产者必须使用PERSISTENT提交消息。客户可以通过会话上的createDurableSubscriber方法来创建一个持久订阅，该方法的第一个参数必须是一个topic。第二个参数是订阅的名称。
      JMS provider会存储发布到持久订阅对应的topic上的消息。如果最初创建持久订阅的客户或者任何其它客户使用相同的连接工厂和连接的客户ID、相同的主题和相同的订阅名再次调用会话上的createDurableSubscriber方法，那么该持久订阅就会被激活。JMS provider会象客户发送客户处于非激活状态时所发布的消息。
      持久订阅在某个时刻只能有一个激活的订阅者。持久订阅在创建之后会一直保留，直到应用程序调用会话上的unsubscribe方法。
  2.7 本地事务
      在一个JMS客户端，可以使用本地事务来组合消息的发送和接收。JMS Session接口提供了commit和rollback方法。事务提交意味着生产的所有消息被发送，消费的所有消息被确认；事务回滚意味着生产的所有消息被销毁，消费的所有消息被恢复并重新提交，除非它们已经过期。
    事务性的会话总是牵涉到事务处理中,commit或rollback方法一旦被调用,一个事务就结束了,而另一个事务被开始,关闭事务性会话将回滚其中的事务.
需要注意的是，如果使用请求/回复机制,即发送一个消息,同时希望在同一个事务中等待接收该消息的回复,那么程序将被挂起,因为知道事务提交,发送操作才会真正执行。
    需要注意的还有一个,消息的生产和消费不能包含在同一个事务中.

3 JMS 规范的变迁
  JMS的最新版本的是1.1。它和同1.0.2版本之间最大的差别是，JMS1.1通过统一的消息传递域简化了消息传递。这不仅简化了JMS API，也有利于开发人员灵活选择消息传递域，同时也有助于程序的重用和维护。
以下是不同消息传递域的相应接口：

JMS 公共                    点对点域                               发布/订阅域
ConnectionFactory     QueueConnectionFactory     TopicConnectionFactory
Connection                 QueueConnection                TopicConnection
Destination                 Queue                                  Topic
Session                       QueueSession                     TopicSession
MessageProducer       QueueSender                      TopicPublisher
MessageConsumer     QueueReceiver                    TopicSubscriber

 

学习参考

ActiveMQ JMS 入门
     http://rrsy23.javaeye.com/blog/333246
JMS in action系列
之一: http://whitesock.javaeye.com/blog/164925
之二: http://whitesock.javaeye.com/blog/164933
之三: http://whitesock.javaeye.com/blog/164937
之四: http://whitesock.javaeye.com/blog/164938
之五: http://whitesock.javaeye.com/blog/164942
之六: http://whitesock.javaeye.com/blog/165168
之七: http://whitesock.javaeye.com/blog/165458
Spring JMS
     http://whitesock.javaeye.com/blog/306776
ActiveMQ4.1+Spring2.0的Message Driven POJO 
     http://wiki.springside.org.cn/display/springside/ActiveMQ
     http://wiki.springside.org.cn/display/springside/ActiveMQ-part2
其他
    http://www.agimatec.de/blog/2008/08/extended-blazeds-and-jms-example/

补充几个例子

1.在http://rrsy23.javaeye.com/blog/333246 例子中有个同步消息处理的简单例子,这里补一个异步消息处理的简单例子
   该例子来自http://my.oschina.net/dxf/blog/405
 public class AsynReceiver implements MessageListener { private boolean stop = false; public static void main(String[] args) { new AsynReceiver().receive(); } public void onMessage(Message msg) { try { String text = ((TextMessage) msg).getText(); System.out.println("收到消息" + text +" in AsynReceiver "); if (text.equals("stop")) stop = true; } catch (JMSException e) { e.printStackTrace(); stop = true; } } public void receive() { System.out.println("hello, receiver is here"); ConnectionFactory connectionFactory; Connection connection = null; Session session; Destination destination; MessageConsumer consumer; connectionFactory = new ActiveMQConnectionFactory( ActiveMQConnection.DEFAULT_USER, ActiveMQConnection.DEFAULT_PASSWORD,"tcp://192.168.0.24:61616"); try { // 构造从工厂得到连接对象 connection = connectionFactory.createConnection(); connection.start(); session = connection.createSession(Boolean.FALSE, Session.AUTO_ACKNOWLEDGE); destination = session.createQueue("your.queue"); consumer = session.createConsumer(destination); consumer.setMessageListener(this); while(!stop){ Thread.sleep(5); } System.out.println("exiting.."); } catch (Exception e) { e.printStackTrace(); } finally { try { if (null != connection) connection.close(); } catch (Throwable ignore) { } } } }
2. Flex订阅JMS实时刷新 (来自 http://blog.csdn.net/xieyf_0413/archive/2008/07/19/2677415.aspx)
    该例子给出大部分代码, 这里作个补充
   2.1 SampleBean很简单,忽略,这里给出与SampleBean对应的ValueVO.as:
     //可以比较下Flex中属性定义和C#中属性定义

package { import flash.display.Sprite; [RemoteClass(alias="com.my.activemq.SampleBean")] [Bindable] public class ValueVO extends Sprite{ private var _id:String; private var _xname:String; //对应SampleBean中xname,超类中似乎有个name属性. private var _value:String; public function ValueVO(){} public function get id(){ return _id; } public function set id(id:String):void{ this._id = id; } public function get xname(){ return _xname; } public function set xname(xname:String):void{ this._xname = xname; } public function get value(){ return _value; } public function set value(value:String):void{ this._value = value; } } } 
    2.2 ActiveMq使用本地地址,几个配置文件改了下:
      2.2.1 messaging-config.xml
      <adapters>
              <!-- 这个地方要把注释去掉,默认是注释掉的-->
        <adapter-definition id="jms" class="flex.messaging.services.messaging.adapters.JMSAdapter"/>
      </adapters>
      <destination id="message-destination">
         <adapter ref="jms"/>
         <properties>
         <jms>
             <destination-type>Topic</destination-type>
             <message-type>javax.jms.ObjectMessage</message-type>
             <connection-factory>java:comp/env/jms/ConnectionFactory</connection-factory>
             <destination-jndi-name>java:comp/env/jms/topic/MyTopic</destination-jndi-name>
             <delivery-mode>NON_PERSISTENT</delivery-mode>
             <message-priority>DEFAULT_PRIORITY</message-priority>
             <acknowledge-mode>AUTO_ACKNOWLEDGE</acknowledge-mode>
             <initial-context-environment>
                <property>
                   <name>Context.INITIAL_CONTEXT_FACTORY</name>
                   <value>org.apache.activemq.jndi.ActiveMQInitialContextFactory</value>
                </property>
                <property>
                   <name>Context.PROVIDER_URL</name>
                   <value>vm://localhost:61616</value>
                </property>
             </initial-context-environment>
         </jms>
         </properties>
         <channels>
            <channel ref="my-amf"/>
         </channels>
       </destination>
      2.2.2 services-config.xml
       <channel-definition id="my-amf" class="mx.messaging.channels.AMFChannel">
               <endpoint url="http://localhost:8080/jmsTopic/messagebroker/amf" class="flex.messaging.endpoints.AMFEndpoint"/>
           <properties>
                <polling-enabled>true</polling-enabled>
                <polling-interval-millis>1000</polling-interval-millis>
            </properties>
        </channel-definition>
     2.2.3 context.xml
     <Context antiJARLocking="true">
       <Resource
        name="jms/ConnectionFactory"
        auth="Container"
        type="org.apache.activemq.ActiveMQConnectionFactory"
        description="JMS Connection Factory"
        factory="org.apache.activemq.jndi.JNDIReferenceFactory"
        brokerURL="vm://localhost:61616"
        brokerName="LocalActiveMQBroker"
        useEmbeddedBroker="true"/>

        <Resource name="jms/topic/MyTopic"
        auth="Container"
        type="org.apache.activemq.command.ActiveMQTopic"
        factory="org.apache.activemq.jndi.JNDIReferenceFactory"
        physicalName="MY.TEST.FOO"/>
    </Context>
    主要是tcp uri 改成 vm  uri