GitHub - joyrpc/joyrpc: high-performance, high-extensibility Java rpc framework.

下面就针对这套代码做一个详细的解析，希望能串联已学的知识点，实战演练，有所收获。

RPC 框架整体结构

首先说我们 RPC 框架的整体架构，这里请你回想下[第 07 讲]，在这一讲中我讲解了如何设计一个灵活的 RPC 框架，其关键点就是插件化，我们可以利用插件体系来提高 RPC 的扩展性，使其成为一个微内核架构，如下图所示：

这里我们可以看到，我们将 RPC 框架大体分为了四层，分别是入口层、集群层、协议层和传输层，而这四层中分别包含了一系列的插件，而在实际的 RPC 框架中插件会更多。在我所开源的 RPC 框架中就超过了 50 个插件，其中涉及到的代码量也是相当大的，下面就通过服务端启动流程、调用端启动流程、RPC 调用流程这三大流程来将 RPC 框架的核心模块以及核心类串联起来，理解了这三大流程会对你阅读代码有非常大的帮助。

服务端启动流程

在讲解服务启动流程之前，我们先看下服务端启动的代码示例，如下：

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

    DemoService demoService = new DemoServiceImpl(); //服务提供者设置
    ProviderConfig<DemoService> providerConfig = new ProviderConfig<>();
    providerConfig.setServerConfig(new ServerConfig());
    providerConfig.setInterfaceClazz(DemoService.class.getName());
    providerConfig.setRef(demoService);
    providerConfig.setAlias("joyrpc-demo");
    providerConfig.setRegistry(new RegistryConfig("broadcast"));

    providerConfig.exportAndOpen().whenComplete((v, t) -> {
        if (t != null) {
            logger.error(t.getMessage(), t);
            System.exit(1);
        }
    });

    System.in.read();

}

我们可以看出，providerConfig 是通过调用 exportAndOpen() 方法来启动服务端的，那么为何这个方法要如此命名呢？

我们可以看下 exportAndOpen 方法的代码实现：

public CompletableFuture<Void> exportAndOpen() {

    CompletableFuture<Void> future = new CompletableFuture<>();
    export().whenComplete((v, t) -> {
        if (t != null) {
            future.completeExceptionally(t);
        } else {
            Futures.chain(open(), future);
        }
    });

    return future;

}

这里服务的启动流程被分为了两个部分，export（创建 Export 对象）以及 open（打开服务）。而服务端的启动流程也被分为了两部分：服务端的创建流程与服务端的开启流程。

服务端创建流程

这里的 ProviderConfig 是服务端的配置对象，其中接口、分组、注册中心配置等等的相关信息都在这个配置类中配置，流程的入口是调用 ProviderConfig 的 export 方法，整个流程如下：

1. 根据 ProviderConfig 的配置信息生成 registryUrl（注册中心 URL 对象）与 serviceUrl（服务 URL 对象）；

2. 根据 registryUrl，调用 Registry 插件，创建 Registry 对象，Registry 对象为注册中心对象，与注册中心进行交互；

3. 调用 Registry 对象的 open 方法，开启注册中心对象，也就是与注册中心建立连接；

4. 调用 Registry 对象的 subscribe 方法，订阅接口的配置信息与全局配置信息；

5. 调用 InvokerManager，创建 Exporter 对象；

6. InvokerManager 返回 Exporter 对象。

服务端的创建流程实际上就是 Exporter 对象，Exporter 对象是调用器 Invoker 接口的子类，Invoker 接口有两个子类，分别是 Exporter 与 Refer，Exporter 用来处理服务端接收的请求，而 Refer 用来向服务端发送请求，这两个类可以说是入口层最为核心的两个类。

在 InvokerManager 创建 Exporter 对象时实际上会有一系列的操作，而初始化 Exporter 也会有一系列的操作，如创建 Filter 链、创建认证信息等等。这里不再详细叙述，可以阅读下源码。

服务端开启流程

创建完服务端的 Exporter 对象之后，我们就要开启 Exporter 对象，开启 Exporter 对象最重要的两个操作就是开启传输层中 Server 的端口，用来接收调用端发送过来的请求，以及将服务端节点注册到注册中心上，让调用端可以发现到这个服务节点，整个流程如下：

