12-rabbitmq-远程过程调用-spring

12-rabbitmq-远程过程调用

【博文总目录>>>】

---

【工程下载>>>】

先决条件

---

本教程假定RabbitMQ已在标准端口（5672）上的localhost上安装并运行。如果使用不同的主机，端口或凭据，连接设置将需要调整。

远程过程调用

---

在第二个教程中，我们学习了如何使用工作队列在多个工作人员之间分配耗时的任务。

但是，如果我们需要在远程计算机上运行功能并等待结果怎么办？那是一个不同的问题。此模式通常称为远程过程调用或RPC。

在本教程中，我们将使用RabbitMQ构建一个RPC系统：一个客户机和一个可扩展的RPC服务器。由于我们没有任何值得分发的耗时任务，我们将创建一个返回斐波纳契数字的虚拟RPC服务。

客户端界面

为了说明如何使用RPC服务，我们将从“Sender”和“Receiver”更改“Client”和“Server”的名称，当我们调用服务器时，我们将获得参数的fibonacci值。

Integer response = (Integer) template.convertSendAndReceive(exchange.getName(), "rpc", start++);System.out.println(" [.] Got '" + response + "'");

RPC注意事项

---

虽然RPC是一个很常见的计算模式，但它经常被批评。当程序员不知道函数调用是本地函数还是缓慢的RPC时，出现问题。这样的混乱导致了一个不可预测的系统，并增加了调试的不必要的复杂性。而不是简化软件，滥用RPC可能导致不可维护的意大利面条代码。

铭记这一点，请考虑以下建议：

• 确保显而易见哪个函数调用是本地的，哪个是远程的。
• 记录您的系统。使组件之间的依赖关系清除。
• 处理错误情况。当RPC服务器停机很长时间后，客户端应该如何反应？

当有疑问避免RPC。如果可以的话，您应该使用异步管道 - 而不是类似RPC的阻塞，将异步推送到下一个计算阶段。

回调队列

---

一般来说RPC对RabbitMQ来说很容易。客户端发送请求消息，服务器回复一条响应消息。为了收到响应，我们需要发送一个’回调’队列地址与请求。当我们使用上述’convertSendAndReceive（）’方法时，Spring-amqp的RabbitTemplate处理我们的回调队列。使用RabbitTemplate时，无需进行任何其他设置。有关详细解释，请参阅请求/回复消息。

消息属性

---

AMQP 0-9-1协议预先定义了一组14个随附消息的属性。大多数属性很少使用，除了以下内容：

• deliveryMode：将消息标记为persistent（值为2）或transient（任何其他值）。您可能会从第二个教程中记住此属性。
• contentType：用于描述mime类型的编码。例如对于经常使用的JSON编码，将此属性设置为：application / json是一个很好的做法。
• replyTo：通常用来命名一个回调队列。
• correlationId：用于将RPC响应与请求相关联。

相关标识（Correlation Id）

---

Spring-amqp允许您专注于您正在使用的消息样式，并隐藏支持此样式所需的消息管道的详细信息。例如，通常，本机客户端将为每个RPC请求创建一个回调队列。这是非常低效的，所以另一种方法是为每个客户端创建一个回调队列。

这引发了一个新问题，在该队列中收到响应，响应所属的请求不清楚。那就是在使用correlationId属性的时候 。Spring-amqp为每个请求自动设置唯一的值。此外，它还处理使用正确的correlationID匹配响应的细节。

spring-amqp使rpc样式更容易的一个原因是有时您可能想忽略回调队列中的未知消息，而不是失败。这是由于在服务器端发生竞争条件的可能性。虽然不太可能，RPC服务器可能会在发送答复之后，但在发送请求的确认消息之前死亡。如果发生这种情况，重新启动的RPC服务器将再次处理该请求。spring-amqp客户端优雅地处理重复的响应，RPC应该理想地是幂等的。

概要

---

我们的RPC将像这样工作：

• Tut6Config将设置一个新的DirectExchange和一个客户端
• 客户端将利用convertSendAndReceive传递交换名称，routingKey和消息。
• 请求被发送到rpc_queue（“tut.rpc”）队列。
• RPC 工作线程正在等待队列上的请求。当请求出现时，它执行任务，并使用replyTo字段中的队列将结果发送回客户端。
• 客户端等待回呼队列中的数据。当信息出现时，它检查correlationId属性。如果它与请求中的值相匹配，则返回对应用程序的响应。再次，这是通过RabbitTemplate自动完成的。

把它们放在一起

---

斐波纳契任务是一个@RabbitListener，定义为：

private static int fib(int n) {    if (n == 0) return 0;    if (n == 1) return 1;    return fib(n-1) + fib(n-2);}

我们声明我们的fibonacci功能。它只假定有效的正整数输入。（不要指望这个工作的大数字，这可能是最慢的递归实现）。

