作用
在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)以外。还有其他几个组件:
- Contract
作用是将我们传入的接口进行解析验证,看注解的使用是否符合规范,然后返回给我们接口上各种相应的元数据。所以叫合约。详见:https://www.jianshu.com/p/6582f8319f72 - Options
封装Request请求的 连接超时=默认10s ,读取超时=默认60s - Encoder
怎么把我们的请求编码 - Decoder
怎么把我们执行HTTP请求后得到的结果解码为我们定义的类型 - 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;
}
}