RabbitMQ与java、Spring结合实例详细讲解
林炳文Evankaka原创作品。转载请注明出处http://blog.csdn.net/evankaka
摘要:本文介绍了rabbitMq,提供了如何在Ubuntu下安装RabbitMQ 服务的方法。最好以RabbitMQ与java、Spring结合的两个实例来演示如何使用RabbitMQ。
一、rabbitMQ简介
1.1、rabbitMQ的优点(适用范围)
1. 基于erlang语言开发具有高可用高并发的优点,适合集群服务器。
2. 健壮、稳定、易用、跨平台、支持多种语言、文档齐全。
3. 有消息确认机制和持久化机制,可靠性高。
4. 开源
其他MQ的优势:
1. Apache ActiveMQ曝光率最高,但是可能会丢消息。
2. ZeroMQ延迟很低、支持灵活拓扑,但是不支持消息持久化和崩溃恢复。
1.2、几个概念说明
producer&Consumer
producer指的是消息生产者,consumer消息的消费者。
Queue
消息队列,提供了FIFO的处理机制,具有缓存消息的能力。rabbitmq中,队列消息可以设置为持久化,临时或者自动删除。
设置为持久化的队列,queue中的消息会在server本地硬盘存储一份,防止系统crash,数据丢失
设置为临时队列,queue中的数据在系统重启之后就会丢失
设置为自动删除的队列,当不存在用户连接到server,队列中的数据会被自动删除Exchange
Exchange类似于数据通信网络中的交换机,提供消息路由策略。rabbitmq中,producer不是通过信道直接将消息发送给queue,而是先发送给Exchange。一个Exchange可以和多个Queue进行绑定,producer在传递消息的时候,会传递一个ROUTING_KEY,Exchange会根据这个ROUTING_KEY按照特定的路由算法,将消息路由给指定的queue。和Queue一样,Exchange也可设置为持久化,临时或者自动删除。
Exchange有4种类型:direct(默认),fanout, topic, 和headers,不同类型的Exchange转发消息的策略有所区别:
Direct
直接交换器,工作方式类似于单播,Exchange会将消息发送完全匹配ROUTING_KEY的Queue
fanout
广播是式交换器,不管消息的ROUTING_KEY设置为什么,Exchange都会将消息转发给所有绑定的Queue。
topic
主题交换器,工作方式类似于组播,Exchange会将消息转发和ROUTING_KEY匹配模式相同的所有队列,比如,ROUTING_KEY为user.stock的Message会转发给绑定匹配模式为 * .stock,user.stock, * . * 和#.user.stock.#的队列。( * 表是匹配一个任意词组,#表示匹配0个或多个词组)
headers
消息体的header匹配(ignore)
Binding
所谓绑定就是将一个特定的 Exchange 和一个特定的 Queue 绑定起来。Exchange 和Queue的绑定可以是多对多的关系。
virtual host
在rabbitmq server上可以创建多个虚拟的message broker,又叫做virtual hosts (vhosts)。每一个vhost本质上是一个mini-rabbitmq server,分别管理各自的exchange,和bindings。vhost相当于物理的server,可以为不同app提供边界隔离,使得应用安全的运行在不同的vhost实例上,相互之间不会干扰。producer和consumer连接rabbit server需要指定一个vhost。
1.3、消息队列的使用过程
1. 客户端连接到消息队列服务器,打开一个channel。
2. 客户端声明一个exchange,并设置相关属性。
3. 客户端声明一个queue,并设置相关属性。
4. 客户端使用routing key,在exchange和queue之间建立好绑定关系。
5. 客户端投递消息到exchange。
6. exchange接收到消息后,就根据消息的key和已经设置的binding,进行消息路由,将消息投递到一个或多个队列里
二、环境配置与安装
1、Erlang环境安装
RabbitMQ是基于Erlang的,所以首先必须配置Erlang环境。
从Erlang的官网 http://www.erlang.org/download.html 下载最新的erlang安装包,我下载的版本是 otp_src_R14B03.tar.gz 。然后:
-
$ tar xvzf otp_src_R14B03.tar.gz
-
$ cd otp_src_R14B03
-
$ ./configure
编译后的输出
如下图:
注:
可能会报错 configure: error: No curses library functions found
configure: error: /bin/sh '/home/liyixiang/erlang/configure' failed for erts
原因是缺少ncurses包
解决:在ubuntu系统下-
apt-cache search ncurses
-
apt-get install libncurses5-dev
然后重新执行
./configure
提示没有wxWidgets和fop、ssh、odbc、ssl,但是问题不大。继续:
make
然后:
sudo make install
配置erlang环境变量
修改/etc/profile文件,增加下面的环境变量:(vim profile i插入 编辑完毕ESC退出 wq!强制修改)
-
#set erlang environment
-
export PATH=$PATH:/usr/erlang/bin:$PATH
-
source profile使得文件生效
下面是我的
2、RabbitMQ-Server安装
安装完Erlang,开始安装RabbitMQ-Server。安装方法有三种,这里笔者三者都试过了,就只有以下这个方法成功了。
直接使用:
apt-get install rabbitmq-server
安装完成后会自动打开:
使用命令查看rabbitmq运行状态:
rabbitmqctl status
停止
rabbitmqctl stop
开启
rabbitmq-server start
3、rabbitmq web管理页面插件安装
输入以下命令
-
cd /usr/lib/rabbitmq/bin/
-
rabbitmq-plugins enable rabbitmq_management
这里笔者一直安装不成功。
如果安装成功打开浏览器,输入 http://[server-name]:15672/ 如 http://localhost:15672/ ,会要求输入用户名和密码,用默认的guest/guest即可(guest/guest用户只能从localhost地址登录,如果要配置远程登录,必须另创建用户)。
如果要从远程登录怎么做呢?处于安全考虑,guest这个默认的用户只能通过http://localhost:15672来登录,其他的IP无法直接用这个guest帐号。这里我们可以通过配置文件来实现从远程登录管理界面,只要编辑/etc/rabbitmq/rabbitmq.config文件(没有就新增),添加以下配置就可以了。
4、添加用户
vim /etc/rabbitmq/rabbitmq.config
然后添加 -
[
-
{rabbit, [{tcp_listeners, [5672]}, {loopback_users, ["asdf"]}]}
-
].
现在添加了一个新授权用户asdf,可以远程使用这个用户名。记得要先用命令添加这个命令才行:
cd /usr/lib/rabbitmq/bin/
#用户名与密码 sudo rabbitmqctl add_user asdf 123456
用户设置为administrator才能远程访问 -
sudo rabbitmqctl set_user_tags asdf administrator
-
sudo rabbitmqctl set_permissions -p / asdf ".*" ".*" ".*"
其实也可以通过管理平台页面直接添加用户和密码等信息。如果还不能远程访问或远程登录检查是不是5672, 15672端口没有开放!!!!!!
5、开放端口
ufw allow 5672
三、简单Java实例
-
package com.lin;
-
-
import java.io.IOException;
-
-
import com.rabbitmq.client.Channel;
-
import com.rabbitmq.client.Connection;
-
import com.rabbitmq.client.ConnectionFactory;
-
-
/**
-
*
-
* 功能概要: EndPoint类型的队列
-
*
-
* @author linbingwen
-
* @since 2016年1月11日
-
*/
-
public abstract class EndPoint{
-
-
protected Channel channel;
-
protected Connection connection;
-
protected String endPointName;
-
-
public EndPoint(String endpointName) throws IOException{
-
this.endPointName = endpointName;
-
-
//Create a connection factory
-
ConnectionFactory factory = new ConnectionFactory();
-
-
//hostname of your rabbitmq server
-
factory.setHost("10.75.4.25");
-
factory.setPort(5672);
-
factory.setUsername("asdf");
-
factory.setPassword("123456");
-
-
//getting a connection
-
connection = factory.newConnection();
-
-
//creating a channel
-
channel = connection.createChannel();
-
-
//declaring a queue for this channel. If queue does not exist,
-
//it will be created on the server.
-
channel.queueDeclare(endpointName, false, false, false, null);
-
}
-
-
-
/**
-
* 关闭channel和connection。并非必须,因为隐含是自动调用的。
-
* @throws IOException
-
*/
-
public void close() throws IOException{
-
this.channel.close();
-
this.connection.close();
-
}
-
}
2、消息提供者
-
package com.lin.producer;
-
-
import java.io.IOException;
-
import java.io.Serializable;
-
-
import org.apache.commons.lang.SerializationUtils;
-
-
import com.lin.EndPoint;
-
-
-
/**
-
*
-
* 功能概要:消息生产者
-
*
-
* @author linbingwen
-
* @since 2016年1月11日
-
*/
-
public class Producer extends EndPoint{
-
-
public Producer(String endPointName) throws IOException{
-
super(endPointName);
-
}
-
-
public void sendMessage(Serializable object) throws IOException {
-
channel.basicPublish("",endPointName, null, SerializationUtils.serialize(object));
-
}
-
}
3、消息消费者
-
package com.lin.consumer;
-
-
import java.io.IOException;
-
import java.util.HashMap;
-
import java.util.Map;
-
-
import org.apache.commons.lang.SerializationUtils;
-
-
import com.lin.EndPoint;
-
import com.rabbitmq.client.AMQP.BasicProperties;
-
import com.rabbitmq.client.Consumer;
-
import com.rabbitmq.client.Envelope;
-
import com.rabbitmq.client.ShutdownSignalException;
-
-
-
/**
-
*
-
* 功能概要:读取队列的程序端,实现了Runnable接口
-
*
-
* @author linbingwen
-
* @since 2016年1月11日
-
*/
-
public class QueueConsumer extends EndPoint implements Runnable, Consumer{
-
-
public QueueConsumer(String endPointName) throws IOException{
-
super(endPointName);
-
}
-
-
public void run() {
-
try {
-
//start consuming messages. Auto acknowledge messages.
-
channel.basicConsume(endPointName, true,this);
-
} catch (IOException e) {
-
e.printStackTrace();
-
}
-
}
-
-
/**
-
* Called when consumer is registered.
-
*/
-
public void handleConsumeOk(String consumerTag) {
-
System.out.println("Consumer "+consumerTag +" registered");
-
}
-
-
/**
-
* Called when new message is available.
-
*/
-
public void handleDelivery(String consumerTag, Envelope env,
-
BasicProperties props, byte[] body) throws IOException {
-
Map map = (HashMap)SerializationUtils.deserialize(body);
-
System.out.println("Message Number "+ map.get("message number") + " received.");
-
-
}
-
-
public void handleCancel(String consumerTag) {}
-
public void handleCancelOk(String consumerTag) {}
-
public void handleRecoverOk(String consumerTag) {}
-
public void handleShutdownSignal(String consumerTag, ShutdownSignalException arg1) {}
-
}
4、测试
-
package com.lin.test;
-
-
import java.io.IOException;
-
import java.sql.SQLException;
-
import java.util.HashMap;
-
-
import com.lin.consumer.QueueConsumer;
-
import com.lin.producer.Producer;
-
-
public class Test {
-
public Test() throws Exception{
-
-
QueueConsumer consumer = new QueueConsumer("queue");
-
Thread consumerThread = new Thread(consumer);
-
consumerThread.start();
-
-
Producer producer = new Producer("queue");
-
-
for (int i = 0; i < 1000000; i++) {
-
HashMap message = new HashMap();
-
message.put("message number", i);
-
producer.sendMessage(message);
-
System.out.println("Message Number "+ i +" sent.");
-
}
-
}
-
-
/**
-
* @param args
-
* @throws SQLException
-
* @throws IOException
-
*/
-
public static void main(String[] args) throws Exception{
-
new Test();
-
}
-
}
-
<!-- rabbitmq客户端 -->
-
<dependencies>
-
<dependency>
-
<groupId>com.rabbitmq</groupId>
-
<artifactId>amqp-client</artifactId>
-
<version>3.0.4</version>
-
</dependency>
-
-
<dependency>
-
<groupId>commons-lang</groupId>
-
<artifactId>commons-lang</artifactId>
-
<version>2.6</version>
-
</dependency>
-
<dependency>
-
<groupId>org.apache.commons</groupId>
-
<artifactId>commons-lang3</artifactId>
-
<version>3.1</version>
-
</dependency>
-
</dependencies>
测试结果:
rabbitmqctl list_queues
这个命令是用来查看服务端中有多处个消息队列的。四、Rbbitmq与Spring结合使用
-
<project xmlns="http://maven.apache.org/POM/4.0.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
-
xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/xsd/maven-4.0.0.xsd">
-
<modelVersion>4.0.0</modelVersion>
-
<groupId>com.lin</groupId>
-
<artifactId>rabbit_c2</artifactId>
-
<version>0.0.1-SNAPSHOT</version>
-
<properties>
-
<!-- spring版本号 -->
-
<spring.version>3.2.8.RELEASE</spring.version>
-
<!-- log4j日志文件管理包版本 -->
-
<slf4j.version>1.6.6</slf4j.version>
-
<log4j.version>1.2.12</log4j.version>
-
<!-- junit版本号 -->
-
<junit.version>4.10</junit.version>
-
</properties>
-
-
<dependencies>
-
<!-- 添加Spring依赖 -->
-
<dependency>
-
<groupId>org.springframework</groupId>
-
<artifactId>spring-core</artifactId>
-
<version>${spring.version}</version>
-
</dependency>
-
<dependency>
-
<groupId>org.springframework</groupId>
-
<artifactId>spring-webmvc</artifactId>
-
<version>${spring.version}</version>
-
</dependency>
-
<dependency>
-
<groupId>org.springframework</groupId>
-
<artifactId>spring-context</artifactId>
-
<version>${spring.version}</version>
-
</dependency>
-
<dependency>
-
<groupId>org.springframework</groupId>
-
<artifactId>spring-context-support</artifactId>
-
<version>${spring.version}</version>
-
</dependency>
-
<dependency>
-
<groupId>org.springframework</groupId>
-
<artifactId>spring-aop</artifactId>
-
<version>${spring.version}</version>
-
</dependency>
-
<dependency>
-
<groupId>org.springframework</groupId>
-
<artifactId>spring-aspects</artifactId>
-
<version>${spring.version}</version>
-
</dependency>
-
<dependency>
-
<groupId>org.springframework</groupId>
-
<artifactId>spring-tx</artifactId>
-
<version>${spring.version}</version>
-
</dependency>
-
<dependency>
-
<groupId>org.springframework</groupId>
-
<artifactId>spring-jdbc</artifactId>
-
<version>${spring.version}</version>
-
</dependency>
-
<dependency>
-
<groupId>org.springframework</groupId>
-
<artifactId>spring-web</artifactId>
-
<version>${spring.version}</version>
-
</dependency>
-
-
<!--单元测试依赖 -->
-
<dependency>
-
<groupId>junit</groupId>
-
<artifactId>junit</artifactId>
-
<version>${junit.version}</version>
-
<scope>test</scope>
-
</dependency>
-
-
<!-- 日志文件管理包 -->
-
<!-- log start -->
-
<dependency>
-
<groupId>log4j</groupId>
-
<artifactId>log4j</artifactId>
-
<version>${log4j.version}</version>
-
</dependency>
-
<dependency>
-
<groupId>org.slf4j</groupId>
-
<artifactId>slf4j-api</artifactId>
-
<version>${slf4j.version}</version>
-
</dependency>
-
<dependency>
-
<groupId>org.slf4j</groupId>
-
<artifactId>slf4j-log4j12</artifactId>
-
<version>${slf4j.version}</version>
-
</dependency>
-
<!-- log end -->
-
-
<!--spring单元测试依赖 -->
-
<dependency>
-
<groupId>org.springframework</groupId>
-
<artifactId>spring-test</artifactId>
-
<version>${spring.version}</version>
-
<scope>test</scope>
-
</dependency>
-
-
<!--rabbitmq依赖 -->
-
<dependency>
-
<groupId>org.springframework.amqp</groupId>
-
<artifactId>spring-rabbit</artifactId>
-
<version>1.3.5.RELEASE</version>
-
</dependency>
-
-
<dependency>
-
<groupId>javax.validation</groupId>
-
<artifactId>validation-api</artifactId>
-
<version>1.1.0.Final</version>
-
</dependency>
-
-
<dependency>
-
<groupId>org.hibernate</groupId>
-
<artifactId>hibernate-validator</artifactId>
-
<version>5.0.1.Final</version>
-
</dependency>
-
-
</dependencies>
-
<build>
-
<resources>
-
<resource>
-
<directory>src/main/resources</directory>
-
<targetPath>${basedir}/target/classes</targetPath>
-
<includes>
-
<include>**/*.properties</include>
-
<include>**/*.xml</include>
-
</includes>
-
<filtering>true</filtering>
-
</resource>
-
<resource>
-
<directory>src/main/resources</directory>
-
<targetPath>${basedir}/target/resources</targetPath>
-
<includes>
-
<include>**/*.properties</include>
-
<include>**/*.xml</include>
-
</includes>
-
<filtering>true</filtering>
-
</resource>
-
</resources>
-
-
<plugins>
-
<plugin>
-
<groupId>org.apache.maven.plugins</groupId>
-
<artifactId>maven-compiler-plugin</artifactId>
-
<configuration>
-
<source>1.6</source>
-
<target>1.6</target>
-
<encoding>UTF-8</encoding>
-
</configuration>
-
</plugin>
-
<plugin>
-
<groupId>org.apache.maven.plugins</groupId>
-
<artifactId>maven-war-plugin</artifactId>
-
<version>2.1.1</version>
-
<configuration>
-
<warSourceExcludes>${warExcludes}</warSourceExcludes>
-
</configuration>
-
</plugin>
-
<plugin>
-
<groupId>org.apache.maven.plugins</groupId>
-
<artifactId>maven-surefire-plugin</artifactId>
-
<version>2.4.3</version>
-
<configuration>
-
<testFailureIgnore>true</testFailureIgnore>
-
</configuration>
-
</plugin>
-
<plugin>
-
<inherited>true</inherited>
-
<groupId>org.apache.maven.plugins</groupId>
-
<artifactId>maven-source-plugin</artifactId>
-
<executions>
-
<execution>
-
<id>attach-sources</id>
-
<goals>
-
<goal>jar</goal>
-
</goals>
-
</execution>
-
</executions>
-
</plugin>
-
<plugin>
-
<groupId>org.apache.maven.plugins</groupId>
-
<artifactId>maven-resources-plugin</artifactId>
-
<configuration>
-
<encoding>UTF-8</encoding>
-
</configuration>
-
</plugin>
-
</plugins>
-
</build>
-
</project>
2、消息生产者
-
package com.lin.producer;
-
-
import javax.annotation.Resource;
-
-
import org.slf4j.Logger;
-
import org.slf4j.LoggerFactory;
-
import org.springframework.amqp.core.AmqpTemplate;
-
import org.springframework.stereotype.Service;
-
-
/**
-
* 功能概要:消息产生,提交到队列中去
-
*
-
* @author linbingwen
-
* @since 2016年1月15日
-
*/
-
-
public class MessageProducer {
-
-
private Logger logger = LoggerFactory.getLogger(MessageProducer.class);
-
-
-
private AmqpTemplate amqpTemplate;
-
-
public void sendMessage(Object message){
-
logger.info("to send message:{}",message);
-
amqpTemplate.convertAndSend("queueTestKey",message);
-
}
-
}
-
package com.lin.consumer;
-
-
import org.slf4j.Logger;
-
import org.slf4j.LoggerFactory;
-
import org.springframework.amqp.core.Message;
-
import org.springframework.amqp.core.MessageListener;
-
-
/**
-
* 功能概要:消费接收
-
*
-
* @author linbingwen
-
* @since 2016年1月15日
-
*/
-
public class MessageConsumer implements MessageListener {
-
-
private Logger logger = LoggerFactory.getLogger(MessageConsumer.class);
-
-
-
public void onMessage(Message message) {
-
logger.info("receive message:{}",message);
-
}
-
-
}
4、rabbitMq.xml配置信息
-
<?xml version="1.0" encoding="UTF-8"?>
-
<beans xmlns="http://www.springframework.org/schema/beans"
-
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:rabbit="http://www.springframework.org/schema/rabbit"
-
xsi:schemaLocation="http://www.springframework.org/schema/beans
-
http://www.springframework.org/schema/beans/spring-beans-3.0.xsd
-
http://www.springframework.org/schema/beans
-
http://www.springframework.org/schema/beans/spring-beans-3.0.xsd
-
http://www.springframework.org/schema/rabbit
-
http://www.springframework.org/schema/rabbit/spring-rabbit-1.0.xsd">
-
<!--配置connection-factory,指定连接rabbit server参数 -->
-
<rabbit:connection-factory id="connectionFactory"
-
username="asdf" password="123456" host="10.75.4.25" port="5672" />
-
-
<!--定义rabbit template用于数据的接收和发送 -->
-
<rabbit:template id="amqpTemplate" connection-factory="connectionFactory"
-
exchange="exchangeTest" />
-
-
<!--通过指定下面的admin信息,当前producer中的exchange和queue会在rabbitmq服务器上自动生成 -->
-
<rabbit:admin connection-factory="connectionFactory" />
-
-
<!--定义queue -->
-
<rabbit:queue name="queueTest" durable="true" auto-delete="false" exclusive="false" />
-
-
<!-- 定义direct exchange,绑定queueTest -->
-
<rabbit:direct-exchange name="exchangeTest" durable="true" auto-delete="false">
-
<rabbit:bindings>
-
<rabbit:binding queue="queueTest" key="queueTestKey"></rabbit:binding>
-
</rabbit:bindings>
-
</rabbit:direct-exchange>
-
-
<!-- 消息接收者 -->
-
<bean id="messageReceiver" class="com.lin.consumer.MessageConsumer"></bean>
-
-
<!-- queue litener 观察 监听模式 当有消息到达时会通知监听在对应的队列上的监听对象-->
-
<rabbit:listener-container connection-factory="connectionFactory">
-
<rabbit:listener queues="queueTest" ref="messageReceiver"/>
-
</rabbit:listener-container>
-
-
</beans>
5、spring集成rabbiqMq。application.xml内容如下:
-
<?xml version="1.0" encoding="UTF-8"?>
-
<beans xmlns="http://www.springframework.org/schema/beans"
-
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:context="http://www.springframework.org/schema/context"
-
xmlns:p="http://www.springframework.org/schema/p"
-
xsi:schemaLocation="http://www.springframework.org/schema/beans http://www.springframework.org/schema/beans/spring-beans-3.1.xsd
-
http://www.springframework.org/schema/context http://www.springframework.org/schema/context/spring-context-3.1.xsd">
-
-
-
<import resource="classpath*:rabbitmq.xml" />
-
-
-
<!-- 扫描指定package下所有带有如
-
<context:component-scan base-package="com.lin.consumer,com.lin.producer" />
-
-
-
<!-- 激活annotation功能 -->
-
<context:annotation-config />
-
<!-- 激活annotation功能 -->
-
<context:spring-configured />
-
-
</beans>
6、最后,为了方便,打印了日志,log4j.properties配置如下
-
log4j.rootLogger=DEBUG,Console,Stdout
-
-
#Console
-
log4j.appender.Console=org.apache.log4j.ConsoleAppender
-
log4j.appender.Console.layout=org.apache.log4j.PatternLayout
-
log4j.appender.Console.layout.ConversionPattern=%d [%t] %-5p [%c] - %m%n
-
-
log4j.logger.java.sql.ResultSet=INFO
-
log4j.logger.org.apache=INFO
-
log4j.logger.java.sql.Connection=DEBUG
-
log4j.logger.java.sql.Statement=DEBUG
-
log4j.logger.java.sql.PreparedStatement=DEBUG
-
-
log4j.appender.Stdout = org.apache.log4j.DailyRollingFileAppender
-
log4j.appender.Stdout.File = E://logs/log.log
-
log4j.appender.Stdout.Append = true
-
log4j.appender.Stdout.Threshold = DEBUG
-
log4j.appender.Stdout.layout = org.apache.log4j.PatternLayout
-
log4j.appender.Stdout.layout.ConversionPattern = %-d{yyyy-MM-dd HH:mm:ss} [ %t:%r ] - [ %p ] %m%n