使用RPC方式开发服务消费者

概念阐述

透明RPC开发模式允许用户通过简单的java interface像本地调用一样进行服务调用。
透明RPC仅仅是一种开发模式：

• 与使用highway还是RESTful传输没有关联
• 与producer使用透明RPC/Jax-RS还是SpringMVC模式开发没有关联
• 也与producer代码是否实现这个interface没有关联。

透明RPC开发模式与spring boot的feign类似，不过更简单，因为不必在这个interface中增加任何RESTful annotation。

在spring bean中通过@RpcReference声明

@Component
public class SomeBean {
  ......

  @RpcReference(microserviceName = "helloService", schemaId = "helloSchema")
  private Hello hello;

  ......
}

脱离spring bean，直接通过api声明

Hello hello = Invoker.createProxy("helloService", "helloSchema", Hello.class);

reactive

只需要使用jdk的CompletableFuture对返回值进行包装即可

interface Hello {
  CompletableFuture<String> sayHi(String name);
}

同一个interface中，可以同时声明同一个方法的reactive和同步原型
因为要求方法名与契约中的operationId一一对应，而仅有返回值类型不同，在java中是非法的，所以需要修改方法名，并通过swagger annotation来声明真正的operationId

interface Hello {
  String sayHi(String name);

  @ApiOperation(nickname = "sayHi", value = "reactive method for sayHi")
  CompletableFuture<String> asyncSayHi(String name);
}