Dubbo原理和源碼解析之標籤解析

github新增倉庫 "dubbo-read"（點此查看），集合全部《Dubbo原理和源碼解析》系列文章，後續將繼續補充該系列，同時將針對Dubbo所作的功能擴展也進行分享。不按期更新，歡迎Follow。

 

1、Dubbo 配置方式

Dubbo 支持多種配置方式：

• XML 配置：基於 Spring 的 Schema 和 XML 擴展機制實現
• 屬性配置：加載 classpath 根目錄下的 dubbo.properties
• API 配置：經過硬編碼方式配置（不推薦使用）
• 註解配置：經過註解方式配置（Dubbo-2.5.7及以上版本支持，不推薦使用）

對於 屬性配置 方式，能夠經過環境變量、-D 啓動參數來指定 dubbo.properties 文件，加載文件順序爲：

1. 1. -D 啓動參數
   2. 環境變量
   3. classpath 根目錄

加載代碼以下：

public static final String DUBBO_PROPERTIES_KEY = "dubbo.properties.file";
public static final String DEFAULT_DUBBO_PROPERTIES = "dubbo.properties";

private static volatile Properties PROPERTIES;

public static Properties getProperties() {
    if (PROPERTIES == null) {
        synchronized (ConfigUtils.class) {
            if (PROPERTIES == null) {
                String path = System.getProperty(Constants.DUBBO_PROPERTIES_KEY);
                if (path == null || path.length() == 0) {
                    path = System.getenv(Constants.DUBBO_PROPERTIES_KEY);
                    if (path == null || path.length() == 0) {
                        path = Constants.DEFAULT_DUBBO_PROPERTIES;
                    }
                }
                PROPERTIES = ConfigUtils.loadProperties(path, false, true);
            }
        }
    }
    return PROPERTIES;
}

本文主要分析 XML 配置的實現原理和源碼，其餘方式不予贅述。

2、XML 配置

文章開頭已經提到，XML 配置方式是基於 Spring 的 Schema 和 XML 擴展機制實現的。經過該機制，咱們能夠編寫本身的 Schema，並根據自定義的 Schema 自定義標籤來配置 Bean。

使用 Spring 的 XML 擴展機制有如下幾個步驟：

1. 1. 定義 Schema（編寫 .xsd 文件）
   2. 定義 JavaBean
   3. 編寫 NamespaceHandler 和 BeanDefinitionParser 完成 Schema 解析
   4. 編寫 spring.handlers 和 spring.schemas 文件串聯解析部件
   5. 在 XML 文件中應用配置

Dubbo 配置相關的代碼在 dubbo-config 模塊。

2.1 定義 Schema

Schema 的定義體如今 .xsd 文件上，文件位於 dubbo-config-spring 子模塊下：

至於 XSD 的數據類型、如何定義，並非本文的重點，請參考 W3school《Schema 教程》。

2.2 定義 JavaBean

dubbo-config-api 子模塊中定義了 Dubbo 全部標籤對應的 JavaBean，JavaBean 裏面的屬性一一對應標籤的各配置項。

2.3 解析 Schema

Dubbo 服務框架的 Schema 的解析經過 DubboNamespaceHandler 和 DubboBeanDefinitionParser 實現。

其中，DubboNamespaceHandler 擴展了 Spring 的 NamespaceHandlerSupport，經過重寫它的 init() 方法給各個標籤註冊對應的解析器：

