RabbitMQ远程调用与优先级队列

RabbitMQ的优先级队列持有限数量的优先级:255,建议值介于1~10之间。

优先级队列

使用x-max-priority参数声明优先级队列,参数为1~255之间的正整数。Java示例:

Channel ch = ...;
Map<String, Object> args = new HashMap<String, Object>();
args.put("x-max-priority", 10);
ch.queueDeclare("my-priority-queue", true, false, false, args);

发布者可使用basic.properties中的优先级字段,在发布消息时设置优先级,数字越大表示优先级越高。

远程调用

FibonacciRpcClient fibonacciRpc = new FibonacciRpcClient();
String result = fibonacciRpc.call("4");
System.out.println( "fib(4) is " + result);

示例中RabbitMQ RPC服务发布了一个名为call的方法,方法发送一个阻塞的RPC请求,并等待回复。

回调队列

为了接收响应,需在请求中发送一个“回调”队列地址。

callbackQueueName = channel.queueDeclare().getQueue();

BasicProperties props = new BasicProperties
                            .Builder()
                            .replyTo(callbackQueueName)
                            .build();

channel.basicPublish("", "rpc_queue", props, message.getBytes());

AMQP 0-9-1协议预定义了一组消息属性,以下是常用属性:

deliveryMode

将消息标记为持久化(值为2)或瞬态(任何其他值)。

contentType

描述编码的mime类型,如:JSON编码,此属性值为:application / json。

replyTo

用于命名回调队列。

correlationId

correlationId将RPC响应与请求相关联,为每个RPC请求创建一个回调队列非常低效,可为每个客户端创建一个回调队列。这种情况引发一个新问题,队列到响应后不清楚响应属于哪个请求。所以,使用correlationId属性需为每个请求设置一个唯一的值。

在回调队列中收到一条消息时,查看该属性将响应与请求进行匹配,看到未知的correlationId值,可以安全地丢弃该消息。

客户端发送确认请求之前宕机,重启RPC服务器,将会再次处理请求,导致重复的响应,理想情况下RPC应该具有幂等性。

RPC工作过程

RabbitMQ RPC工作过程

如上图所示,发送RPC请求带有两个消息属性,replyTo:为请求创建匿名独占队列。correlationId:为每个请求设置唯一的值。

rpc_queue队列

RPC worker(aka:server):等待队列上的请求,请求出现时会执行该作业,使用replyTo字段标明的队列,将带有结果的消息发回客户端。

客户端:等待队列回复数据,消息出现时,检查correlationId属性值,与请求中的值匹配,则返回对应用程序的响应。

RPC注意事项

如果没有运行服务器,客户应该如何处理?

客户端是否该为RPC设置超时时间?

如果服务器出现故障引发异常,是否应将其转发给客户端?

在处理之前要防止无效的消息传入。

客户端示例代码

package com.xieyonghui.mqpc;

import java.io.IOException;
import java.util.concurrent.ArrayBlockingQueue;
import java.util.concurrent.BlockingQueue;
import com.rabbitmq.client.AMQP;
import com.rabbitmq.client.AMQP.BasicProperties;
import com.rabbitmq.client.Channel;
import com.rabbitmq.client.Connection;
import com.rabbitmq.client.ConnectionFactory;
import com.rabbitmq.client.DefaultConsumer;
import com.rabbitmq.client.Envelope;

public class Rpc {

  public static void main(String[] args) throws Exception {
    ConnectionFactory factory = new ConnectionFactory();
    factory.setHost("localhost");
    Connection connection = factory.newConnection();
    Channel channel = connection.createChannel();
    String callbackQueueName = channel.queueDeclare().getQueue();
    String corrId = "clusterId";
    BasicProperties props =
        new BasicProperties.Builder().correlationId(corrId).replyTo(callbackQueueName).build();
    channel.basicPublish("", "rpc_queue", props, "message".getBytes());
    final BlockingQueue<String> response = new ArrayBlockingQueue<String>(1);

    String ctag = channel.basicConsume(callbackQueueName, true, new DefaultConsumer(channel) {
      @Override
      public void handleDelivery(String consumerTag, Envelope envelope,
          AMQP.BasicProperties properties, byte[] body) throws IOException {
        String res = new String(body, "UTF-8");
        if (properties.getCorrelationId().equals(corrId)) {
          response.offer(res);
        }
      }
    });
    String result = response.take();
    channel.basicCancel(ctag);
    System.out.println(result);
  }

}

服务端示例代码

package com.xieyonghui.mqpc;

import java.io.IOException;
import com.rabbitmq.client.AMQP;
import com.rabbitmq.client.Channel;
import com.rabbitmq.client.Connection;
import com.rabbitmq.client.ConnectionFactory;
import com.rabbitmq.client.Consumer;
import com.rabbitmq.client.DefaultConsumer;
import com.rabbitmq.client.Envelope;

public class RpcServer {

  static String RPC_QUEUE_NAME = "rpc_queue";

  public static void main(String[] args) throws Exception {

    ConnectionFactory factory = new ConnectionFactory();
    factory.setHost("localhost");

    Connection connection = null;
    connection = factory.newConnection();
    final Channel channel = connection.createChannel();

    channel.queueDeclare(RPC_QUEUE_NAME, false, false, false, null);
    channel.queuePurge(RPC_QUEUE_NAME);

    channel.basicQos(1);

    System.out.println(" [x] Awaiting RPC requests");

    Consumer consumer = new DefaultConsumer(channel) {
      @Override
      public void handleDelivery(String consumerTag, Envelope envelope,
          AMQP.BasicProperties properties, byte[] body) throws IOException {
        AMQP.BasicProperties replyProps =
            new AMQP.BasicProperties.Builder().correlationId(properties.getCorrelationId()).build();

        String response = "";

        try {
          String message = new String(body, "UTF-8");

          response += "hello !" + message;
          System.out.println(response);
        } catch (RuntimeException e) {
          System.out.println(" [.] " + e.toString());
        } finally {
          channel.basicPublish("", properties.getReplyTo(), replyProps, response.getBytes("UTF-8"));
          channel.basicAck(envelope.getDeliveryTag(), false);
          synchronized (this) {
            this.notify();
          }
        }
      }
    };

    channel.basicConsume(RPC_QUEUE_NAME, false, consumer);
    while (true) {
      synchronized (consumer) {
        try {
          consumer.wait();
        } catch (InterruptedException e) {
          e.printStackTrace();
        }
      }
    }
  }

}