ActiveMQ + AJAX 实现web端收发消息

ActiveMQ支持Ajax，可以利用ActiveMQ的消息队列，来创建高度实时的web应用，例如实现web即时通讯。
Apache-activemq的目录下有一个官方的例子，webapps-demo . 官方的说明在这 http://activemq.apache.org/ajax.html

下面，我们用Spring Boot 来实现 ActiveMQ 收发消息
项目地址 https://github.com/bnovil/AmqMessage

---

1.新建maven工程，引入依赖

<parent>
    <groupId>org.springframework.boot</groupId>
    <artifactId>spring-boot-starter-parent</artifactId>
    <version>1.5.3.RELEASE</version>
</parent>
<dependencies>
    <dependency>
        <groupId>org.apache.activemq</groupId>
        <artifactId>activemq-client</artifactId>
        <version>5.8.0</version>
    </dependency>
    <dependency>
        <groupId>org.apache.activemq</groupId>
        <artifactId>activemq-web</artifactId>
        <version>5.8.0</version>
    </dependency>
    <dependency>
        <groupId>org.springframework.boot</groupId>
        <artifactId>spring-boot-starter-web</artifactId>
    </dependency>
    <dependency>
        <groupId>org.springframework</groupId>
        <artifactId>spring-jms</artifactId>
        <version>4.3.8.RELEASE</version>
    </dependency>
    <dependency>
        <groupId>org.springframework.boot</groupId>
        <artifactId>spring-boot-starter</artifactId>
        <exclusions>
            <exclusion>
                <groupId>org.springframework.boot</groupId>
                <artifactId>spring-boot-starter-logging</artifactId>
            </exclusion>
        </exclusions>
    </dependency>
    <dependency>
        <groupId>org.springframework.boot</groupId>
        <artifactId>spring-boot-starter-log4j2</artifactId>
    </dependency>
    <dependency>
        <groupId>org.springframework.boot</groupId>
        <artifactId>spring-boot-starter-test</artifactId>
        <scope>test</scope>
    </dependency>
    <dependency>
        <groupId>com.lmax</groupId>
        <artifactId>disruptor</artifactId>
        <version>3.3.6</version>
    </dependency>
    <dependency>
        <groupId>org.springframework.boot</groupId>
        <artifactId>spring-boot-starter-freemarker</artifactId>
    </dependency>
</dependencies>

项目结构如下

---

2.配置servlet
注意要在servletContext中设置”org.apache.activemq.brokerURL”，这是ActiveMQ broker的地址， 我这里是本地的， “tcp://127.0.0.1:61616”

@Configuration
public class ServletBean {


    @Bean
    public ServletRegistrationBean amqServletRegistrationBean() {
        ServletRegistrationBean registrationBean = new ServletRegistrationBean();
        registrationBean.setServlet(new AjaxServlet());
        registrationBean.setLoadOnStartup(1);
        List<String> urlMappings=new ArrayList<String>();
        urlMappings.add("/amq/*");
        registrationBean.setUrlMappings(urlMappings);
        return registrationBean;
    }

    @Bean
    public ServletContextInitializer initializer() {
        return new ServletContextInitializer() {
            @Override
            public void onStartup(ServletContext servletContext) throws ServletException {
                servletContext.setInitParameter("org.apache.activemq.brokerURL", "tcp://127.0.0.1:61616");
            }
        };
    }
}

---

3.web

先在 ActiveMQ的目录下 webapps-demo/demo/js 找到三个js 文件

query-1.4.2.min.js
amq_jquery_adapter.js
js/amq.js

放入Spring Boot项目中 resource/static/js

然后创建两个页面，一个发送，一个接收, 具体见项目源码

---

4 . 启动项目
先启动ActiveMQ, 然后运行该项目, 打开网页
http://localhost:8081/send 发送方
http://localhost:8081/receive 接收方

测试一下收发消息，如下图

发送消息

接收消息

---

5.原理说明
ActiveMQ 在版本发布包中包含了web sample的demo,其中就包含js与ActiveMQ交互的库文件amq.js.
以5.8.0版本为例,该文件目录为
apache-activemq-5.8.0\webapps-demo\demo\js\amq.js这个js文件还依赖一些基于公共JavaScript框架的
适配器文件,比如依赖jQuery的适配器为amq_jquery_adapter.js. 因此,使用amq.js时,必须先引入
jquery库文件和适配器库文件amq_jquery_adapter.js,然后在引入amq.js.

amq.js里面提供了sendMessage方法可以发送消息到代理,而addListener和removeListener方法可以给
指定的的消息目的地添加或删除监听器,添加监听器后即可接收消息了.

在web页面使用sendMessage发送消息,其实是向后台的一个servlet发送请求,然后由该servlet发送消息给代理.
这个servlet的类由ActiveMQ提供(后面配置web.xml时介绍)

页面调用addListener注册监听器,其实也是发送请求给servlet,由servlet创建一个目的地的消费者,当该目的地
有消息时,servlet处理消息,并将消息处理响应发送给客户端.因为采用web的CS架构,servlet不能直接将响应发送
给客户端. 这里amq.js中其实是采用了一种页面轮询的方式向服务器请求消息,以便监听代理上指定的目的地.

简而言之就是,
发送消息: amq.js使用sendMessage发送消息给servlet,servlet在将消息发给代理.
接收消息: amq.js使用addListener注册监听器接收并处理消息,其实也是发送请求给servlet,servlet产生消息消费者
消费指定目的地的消息并产生客户端响应,amq.js使用一种特殊的轮询机制不断从服务器获取消息处理的响应.