终篇:理解并使用RabbitMQ
说明
RabbitMQ中MQ是MessageQueue的简写,整体的意思应该是像兔子一样快的高效消息中间件,组件本质上就是生产者消费者模式,由一边接受消息,另一边转发消息,其中可以对消息进行缓存,转发或清除。
一般实际中使用情况是推送和IM(及时通讯)
如何使用
首先要含有封装底层的jar包,下载RabbitMQ-java-Client,下载之后放在AndroidStudio项目中libs包中编译,或者在module中build.gradle中添加依赖:
dependencies {
compile 'com.rabbitmq:amqp-client:4.2.0'
}
RabbitMQ是由pivotal公司开源的一个项目,在Github上可以查看的源码。
需要访问网络,不要忘记在清单文件中添加网络权限:
<uses-permission android:name="android.permission.INTERNET"/>
一张简易的图表示工作原理:
RabbitMQ.png连接
首先配置连接服务端基本信息:
ConnectionFactory factory = new ConnectionFactory(); //创建连接工厂
//设置服务端连接认证:ip号,端口号,登录名,密码
factory.setHost(“HOST_ID");
factory.setPort(PORT);
factory.setUsername("USERNAME");
factory.setPassword("PASSWORD")
factory.setAutomaticRecoveryEnabled(true); //设置自动恢复连接
factory.setNetworkRecoveryInterval(5000); //设置自动连接间隔(毫秒)
以上都是一些基本配置,设置服务端上认证信息,设置恢复连接机制,在已经连接过之后断开连接,会主动尝试连接服务,直至连接上服务或者关闭连接工厂。
如果第一没有连接上,则会报错。需要循环创建连接,直至第一次连接很成功之后才会自动连接,包括所有的通道(Channel)。
现在有了连接工厂,创建一个连接就够多个通道使用,也是高效率的方式:
Connection connection = factory.newConnection();
注意这个需要在子线程中执行,否则会报错误: Android.os.NetworkOnMainThreadException。
发送消息
- 建立通道及配置
- 发送消息
Channel channelSend = connection.createChannel();
//第一种方式,直接指定消费队列
1.channelSend.queueDeclare(queueName, false, false, false, null);
channelSend.basicPublish("", queueName, null, message.getBytes());
//第二种方式,指定转换器和绑定密钥(routingkey)
2.channelSend.exchangeDeclare(EXCHANGENAME, "topic"); //类型四种:fanout,direct,topic,handers
channelSend.basicPublish(EXCHANGENAME, routingkey, null, message.getBytes());
就是这么简单,但还是需要简单说明。
完整的流程:发送者->转换器->队列->接受者
第一种情况,虽然没有声明转换器,但是会使用匿名转换器,发送到routingKey为队列名的队列中。
第二种情况,只说明转换器的四种类型特点:
- fanout类型:忽略routingkey的值发送给所有绑定该类型的队列中,
- direct类型:根据routingkey的值发送给匹配该值的队列中,
- topic类型:它的routingKey可以使用*和#来表示,前者表示一个连着的单词,如work;后者表示零个或多个连着的单词,如work.first。只要发送消息的routingKey匹配接受者设置绑定exchange的routingKey的值,接受者队列就可以收到到由exchange发送的消息。
- headers类型:以匹配键值对的形式发送和接受消息。匹配有两种方式all和any。用的比较少,所以就没有深入了解。
接受消息
- 建立通道及配置
- 设置监听通道消息
Channel channel = connection.createChannel();
//不定义装换器(默认匿名装换器),命名队列,获取实时和缓存在队列中的消息
1. final Channel channel = connection.createChannel();
channel.queueDeclare(queueName, false, false, false, null);
channel.basicConsume(queueName, false, new DefaultConsumer(channel) {
@Override
public void handleDelivery(String consumerTag, Envelope envelope,
AMQP.BasicProperties properties, byte[] body)
throws IOException {
String message = new String(body, "UTF-8");
Log.d(TAG, queueName + "接受消息->" + message);
channel.basicAck(envelope.getDeliveryTag(), false); //消息应答
}
});
//自定义装换器名称和类型,匿名队列,监听符合routingKey的消息,只能获取实时消息
2. final Channel channel = connection.createChannel();
channel.exchangeDeclare(EXCHANGE_NAME, EXCHANGE_TYPE);
String queueName = channel.queueDeclare().getQueue();
channel.queueBind(queueName, EXCHANGE_NAME, routingKey);
channel.basicConsume(queueName, false, new DefaultConsumer(channel) {
@Override
public void handleDelivery(String consumerTag, Envelope envelope,
AMQP.BasicProperties properties, byte[] body)
throws IOException {
String message = new String(body, "UTF-8");
Log.d(TAG, routingKey + "接受消息->" + message);
channel.basicAck(envelope.getDeliveryTag(), false); //消息应答
}
});
//自定义装换器名称和类型,命名队列,监听符合routingKey的消息,获取实时和缓存在队列中的消息
3. final Channel channel = connection.createChannel();
channel.exchangeDeclare(EXCHANGE_NAME, EXCHANGE_TYPE);
channel.queueDeclare(queueName, false, false, false, null);
channel.queueBind(queueName, EXCHANGE_NAME, routingKey); //设置绑定
channel.basicConsume(queueName, false, new DefaultConsumer(channel) {
@Override
public void handleDelivery(String consumerTag, Envelope envelope,
AMQP.BasicProperties properties, byte[] body)
throws IOException {
String message = new String(body, "UTF-8");
Log.d(TAG, routingKey + queueName + "接受消息->" + message);
channel.basicAck(envelope.getDeliveryTag(), false); //消息应答
}
});
以上是主要的三种监听消息方式:
第一种,匿名转换器,命名队列,监听队列中的消息。只能一对一发送并且接受,局限比较大。
第二种,指定转换器类型,匿名队列,监听实时routingKey的消息,筛选出匹配routingKey消息进行发送,所以有可能发送到多个队列中。每次连接都是获取新的空的队列,并且失去连接后队列将被删除,所以只能获取实时的消息。
第三种,指定装换器类型,命名队列,监听队列中routingKey的消息,筛选出匹配routingKey消息进行发送,所以有可能发送到多个队列中。获取实时和缓存在队列中的消息
匿名队列的特点:
- 一旦被创建就是一个新的空的队列
- 一旦失去消费者连接该队列就会被服务端删除
命名队列特点:
- 默认循环均匀发送消息给多个消费者,但是可以设置channel.basicQos(1)高效的发送消息给多个消费者。
- 消息应答机制,服务端确认消息被销毁才会移除该消息。
- 队列和消息持久化,在服务端奔溃或者重启是可以保存队列和消息。
- 一个消息只能被一个消费者消费一次。
关闭
if (channelSend != null && channelSend.isOpen()) {
try {
channelSend.close();
} catch (IOException | TimeoutException e) {
e.printStackTrace();
}
}
if (channelReceive != null && channelReceive.isOpen()) {
try {
channelReceive.close();
} catch (IOException | TimeoutException e) {
e.printStackTrace();
}
}
if (connection != null && connection.isOpen()) {
try {
connection.close();
} catch (IOException e) {
e.printStackTrace();
}
}
封装RabbitMQ-Android的简单使用,欢迎下载使用,并且反馈。
注:这是RabbitMQ-java版Client的指导教程翻译系列文章,欢迎大家批评指正
第一篇Hello Word了解RabbitMQ的基本用法
第二篇Work Queues介绍队列的使用
第三篇Publish/Subscribe介绍转换器以及其中fanout类型
第四篇Routing介绍direct类型转换器
第五篇Topics介绍topic类型转换器
第六篇RPC介绍远程调用