我们的Tut6Config的代码 如下所示：

package com.example.rabbitmq.tut6;import org.springframework.amqp.core.Binding;import org.springframework.amqp.core.BindingBuilder;import org.springframework.amqp.core.DirectExchange;import org.springframework.amqp.core.Queue;import org.springframework.context.annotation.Bean;import org.springframework.context.annotation.Configuration;import org.springframework.context.annotation.Profile;/** * Author: 王俊超 * Date: 2017-06-17 22:15 * All Rights Reserved !!! */@Profile({"tut6", "rpc"})@Configurationpublic class Tut6Config {    @Profile("client")    private static class ClientConfig {        @Bean        public DirectExchange exchange() {            return new DirectExchange("tut.rpc");        }        @Bean        public Tut6Client client() {            return new Tut6Client();        }    }    @Profile("server")    private static class ServerConfig {        @Bean        public Queue queue() {            return new Queue("tut.rpc.requests");        }        @Bean        public DirectExchange exchange() {            return new DirectExchange("tut.rpc");        }        @Bean        public Binding binding(DirectExchange exchange, Queue queue) {            return BindingBuilder.bind(queue).to(exchange).with("rpc");        }        @Bean        public Tut6Server server() {            return new Tut6Server();        }    }}

它将我们的配置文件设置为“tut6”或“rpc”。它还使用两个bean设置“客户端”配置文件;

• 1) 我们正在使用的DirectExchange，
• 2) Tut6Client本身。

我们还使用三个bean，“tut.rpc.requests”队列，与客户端交换器匹配的DirextExchange以及使用“rpc”路由密钥从队列到交换机的绑定来配置“服务器”的配置文件。

服务器代码相当简单：

像往常一样，我们开始用@RabbitListener注释我们的接收方法，并定义其监听的队列。

我们的fibanacci方法使用有效载荷参数调用fib（）并返回结果

我们的RPC客户端的代码Tut6Server.java：

package com.example.rabbitmq.tut6;import org.springframework.amqp.rabbit.annotation.RabbitListener;/** * Author: 王俊超 * Date: 2017-06-17 22:15 * All Rights Reserved !!! */public class Tut6Server {    @RabbitListener(queues = "tut.rpc.requests")    // @SendTo("tut.rpc.replies") used when the client doesn't set replyTo.    public int fibonacci(int n) {        System.out.println(" [x] Received request for " + n);        int result = fib(n);        System.out.println(" [.] Returned " + result);        return result;    }    public int fib(int n) {        return n <= 0 ? 0 : n == 1 ? 1 : (fib(n - 1) + fib(n - 2));    }}

客户端代码Tut6Client 与服务器一样简单：

• 我们自动连接Tut6Config中定义的RabbitTemplate和DirectExchange bean。
• 我们使用参数交换名称，路由密钥和消息调用template.convertSendAndReceive。
• 我们打印结果

客户端的请求非常简单的：

package com.example.rabbitmq.tut6;import org.springframework.amqp.core.DirectExchange;import org.springframework.amqp.rabbit.core.RabbitTemplate;import org.springframework.beans.factory.annotation.Autowired;import org.springframework.scheduling.annotation.Scheduled;/** * Author: 王俊超 * Date: 2017-06-17 22:15 * All Rights Reserved !!! */public class Tut6Client {    @Autowired    private RabbitTemplate template;    @Autowired    private DirectExchange exchange;    int start = 0;    @Scheduled(fixedDelay = 1000, initialDelay = 500)    public void send() {        System.out.println(" [x] Requesting fib(" + start + ")");        // 设置发送并且接收        Integer response = (Integer) template.convertSendAndReceive(exchange.getName(), "rpc", start++);        System.out.println(" [.] Got '" + response + "'");    }}

运行

---

先运行服务器，再运行接收器
启动服务器

--spring.profiles.active=rpc,server --tutorial.client.duration=6000

运行接收器

--spring.profiles.active=rpc,client --tutorial.client.duration=6000

说明

这里提出的设计不是RPC服务的唯一可能的实现，而是具有一些重要的优点：

• 如果RPC服务器太慢，可以通过运行另一个RPC服务器进行扩展。尝试在新的控制台中运行第二个RPCServer。
• 在客户端，RPC需要发送和接收一条消息。不需要像queueDeclare这样的同步调用 。因此，RPC客户端只需要一个网络往返单个RPC请求。

我们的代码仍然非常简单，不会尝试解决更复杂（但重要的）问题，例如：

• 如果没有服务器运行，客户端应该如何反应？
• 客户端是否需要RPC的某种超时时间？
• 如果服务器发生故障并引发异常，应该将其转发给客户端？
• 在处理之前防止无效的传入消息（例如检查边界，类型）。