1. 调用 Exporter 对象的 open 方法，开启服务端；

2. Exporter 对象调用接口预热插件，进行接口预热；

3. Exporter 对象调用传输层中的 EndpointFactroy 插件，创建一个 Server 对象，一个 Server 对象就代表一个端口了；

4. 调用 Server 对象的 open 方法，开启端口，端口开启之后，服务端就可以提供远程服务了；

5. Exporter 对象调用 Registry 对象的 register 方法，将这个调用端节点注册到注册中心中。

这里无论是 Exporter 的 open 方法、Server 的 open 还是 Registry 的 register 方法，都是异步方法，返回值为 CompletableFuture 对象，这个流程的每个环节也都是异步的。

Server 的 open 操作实际上是一个比较复杂的操作，要绑定协议适配器、初始化 session 管理器、添加 eventbus 事件监听等等的操作，而且整个流程完全异步，并且是插件化的。

调用端启动流程

在讲解调用端启动流程之前，我们还是先看下代码示例，调用端启动代码示例如下：

public static void main(String[] args) {

    ConsumerConfig<DemoService> consumerConfig = new ConsumerConfig<>(); //consumer设置
    consumerConfig.setInterfaceClazz(DemoService.class.getName());
    consumerConfig.setAlias("joyrpc-demo");
    consumerConfig.setRegistry(new RegistryConfig("broadcast"));

    try {
        CompletableFuture<DemoService> future = consumerConfig.refer();
        DemoService service = future.get();

        String echo = service.sayHello("hello"); //发起服务调用
        logger.info("Get msg: {} ", echo);
    } catch (Throwable e) {
        logger.error(e.getMessage(), e);
    }

    System.in.read();

}

调用端流程的启动入口就是 ConsumerConfig 对象的 refer 方法，ConsumerConfig 对象就是调用端的配置对象，这里可以看到 refer 方法的返回值是 CompletableFuture，与服务端相同，调用端的启动流程也完全是异步的，下面我们来看下调用端的启动流程。

 调用端具体流程如下：

1. 根据 ConsumerConfig 的配置信息生成 registryUrl（注册中心 URL 对象）与 serviceUrl（服务 URL 对象）；

2. 根据 registryUrl，调用 Registry 插件，创建 Registry 对象，Registry 对象为注册中心对象，与注册中心进行交互；

3. 创建动态代理对象；

4. 调用 Registry 对象的 Open 方法，开启注册中心对象；

5. 调用 Registry 对象 subscribe 方法，订阅接口的配置信息与全局配置信息；

6. 调用 InvokeManager 的 refer 方法，用来创建 Refer 对象；

7. InvokeManager 在创建 Refer 对象之前会先创建 Cluster 对象，Cluser 对象是集群层的核心对   象，Cluster 会维护该调用端与服务端节点的连接状态；

8. InvokeManager 创建 Refer 对象；

9. Refer 对象初始化，其中主要包括创建路由策略、消息分发策略、创建负载均衡、调用链、添加 eventbus 事件监听等等；

10. ConsumerConfig 调用 Refer 的 open 方法，开启调用端；

11. Refer 对象调用 Cluster 对象的 open 方法，开启集群；

12. Cluster 对象调用 Registry 对象的 subcribe 方法，订阅服务端节点变化，收到服务端节点变化时，Cluster 会调用传输层 EndpointFactroy 插件，创建 Client 对象，与这些服务节点建立连接，Cluster 会维护这些连接；

13. ConsumerConfig 调用 Refer 对象封装到 ConsumerInvokerHandler 中，将 ConsumerInvokerHandler 对象注入给动态代理对象。

在调用端的开启流程中，最复杂的操作就是 Cluster 对象的 open 操作以及 Client 对象的 open 操作。

Cluster 对象是集群层的核心对象，也是这个 RPC 框架中处理逻辑最为复杂的对象，Cluster 对象负责维护该调用端节点集群信息，监听注册中心推送的服务节点更新事件，调用传输层中的 EndpointFactroy 插件，创建 Client 对象，并且会通过 Client 与服务端节点建立连接，发送协商信息、安全验证信息、心跳信息，通过心跳机制维护与服务节点的连接状态。

