zoukankan      html  css  js  c++  java
  • Apache ActiveMQ教程

    一、特性及优势

    1、实现JMS1.1规范,支持J2EE1.4以上
    2、可运行于任何jvm和大部分web容器(ActiveMQ works great in any JVM)
    3、支持多种语言客户端(java, C, C++, AJAX, ACTIONSCRIPT等等)
    4、支持多种协议(stomp,openwire,REST)
    5、良好的spring支持(ActiveMQ has great Spring Support)
    6、速度很快,JBossMQ的十倍(ActiveMQ is very fast; often 10x faster than JBossMQ.)
    7、与OpenJMS、JbossMQ等开源jms provider相比,ActiveMQ有Apache的支持,持续发展的优势明显。

    二、下载部署

    1、下载,

    http://activemq.apache.org/activemq-510-release.html,下载5.1.0 Windows Distribution版本

    2、安装, 直接解压至任意目录(如:d:\ apache-activemq-5.1.0)
    3、启动ActiveMQ服务器
    方法1:
    直接运行bin\activemq.bat
    方法2(在JVM中嵌套启动):

    1
    2
    cd example
    ant embedBroker

    4、ActiveMQ消息管理后台系统:http://localhost:8161/admin

    三、运行附带的示例程序

    1、Queue消息示例:
    * 启动Queue消息消费者

    1
    2
    cd example
    ant consumer

    * 启动Queue消息生产者

    1
    2
    cd example
    ant producer

    简要说明:生产者(producer)发消息,消费者(consumer)接消息,发送/接收2000个消息后自动关闭

    2、Topic消息示例:
    * 启动Topic消息消费者

    1
    2
    cd example
    ant topic-listener

    * 启动Topic消息生产者

    1
    2
    cd example
    ant topic-publisher

    简要说明:重复10轮,publisher每轮发送2000个消息,并等待获取listener的处理结果报告,然后进入下一轮发送,最后统计全局发送时间。

    四、Queue与Topic的比较

    1、JMS Queue执行load balancer语义:
    一条消息仅能被一个consumer收到。如果在message发送的时候没有可用的consumer,那么它将被保存一直到能处理该message的consumer可用。如果一个consumer收到一条message后却不响应它,那么这条消息将被转到另一个consumer那儿。一个Queue可以有很多consumer,并且在多个可用的consumer中负载均衡。

    2、Topic实现publish和subscribe语义:
    一条消息被publish时,它将发到所有感兴趣的订阅者,所以零到多个subscriber将接收到消息的一个拷贝。但是在消息代理接收到消息时,只有激活订阅的subscriber能够获得消息的一个拷贝。

    3、分别对应两种消息模式:
    Point-to-Point (点对点),Publisher/Subscriber Model (发布/订阅者)
    其中在Publicher/Subscriber 模式下又有Nondurable subscription(非持久订阅)和durable subscription (持久化订阅)2种消息处理方式。

    五、Point-to-Point (点对点)消息模式开发流程

    1、生产者(producer)开发流程(ProducerTool.java):
    1.1 创建Connection:根据url,user和password创建一个jms Connection。
    1.2 创建Session:在connection的基础上创建一个session,同时设置是否支持事务和ACKNOWLEDGE标识。
    1.3 创建Destination对象:需指定其对应的主题(subject)名称,producer和consumer将根据subject来发送/接收对应的消息。
    1.4 创建MessageProducer:根据Destination创建MessageProducer对象,同时设置其持久模式。
    1.5 发送消息到队列(Queue):封装TextMessage消息,使用MessageProducer的send方法将消息发送出去。

    2、消费者(consumer)开发流程(ConsumerTool.java):
    2.1 实现MessageListener接口:消费者类必须实现MessageListener接口,然后在onMessage()方法中监听消息的到达并处理。
    2.2 创建Connection:根据url,user和password创建一个jms Connection,如果是durable模式,还需要给connection设置一个clientId。
    2.3 创建Session和Destination:与ProducerTool.java中的流程类似,不再赘述。
    2.4创建replyProducer【可选】:可以用来将消息处理结果发送给producer。
    2.5 创建MessageConsumer:根据Destination创建MessageConsumer对象。
    2.6 消费message:在onMessage()方法中接收producer发送过来的消息进行处理,并可以通过replyProducer反馈信息给producer

    1
    2
    3
    4
    if (message.getJMSReplyTo() != null) {
    replyProducer.send(message.getJMSReplyTo(),
    session.createTextMessage("Reply: " + message.getJMSMessageID()));
    }

    六、Publisher/Subscriber(发布/订阅者)消息模式开发流程

    1、订阅者(Subscriber)开发流程(TopicListener.java):
    1.1 实现MessageListener接口:在onMessage()方法中监听发布者发出的消息队列,并做相应处理。
    1.2 创建Connection:根据url,user和password创建一个jms Connection。
    1.3 创建Session:在connection的基础上创建一个session,同时设置是否支持事务和ACKNOWLEDGE标识。
    1.4 创建Topic:创建2个Topic, topictest.messages用于接收发布者发出的消息,topictest.control用于向发布者发送消息,实现双方的交互。
    1.5 创建consumer和producer对象:根据topictest.messages创建consumer,根据topictest.control创建producer。
    1.6 接收处理消息:在onMessage()方法中,对收到的消息进行处理,可直接简单在本地显示消息,或者根据消息内容不同处理对应的业务逻辑(比如:数据库更新、文件操作等等),并且可以使用producer对象将处理结果返回给发布者。

    2、发布者(Publisher)开发流程(TopicPublisher.java):
    2.1 实现MessageListener接口:在onMessage()方法中接收订阅者的反馈消息。
    2.2 创建Connection:根据url,user和password创建一个jms Connection。
    2.3 创建Session:在connection的基础上创建一个session,同时设置是否支持事务和ACKNOWLEDGE标识。
    2.4 创建Topic:创建2个Topic,topictest.messages用于向订阅者发布消息,topictest.control用于接收订阅者反馈的消息。这2个topic与订阅者开发流程中的topic是一一对应的。
    2.5 创建consumer和producer对象:根据topictest.messages创建publisher;根据topictest.control创建consumer,同时监听订阅者反馈的消息。
    2.6 给所有订阅者发送消息,并接收反馈消息:示例代码中,一共重复10轮操作。每轮先向所有订阅者发送2000个消息;
    然后堵塞线程,开始等待;最后通过onMessage()方法,接收到订阅者反馈的“REPORT”类信息后,才print反馈信息并解除线程堵塞,进入下一轮。
    注:可同时运行多个订阅者测试查看此模式效果

    七、ActiveMQ与Tomcat整合

    说明:Tomcat示例版本6.0.14,其它版本在配置上可能有一些差异

    1、准备jar包:将ActiveMQ lib目录下的5个jar包复制到Tomcat lib目录下:

    activemq-core-5.1.0.jar
    activemq-web-5.1.0.jar
    geronimo-j2ee-management_1.0_spec-1.0.jar
    geronimo-jms_1.1_spec-1.1.1.jar
    geronimo-jta_1.0.1B_spec-1.0.1.jar

    2、修改配置文件:
    2.1 修改Tomcat的conf/context.xml文件:
    在节点中添加以下内容:

    1
    2
    3
    4
    5
    6
    7
    8
    9
    10
    11
    12
    13
    14
    15
    16
    17
    18
    19
    20
    21
    22
    23
    24
    25
    26
    27
    28
    29
    30
    31
    32
    <Resource
    name="jms/FailoverConnectionFactory"
    auth="Container"
    type="org.apache.activemq.ActiveMQConnectionFactory"
    description="JMS Connection Factory"
    factory="org.apache.activemq.jndi.JNDIReferenceFactory"
    brokerURL="failover:(tcp://localhost:61616)?initialReconnectDelay=100&maxReconnectAttempts=5"
    brokerName="localhost"
    useEmbeddedBroker="false"/>
     
    <Resource
    name="jms/NormalConnectionFactory"
    auth="Container"
    type="org.apache.activemq.ActiveMQConnectionFactory"
    description="JMS Connection Factory"
    factory="org.apache.activemq.jndi.JNDIReferenceFactory"
    brokerURL="tcp://localhost:61616"
    brokerName="localhost"
    useEmbeddedBroker="false"/>
     
    <Resource name="jms/topic/MyTopic"
    auth="Container"
    type="org.apache.activemq.command.ActiveMQTopic"
    factory="org.apache.activemq.jndi.JNDIReferenceFactory"
    physicalName="MY.TEST.FOO"/>
     
    <Resource name="jms/queue/MyQueue"
    auth="Container"
    type="org.apache.activemq.command.ActiveMQQueue"
    factory="org.apache.activemq.jndi.JNDIReferenceFactory"
    physicalName="MY.TEST.FOO.QUEUE"/>
    配置说明:以JNDI的方式定义了ActiveMQ的broker连接url、Topic和Queue。

    此处需加以注意的是Listener端的borkerURL使用了failover传输方式:

    1
    failover:(tcp://localhost:61616)?initialReconnectDelay=100&maxReconnectAttempts=5

    客户端使用普通传输方式:tcp://localhost:61616

    failover transport是一种重新连接机制,用于建立可靠的传输。此处配置的是一旦ActiveMQ broker中断,Listener端将每隔100ms自动尝试连接,直至成功连接或重试5次连接失败为止。

    failover还支持多个borker同时提供服务,实现负载均衡的同时可增加系统容错性,格式:
    failover:(uri1,…,uriN)?transportOptions

    2.2 新建web应用(webapps/jms-test),修改WEB-INF/web.xml文件:
    增加一个自启动Servlet,该Servlet实现了MessageListener接口,作为Topic消息的Listener端。

    1
    2
    3
    4
    5
    6
    7
    <servlet>
    <servlet-name>jms-listener</servlet-name>
    <servlet-class>
    com.flvcd.servlet.JMSListener
    </servlet-class>
    <load-on-startup>1</load-on-startup>
    </servlet>

    2.3 修改activemq.xml文件:
    为了支持持久化消息,需修改ActiveMQ的配置文件如下,使用默认的AMQ Message Store方式(索引文件方式)存储消息,据官网介绍是快速、稳定的。数据库存储方式可参照官网相关文档。

    1
    2
    3
    <broker xmlns="http://activemq.apache.org/schema/core" brokerName="localhost" persistent="true" useShutdownHook="false">
    <persistenceAdapter>
    <amqPersistenceAdapter class="MsoNormal">
    1
    2
    3
    4
    5
    6
    7
    8
    9
    10
    11
    12
    13
    14
    15
    16
    17
    18
    19
    20
    21
    22
    23
    24
    25
    26
    27
    28
    29
    30
    31
    32
    33
    34
    35
    36
    37
    38
    39
                connection.setClientID("MyClient");
    Session jmsSession = connection.createSession(false, Session.AUTO_ACKNOWLEDGE);
     
    //普通消息订阅者,无法接收持久消息
    //MessageConsumer consumer = jmsSession.createConsumer((Destination) envContext.lookup("jms/topic/MyTopic"));
    //基于Topic创建持久的消息订阅者,前提:Connection必须指定一个唯一的clientId,当前为MyClient
    TopicSubscriber consumer = jmsSession.createDurableSubscriber((Topic) envContext.lookup("jms/topic/MyTopic"), "MySub");
    consumer.setMessageListener(this);
    connection.start();
    } catch (NamingException e) {
    e.printStackTrace();
    } catch (JMSException e) {
    e.printStackTrace();
    }
    }
     
    /** 接收消息,做对应处理 */
    public void onMessage(Message message) {
    if (checkText(message, "RefreshArticleId") != null) {
    String articleId = checkText(message, "RefreshArticleId");
    System.out.println("接收刷新文章消息,开始刷新文章ID=" + articleId);
    }
    else if (checkText(message, "RefreshThreadId") != null) {
    String threadId = checkText(message, "RefreshThreadId");
    System.out.println("接收刷新论坛帖子消息,开始刷新帖子ID=" + threadId);
    } else {
    System.out.println("接收普通消息,不做任何处理!");
    }
    }
     
    private static String checkText(Message m, String s) {
    try {
    return m.getStringProperty(s);
    } catch (JMSException e) {
    e.printStackTrace(System.out);
    return null;
    }
    }
    }

    编译JMSListener.java至classes目录:

    1
    javac -cp .;D:\apache-tomcat-6.0.14\lib\servlet-api.jar;D:\apache-tomcat-6.0.14\lib\geronimo-jms_1.1_spec-1.1.1.jar;D:\apache-tomcat-6.0.14\lib\activemq-core-5.1.0.jar -d . JMSListener.java

    注:D:\apache-tomcat-6.0.14请替换成本地对应目录。

    4、Publisher端(publish.jsp)实现:
    在jms-test目录下新建publish.jsp文件:

    1
    2
    3
    4
    5
    6
    7
    8
    9
    10
    11
    12
    13
    14
    15
    16
    17
    18
    19
    20
    21
    22
    23
    24
    25
    26
    27
    <%@ page language="java" import="javax.jms.*" pageEncoding="GBK"%>
    <%@ page language="java" import="javax.naming.*"%>
    <%@ page language="java" import="org.apache.activemq.ActiveMQConnectionFactory"%>
    <%
    try {
    InitialContext initCtx = new InitialContext();
    Context envContext = (Context) initCtx.lookup("java:comp/env");
    ConnectionFactory connectionFactory = (ConnectionFactory) envContext.lookup("jms/NormalConnectionFactory");
    Connection connection = connectionFactory.createConnection();
    Session jmsSession = connection.createSession(false, Session.AUTO_ACKNOWLEDGE);
    MessageProducer producer = jmsSession.createProducer((Destination) envContext.lookup("jms/topic/MyTopic"));
    //设置持久方式
    producer.setDeliveryMode(DeliveryMode.PERSISTENT);
    Message testMessage = jmsSession.createMessage();
    //发布刷新文章消息
    testMessage.setStringProperty("RefreshArticleId", "2046");
    producer.send(testMessage);
    //发布刷新帖子消息
    testMessage.clearProperties();
    testMessage.setStringProperty("RefreshThreadId", "331");
    producer.send(testMessage);
    } catch (NamingException e) {
    e.printStackTrace();
    } catch (JMSException e) {
    e.printStackTrace();
    }
    %>

    Publisher和Listner之间通过Message的setStringProperty和getStringProperty方法,实现对应的业务逻辑。
    上述示例代码中,RefreshArticleId代表刷新某篇文章,RefreshThreadId代表刷新某个帖子,property值保持对应的ID。当然用户可根据实际需求灵活地使用。

    5、运行Demo:
    5.1 启动ActiveMQ服务器
    5.2 启动Tomcat服务器:JMSListener将自动连接ActiveMQ broker,日志信息:
    Successfully connected to tcp://localhost:61616
    5.3 访问http://localhost:8080/jms-test/publish.jsp
    Tomcat服务器日志将提示:
    接收刷新文章消息,开始刷新文章ID=2046
    接收刷新论坛帖子消息,开始刷新帖子ID=331
    5.4 访问http://localhost:8161/admin/topics.jsp查看MY.TEST.FOO的消息日志,分别发送和接收2条。
    至此,已成功完成ActiveMQ与Tomcat的基本整合!
    Publisher和Listener完全可以独立部署到不同的Web服务器上,并通过ActiveMQ来进行消息传递,实现用户所需的业务逻辑。
    测试持久消息的具体步骤:
    l 启动Publisher所在Web服务器
    l 启动ActiveMQ
    l 访问publish.jsp发送消息,此时Listener还未启动,消息将保存在ActiveMQ的bin\activemq-data目录下,查看日志可以看到发送2条,接收0条
    l 启动Listener所在Web服务器,将自动接收到ActiveMQ的持久消息并处理,查看日志:发送2条,接收2条,表明持久消息应用成功

    http://www.cnblogs.com/shuyangdehou/archive/2010/10/07/1845239.html

    activeMQ相关:

    http://baike.baidu.com/view/157103.htm jms百度百科
    http://www.189works.com/article-57444-1.html ActiveMQ消息收发简单例子
    http://liyebing.iteye.com/blog/1044825 jms实现简单的聊天
    http://jinguo.iteye.com/blog/234311 一个生产者消费者实例
    http://blog.csdn.net/linkyou/article/details/4101152 activema文档
    http://i-coding.iteye.com/blog/1018920 activemq实现QQ聊天
    http://www.cnblogs.com/shuyangdehou/archive/2010/10/07/1845239.html activeMq教程
    http://www.cnblogs.com/opaljc/archive/2012/03/25/2416545.html activeMQ使用
    http://www.cnblogs.com/sjzzqy/archive/2012/05/29/activemq.html 例子

    通讯

    http://download.csdn.net/download/gaojie8273150/2290220
    http://download.csdn.net/detail/gaoweipeng/1635506
    http://download.csdn.net/download/qqq626/3081379

  • 相关阅读:
    负载均衡——LVS DR模式
    Java之BigDecimal详解
    Spring AOP代理对象创建流程
    spring aop切面不生效
    aspectj-autoproxy Controller未生效解决方案
    jvm参数分类
    dubbo优雅停机
    Dubbo 协议注意项
    dubbo provider
    查找java_home的安装路径
  • 原文地址:https://www.cnblogs.com/blsong/p/2704337.html
Copyright © 2011-2022 走看看