Feign原始碼解析:初始化過程(一)

2023-12-17 06:00:42

前言

打算系統分析下Feign的程式碼,上一篇講了下Feign的歷史,本篇的話,先講下Feign相關的beanDefinition,beanDefinition就是bean的設計圖,bean都是按照beanDefinition來製造的。

Feign相關的bean不少,有一些是因為我們的Feign相關注解而引入的,有一部分是因為spring的自動裝配來自動引入的。

今天講講因為我們註解引入的那些。

EnableFeignClients引入的FeignClientSpecification

如果專案用到Feign,在@SpringBootApplication註解的主類上,我們一般還會加上@EnableFeignClients註解。

package a.b.c;
    
@SpringBootApplication
@EnableFeignClients
public class DemoApplication

實際上,spring的beanFactory初始化一般就是分兩步,第一步,收集beanDefinition列表,第二步,根據beanDefinition生成並初始化bean。

收集beanDefinition相當重要,但是beanDefinition從哪來來呢,一開始的時候,都是框架預設註冊了幾個,應用自身的beanDefinition一般要從主類來,也就是上面說的@SpringBootApplication註解的主類。

一開始就會去解析主類上的註解,包名;解析包名的原因是,拿到包名後,預設就會去掃描這個包名下的class,再找到註解了@configuration、@controller、@service、@component之類的bean作為beanDefinition;解析註解的原因是,可以根據註解,引入更多的beanDefinition。

以@EnableFeignClients為例,該註解的定義如下:

@Import(FeignClientsRegistrar.class)
public @interface EnableFeignClients

所以這裡會通過Import引入更多的beanDefinition。

org.springframework.cloud.openfeign.FeignClientsRegistrar

public void registerBeanDefinitions(AnnotationMetadata metadata, BeanDefinitionRegistry registry) {
    // 1
    registerDefaultConfiguration(metadata, registry);
    // 2
    registerFeignClients(metadata, registry);
}

上面的1處,如下:

Map<String, Object> defaultAttrs = metadata.getAnnotationAttributes(EnableFeignClients.class.getName(), true);
String name = "default." + metadata.getClassName();
registerClientConfiguration(registry, name, defaultAttrs.get("defaultConfiguration"));

private void registerClientConfiguration(BeanDefinitionRegistry registry, Object name, Object configuration) {
    BeanDefinitionBuilder builder = BeanDefinitionBuilder.genericBeanDefinition(FeignClientSpecification.class);
    builder.addConstructorArgValue(name);
    builder.addConstructorArgValue(configuration);
    registry.registerBeanDefinition(builder.getBeanDefinition());
}

主要是獲取@EnableFeignClients這個註解相關的預設屬性,然後註冊了一個FeignClientSpecification型別的bean。

這個FeignClientSpecification類很簡單,屬性就兩個:

public class FeignClientSpecification implements NamedContextFactory.Specification {

	private String name;

	private Class<?>[] configuration;
}    

一個name,一個configuration,其實就是代表了一個要如何建立和設定FeignClient的設定,包含了如何建立feign的encoder、decoder等。

A custom @Configuration for all feign clients. Can contain override @Bean definition for the pieces that make up the client, for instance feign.codec.Decoder, feign.codec.Encoder, feign.Contract.

我們舉個例子,如下的程式碼,

package a.b.c;
    
@SpringBootApplication
@EnableFeignClients
public class DemoApplication

最終生成的FeignClientSpecification beanDefinition,beanName為:default.a.b.c.DemoApplication.FeignClientSpecification,屬性:

name:default.a.b.c.DemoApplication

configuration:空陣列

FeignClient註解引入的FeignClientSpecification

說完這個,繼續說如下的二處:

public void registerBeanDefinitions(AnnotationMetadata metadata, BeanDefinitionRegistry registry) {
    // 1
    registerDefaultConfiguration(metadata, registry);
    // 2
    registerFeignClients(metadata, registry);
}

2處內部,是首先獲取@EnableFeignClients註解的類所在的包名,然後在這個包名下掃描註解了@FeignClient的類,掃描到的這些類,那肯定是弄了一個beanDefinition了,這個可以倒推,畢竟每個@FeignClient註解的類最終都變成了一個bean嘛。

裡面有一點值得講,FeignClient註解中有一個屬性,叫configuration,它支援你指定一個class,裡面可以覆蓋FeignClient內部的部分元件,如Feign的Encoder等

public @interface FeignClient {
    String value() default "";
    Class<?>[] configuration() default {};
}    

這個你指定的設定類,是可以被多個FeignClient複用的,所以,spring內部也是隻會存一份,這一份設定,就通過一個建立一個型別為FeignClientSpecification.class的bean來儲存。

以如下為例:

@FeignClient(name = "demoService")
public interface DemoServiceFeignClient

由於沒有指定configuration屬性,這裡生成的FeignClientSpecification bean中,name就是demoService,configuration就是null:

public class FeignClientSpecification implements NamedContextFactory.Specification {

	private String name;

	private Class<?>[] configuration;
}

如果指定configuration屬性:

@FeignClient(name = "demoService", configuration = CustomConfig.class)
public interface DemoServiceFeignClient

FeignClientSpecification中的configuration就會是CustomConfig.class。

這個FeignClientSpecification.class的bean的名字,預設則會是demoService.FeignClientSpecification。

FeignClient對應的beanDefinition

接下來,就是註冊一個FeignClient對應的beanDefinition了。

詳細的原始碼可以看這裡:org.springframework.cloud.openfeign.FeignClientsRegistrar#registerFeignClient

FeignClient的bean是較難建立的,所以這裡是用了工廠bean:FeignClientFactoryBean

String name = getName(attributes);

FeignClientFactoryBean factoryBean = new FeignClientFactoryBean();
factoryBean.setBeanFactory(beanFactory);
factoryBean.setName(name);
factoryBean.setContextId(contextId);
factoryBean.setType(clazz);
factoryBean.setRefreshableClient(isClientRefreshEnabled());
BeanDefinitionBuilder definition = BeanDefinitionBuilder.genericBeanDefinition(clazz, () -> {
    factoryBean.setUrl(getUrl(beanFactory, attributes));
    factoryBean.setPath(getPath(beanFactory, attributes));
    ...

    return factoryBean.getObject();
});

BeanDefinitionHolder holder = new BeanDefinitionHolder(beanDefinition, className, qualifiers);
BeanDefinitionReaderUtils.registerBeanDefinition(holder, registry);

這裡的beanname,一般也就是FeignClient的全路徑名。

彙總

最終其實就引入了三個bean:

首先是由@enableFeignClients引入的FeignClientSpecification,然後是@enableFeignClients註解所在的包名下的由@FeignClient註解引入的FeignClientSpecification,再一個就是FeignClient本身的bean(一個factoryBean)