Client 对象的 open 操作也是有着一系列的操作，比如创建 Transport 对象，创建 Channel 对象，生成并记录 session 信息等等。

Refer 对象在构造调用链的时候，其最后一个调用链就是 Refer 对象的 distribute 方法，用来发送远程请求。

动态代理对象内部的核心逻辑就是调用 ConsumerInvokerHandler 对象的 Invoke 方法，最终就是调用 Refer 对象，会在下面的 RPC 调用流程中详细讲下。

RPC 调用流程

讲解完了服务端的启动流程与调用端的启动流程，下面我开始讲解 RPC 的调用流程。RPC 的整个调用流程就是调用端发送请求消息以及服务端接收请求消息并处理，之后响应给调用端的流程。

下面讲解下调用端的发送流程与服务端的接收流程。

调用端发送流程

 调用端发送流程如下：

1.  动态代理对象调用 ConsumerInvokerHandler 对象的 Invoke 方法；

2. ConsumerInvokerHandler 对象生成请求消息对象；

3. ConsumerInvokerHandler 对象调用 Refer 对象的 Invoke 方法；

4. Refer 对象对请求消息对象进行处理，如设置接口信息、分组信息等等；

5. Refer 对象调用消息透传插件，处理透传信息，其中就包括隐式参数信息；

6. Refer 对象调用 FilterChain 对象的 Invoker 方法，执行调用链；

7. FilterChain 对象调用每个 Filter；

8. Refer 对象的 distribute 方法作为最后一个 Filter，被调用链最后一个执行。

9. 调用 NodeSelecter 对象的 select 方法，NodeSelecter 是集群层的路由规则节点选择器，其 select 方法用来选择出符合路由规则的服务节点；

10. 调用 Route 对象的 route 方法，Route 对象为路由分发器，也是集群层中的对象，默认为路由分发策略为 Failover，即请求失败后可以重试请求，异常重试发送在 RPC 调用中的哪个环节，其实就在此环节；

11. Route 对象调用 LoadBalance 对象的 select 方法，通过负载均衡选择一个节点；

12. Route 对象回调 Refer 对象的 invokeRemote 方法；

13. Refer 对象的 invokeRemote 方法调用传输层中 Client 对象，向服务端节点发送消息。

在调用端发送流程中，最终会通过传输层将消息发送给服务端，这里对传输层的操作没有详细的讲解，其实传输层内部的流程还是比较复杂的，也会有一系列的操作，比如创建 Future 对象、调用 FutureManager 管理 Future 对象、请求消息协议转换处理、编解码、超时处理等等的操作。

当调用端发送完请求消息之后，服务端就会接收到请求消息并对请求消息进行处理。接下来我们看服务端的接收流程。

服务端接收流程

服务端的传输层会接收到请求消息，并对请求消息进行编解码以及反序列化，之后调用 Exporter 对象的 invoke 方法，具体流程如下：

1. 传输层接收到请求，触发协议适配器 ProtocolAdapter；

2. ProtocolAdapter 对象遍历 Protocol 插件的实现类，匹配协议；

3. 匹配协议之后，根据 Protocol 对象，传输层的 Server 对象绑定该协议的编解码器（Codec 对象）、Channel 处理链（ChainChannelHandler 对象）；

4. 对接收的消息进行解码与反序列化；

5. 执行 Channel 处理链；

6. 在业务线程池中调用消息处理链（MessageHandle 插件）；

7. 调用 BizReqHandle 对象的 handle 方法，处理请求消息；

8. BizReqHandle 对象调用 restore 方法，根据连接 Session 信息，处理请求消息数据，并根据请求的接口名、分组名与方法名，获取 Exporter 对象；

9. 调用 Exporter 对象的 invoke 方法，Exporter 对象返回 CompletableFuture 对象；

10. Exporter 对象调用 FilterChain 的 invoke 方法；

11.FilterChain 执行所有 Filter 对象；

12.Exporter 对象的 invokeMethod 方法作为最后一个 Filter，最后被调用；

