源码解析: Feign ParseHandlersByName

作用

在build方法中我们创建的第二个重要组件。
观察它的apply方法可以猜到ParseHandlersByName的作用就是我们传入Target（封装了我们的模拟接口，要访问的域名），返回这个接口下的各个方法，对应的执行HTTP请求需要的一系列信息。
结果Map<String, MethodHandler>的key是这个接口中的方法名字，MethodHandler则是包含此方法执行需要的各种信息。

    public Map<String, MethodHandler> apply(Target key) 

创建

private final Contract contract;
private final Options options;
private final Encoder encoder;
private final Decoder decoder;
private final ErrorDecoder errorDecoder;
private final SynchronousMethodHandler.Factory factory;

ParseHandlersByName的创建除了我们在build方法里面创建好的SynchronousMethodHandler.Factory(https://www.jianshu.com/p/b11af0b51a72)以外。还有其他几个组件:

1. Contract
   作用是将我们传入的接口进行解析验证，看注解的使用是否符合规范，然后返回给我们接口上各种相应的元数据。所以叫合约。详见：https://www.jianshu.com/p/6582f8319f72
2. Options
   封装Request请求的 连接超时=默认10s ，读取超时=默认60s
3. Encoder
   怎么把我们的请求编码
4. Decoder
   怎么把我们执行HTTP请求后得到的结果解码为我们定义的类型
5. ErrorDecoder
   怎么在我们执行HTTP请求后得到的错误(既不是2xx的状态码)解码为我们定义的类型

所以前面五种组件的作用加起来是在干嘛呢？准备一个http请求执行前的各种数据，定义http执行后对于结果的各种处理逻辑。
随意这些组件的作用是 “处理每个HTTP执行前后的事情”
接着加上我们传入SynchronousMethodHandler.Factory的各种组件，还记得他们的作用么：“执行HTTP请求”。
所以当ParseHandlersByName这个组件创建好的时候，我们就已经准备好了执行这个HTTP请求所需要的一切了。

所以build方法的前2个组件包含了 “执行HTTP请求”和“处理每个HTTP执行前后的事情”的能力。最后合并到了ParseHandlersByName中。

    public Feign build() {
      SynchronousMethodHandler.Factory synchronousMethodHandlerFactory =
          new SynchronousMethodHandler.Factory(client, retryer, requestInterceptors, logger,
                                               logLevel, decode404);
      ParseHandlersByName handlersByName =
          new ParseHandlersByName(contract, options, encoder, decoder,
                                  errorDecoder, synchronousMethodHandlerFactory);
      return new ReflectiveFeign(handlersByName, invocationHandlerFactory);
    }

使用

ParseHandlersByName最后把以上的组件都封装为了一个结果集Map<String, MethodHandler>

public Map<String, MethodHandler> apply(Target key) {
      //如上文所提，contract抽取了接口上的元信息，封装到了MethodMetadata里面。
      //包含我们在接口方法上用注解添加的一系列信息。详见：https://www.jianshu.com/p/6582f8319f72
      List<MethodMetadata> metadata = contract.parseAndValidatateMetadata(key.type());
      //new 结果容器
      Map<String, MethodHandler> result = new LinkedHashMap<String, MethodHandler>();
      //遍历抽取出的MethodMetadata。
      for (MethodMetadata md : metadata) {
        BuildTemplateByResolvingArgs buildTemplate;
        //当metadata里面有formParams并且bodyTemplate为空，说明请求的参数就是简单的Query参数。
        if (!md.formParams().isEmpty() && md.template().bodyTemplate() == null) {
          buildTemplate = new BuildFormEncodedTemplateFromArgs(md, encoder);
        } else if (md.bodyIndex() != null) {
          buildTemplate = new BuildEncodedTemplateFromArgs(md, encoder);
        } else {
          buildTemplate = new BuildTemplateByResolvingArgs(md);
        }
        result.put(md.configKey(),
                   factory.create(key, md, buildTemplate, options, decoder, errorDecoder));
      }
      return result;
    }
  }