public class DubboNamespaceHandler extends NamespaceHandlerSupport {
    static {
        Version.checkDuplicate(DubboNamespaceHandler.class);
    }
    public void init() {
        registerBeanDefinitionParser("application", new DubboBeanDefinitionParser(ApplicationConfig.class, true));
        registerBeanDefinitionParser("module", new DubboBeanDefinitionParser(ModuleConfig.class, true));
        registerBeanDefinitionParser("registry", new DubboBeanDefinitionParser(RegistryConfig.class, true));
        registerBeanDefinitionParser("monitor", new DubboBeanDefinitionParser(MonitorConfig.class, true));
        registerBeanDefinitionParser("provider", new DubboBeanDefinitionParser(ProviderConfig.class, true));
        registerBeanDefinitionParser("consumer", new DubboBeanDefinitionParser(ConsumerConfig.class, true));
        registerBeanDefinitionParser("protocol", new DubboBeanDefinitionParser(ProtocolConfig.class, true));
        registerBeanDefinitionParser("service", new DubboBeanDefinitionParser(ServiceBean.class, true));
        registerBeanDefinitionParser("reference", new DubboBeanDefinitionParser(ReferenceBean.class, false));
        registerBeanDefinitionParser("annotation", new DubboBeanDefinitionParser(AnnotationBean.class, true));
    }
}

而 DubboBeanDefinitionParser 實現了 Spring 的 BeanDefinitionParser，經過重寫 parse() 方法實現將標籤解析爲對應的 JavaBean：

public class DubboBeanDefinitionParser implements BeanDefinitionParser {
    public BeanDefinition parse(Element element, ParserContext parserContext) {
    return parse(element, parserContext, beanClass, required);
    }

    @SuppressWarnings("unchecked")
    private static BeanDefinition parse(Element element,ParserContext parserContext,Class<?> beanClass,boolean required) {
        RootBeanDefinition beanDefinition = new RootBeanDefinition();
        beanDefinition.setBeanClass(beanClass);
        beanDefinition.setLazyInit(false);
        //......省略
        if (ProtocolConfig.class.equals(beanClass)) {
            for (String name : parserContext.getRegistry().getBeanDefinitionNames()) {
                BeanDefinition definition = parserContext.getRegistry().getBeanDefinition(name);
                PropertyValue property = definition.getPropertyValues().getPropertyValue("protocol");
                if (property != null) {
                    Object value = property.getValue();
                    if (value instanceof ProtocolConfig && id.equals(((ProtocolConfig) value).getName())) {
                        definition.getPropertyValues().addPropertyValue("protocol", new RuntimeBeanReference(id));
                    }
                }
            }
        } else if (ServiceBean.class.equals(beanClass)) {
            String className = element.getAttribute("class");
            if(className != null && className.length() > 0) {
                RootBeanDefinition classDefinition = new RootBeanDefinition();
                classDefinition.setBeanClass(ReflectUtils.forName(className));
                classDefinition.setLazyInit(false);
                parseProperties(element.getChildNodes(), classDefinition);
                beanDefinition.getPropertyValues().addPropertyValue("ref", new BeanDefinitionHolder(classDefinition, id + "Impl"));
            }
        } else if (ProviderConfig.class.equals(beanClass)) {
            parseNested(element, parserContext, ServiceBean.class, true, "service", "provider", id, beanDefinition);
        } else if (ConsumerConfig.class.equals(beanClass)) {
            parseNested(element, parserContext, ReferenceBean.class, false, "reference", "consumer", id, beanDefinition);
        }
        //......省略
        return beanDefinition;
    }
}

2.4 串聯部件

上面咱們已經知道解析的實現類了，那麼 Spring 又如何知道該用 DubboNamespaceHandler 來解析 Dubbo 標籤呢？這經過編寫 spring.handlers 文件實現。

spring.handlers 內容以下：

http\://code.alibabatech.com/schema/dubbo=com.alibaba.dubbo.config.spring.schema.DubboNamespaceHandler

而後，Spring 經過 spring.schemas 文件得知 Dubbo 標籤的 Schema 是 dubbo.xsd，並以此校驗應用 XML 配置文件的格式。

spring.schemas 文件內容以下：

http\://code.alibabatech.com/schema/dubbo/dubbo.xsd=META-INF/dubbo.xsd

文件位置以下：

2.5 應用配置

經過以上步驟，Dubbo 服務框架就完成了標籤解析的功能，用戶在應用程序中按照 dubbo.xsd 的格式配置 XML 便可。

Over.