13. Exporter 对象的 invokeMethod 方法处理请求上下文，执行反射；

14.  Exporter 对象将执行反射之后得到的请求结果异步通知给 BizReqHandle 对象；

15. BizReqHandle 调用传输层的 Channel 对象，发送响应结果；

15. 传输层对响应消息进行协议转换、序列化、编码，最后通过网络传输响应给调用端。

总结

今天我们剖析了一款开源的 RPC 框架的代码，主要通过服务端启动流程、调用端启动流程、RPC 调用流程这三大流程来将 RPC 框架的核心模块以及核心类串联起来。

在服务端的启动流程中，核心工作就是创建和开启 Exporter 对象。ProviderConfig 在创建 Exporter 对象之前会先创建 Registry 对象，从注册中心中订阅接口配置与全局配置，之后才会创建 Exporter 对象，在 Exporter 开启时，会启动一个 Server 对象来开启一个端口，Exporter 开启成功之后，才会通过 Registry 对象向注册中心发起注册。

在调用端的启动流程中，核心工作就是创建和开启 Refer 对象，开启 Refer 对象中处理逻辑最为复杂的就是对 Cluster 的 open 操作，Cluster 负责了调用端的集群管理操作，其中有注册中心服务节点变更事件的监听、与服务端节点建立连接以及服务端节点连接状态的管理等等。

调用端向服务端发起调用时，会先经过动态代理，之后会调用 Refer 对象的 invoke 方法，Refer 对象会先对要透传的消息进行处理，再执行 Filter 链，调用端最后一个 Filter 会根据配置的路由规则选择出符合条件的一组服务端节点，之后调用 Route 对象的 route 方法，route 方法的内部逻辑会根据配置的负载均衡策略选择一个服务端节点，最后向这个服务端节点发送请求消息。

服务端的传输层收到调用端发送过来的请求消息，在对请求消息进行一系列处理之后（如解码、反序列化、协议转换等等），会在业务线程池中处理消息，关键的逻辑就是调用 Exporter 对象的 invoke 方法，Exporter 对象的 invoke 方法会执行服务端配置的 Filter 链，最终通过反射或预编译对象执行业务逻辑，再将最终结果封装成响应消息，通过传输层响应给调用端。

本讲在调用端向服务端发起调用时，没有讲到异步调用，实际上 Refer 对象的 invoke 方法的实现逻辑完全是异步的，同样 Exporter 对象的 invoke 方法也是异步的，Refer 类与 Exporter 类都是调用端 Invoker 接口的实现类，可以看下 Invoker 接口中 invoke 方法的定义:

 /**
  * 调用
  *
  * @param request 请求
  * @return
  */

 CompletableFuture<Result> invoke(RequestMessage<Invocation> request);

JoyRPC 框架是一个纯异步的 RPC 框架，所谓的同步只不过是对异步进行了等待。

入口层的核心对象就是 Exporter 对象与 Refer 对象，这两个类承担了入口层的大多数核心逻辑。

集群层的核心对象就是 Cluster 对象与 Registry 对象，Cluser 对象的内部逻辑还是非常复杂的，核心逻辑就是与 Registry 交互，订阅服务端节点变更事件，以及对与服务端节点建立的连接的管理，这里我们对 Cluser 对象没有进行过多介绍，可以去查看代码。

协议层的核心对象就是 Protocol 接口的各个子类了。

接下来就是传输层了，传输层的具体实现我们在本讲也没有过多介绍，因为很难通过有限的内容把它讲解完整，还是建议你去查看下源码，一目了然。传输层是纯异步的并且是完全插件化的，其入口就是 EndpointFactroy 插件，通过 EndpointFactroy 插件获取一个 EndpointFactroy 对象，EndpointFactroy 对象是一个工厂类，用来创建 Client 对象与 Server 对象。

对于一个完善的 RPC 框架，今天我们仅是针对服务端启动流程、调用端启动流程、RPC 调用流程这三个主流程做了一个大致的讲解，真正实现起来还是要复杂许多，因为涉及到了很多细节上的问题，但主要脉络出来以后，相信也会对你有很大帮助，更多的细节就还是要靠你自己去阅读源码啦！