聊聊Dubbo(四):核心源碼-切入Spring

1 Dubbo配置方式

  1. XML配置:基於 Spring 的 Schema 和 XML 擴展機制實現;
  2. 屬性配置:加載 classpath 根目錄下的 dubbo.properties;
  3. API 配置:經過硬編碼方式配置(不推薦使用);
  4. 註解配置:經過註解方式配置(Dubbo-2.5.7及以上版本支持,不推薦使用);

1.1 屬性配置

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

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

屬性配置 加載代碼 ConfigUtils.java 以下:node

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) {
                // 1. -D 啓動參數
                String path = System.getProperty(Constants.DUBBO_PROPERTIES_KEY);
                if (path == null || path.length() == 0) {
                    // 2. 環境變量
                    path = System.getenv(Constants.DUBBO_PROPERTIES_KEY);
                    if (path == null || path.length() == 0) {
                        // 3. classpath 根目錄
                        path = Constants.DEFAULT_DUBBO_PROPERTIES;
                    }
                }
                PROPERTIES = ConfigUtils.loadProperties(path, false, true);
            }
        }
    }
    return PROPERTIES;
}
複製代碼

2 Dubbo的Schema擴展

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

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

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

2.1 定義 Schema

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

dubbo.xsd

2.2 定義 JavaBean

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

Dubbo標籤對應的JavaBean

2.3 解析Schema

以以下Spring XML文件中的配置爲例:框架

<context:component-scan base-package="com.demo.dubbo.server.serviceimpl"/>
<context:property-placeholder location="classpath:config.properties"/>
<tx:annotation-driven transaction-manager="transactionManager"/>
複製代碼

Spring是如何來解析這些配置呢?若是咱們想本身定義配置該如何作呢?對於上述的XML配置,分紅三個部分:async

  1. 命名空間namespace,如tx、context
  2. 元素element,如component-scan、property-placeholder、annotation-driven
  3. 屬性attribute,如base-package、location、transaction-manager

Spring定義了兩個接口,來分別解析上述內容:ide

  1. NamespaceHandler:註冊了一堆BeanDefinitionParser,利用他們來進行解析;
  2. BeanDefinitionParser:用於解析每一個element的內容;

來看下具體的一個案例,就以Spring的context命名空間爲例,對應的NamespaceHandler實現是ContextNamespaceHandlerui

public class ContextNamespaceHandler extends NamespaceHandlerSupport {

	@Override
	public void init() {
		registerBeanDefinitionParser("property-placeholder", new PropertyPlaceholderBeanDefinitionParser());
		registerBeanDefinitionParser("property-override", new PropertyOverrideBeanDefinitionParser());
		registerBeanDefinitionParser("annotation-config", new AnnotationConfigBeanDefinitionParser());
		registerBeanDefinitionParser("component-scan", new ComponentScanBeanDefinitionParser());
		registerBeanDefinitionParser("load-time-weaver", new LoadTimeWeaverBeanDefinitionParser());
		registerBeanDefinitionParser("spring-configured", new SpringConfiguredBeanDefinitionParser());
		registerBeanDefinitionParser("mbean-export", new MBeanExportBeanDefinitionParser());
		registerBeanDefinitionParser("mbean-server", new MBeanServerBeanDefinitionParser());
	}

}
複製代碼

註冊了一堆BeanDefinitionParser,若是咱們想看 component-scan 是如何實現的,就能夠去看對應的 ComponentScanBeanDefinitionParser 的源碼了。

若是自定義了NamespaceHandler,如何加入到Spring中呢?Spring默認會加載jar包下的META-INF/spring.handlers文件下尋找NamespaceHandler,默認的Spring文件以下:

META-INF/spring.handlers

spring.handlers文件內容以下:相應的命名空間使用相應的NamespaceHandler

http\://www.springframework.org/schema/context=org.springframework.context.config.ContextNamespaceHandler
http\://www.springframework.org/schema/jee=org.springframework.ejb.config.JeeNamespaceHandler
http\://www.springframework.org/schema/lang=org.springframework.scripting.config.LangNamespaceHandler
http\://www.springframework.org/schema/task=org.springframework.scheduling.config.TaskNamespaceHandler
http\://www.springframework.org/schema/cache=org.springframework.cache.config.CacheNamespaceHandler
複製代碼

同時,Spring 經過 spring.schemas 文件得知,如 context 標籤的 Schema 是 context.xsd,並以此校驗應用 XML 配置文件的格式。spring.schemas 文件內容以下:

http\://www.springframework.org/schema/context/spring-context-2.5.xsd=org/springframework/context/config/spring-context-2.5.xsd
http\://www.springframework.org/schema/context/spring-context-3.0.xsd=org/springframework/context/config/spring-context-3.0.xsd
http\://www.springframework.org/schema/context/spring-context-3.1.xsd=org/springframework/context/config/spring-context-3.1.xsd
http\://www.springframework.org/schema/context/spring-context-3.2.xsd=org/springframework/context/config/spring-context-3.2.xsd
http\://www.springframework.org/schema/context/spring-context-4.0.xsd=org/springframework/context/config/spring-context-4.0.xsd
http\://www.springframework.org/schema/context/spring-context-4.1.xsd=org/springframework/context/config/spring-context-4.1.xsd
http\://www.springframework.org/schema/context/spring-context-4.2.xsd=org/springframework/context/config/spring-context-4.2.xsd
http\://www.springframework.org/schema/context/spring-context-4.3.xsd=org/springframework/context/config/spring-context-4.3.xsd
http\://www.springframework.org/schema/context/spring-context.xsd=org/springframework/context/config/spring-context-4.3.xsd
......
複製代碼

文件位置以下:

spring.handlers&spring.schemas文件

Spring框架初始化時會加載全部classpath的spring.handlers文件,把namespace URL和namespace處理器的映射存到一個Map中,Spring框架在解析bean定義文檔時,遇到了非IOC內置(beans名稱空間下)的標籤,會在這個Map中查找namespace處理器,使用這個自定義的處理器來進行標籤解析工做。能夠在 DefaultBeanDefinitionDocumentReaderBeanDefinitionParserDelegate 類中看到相關邏輯的代碼:

// org.springframework.beans.factory.xml.DefaultBeanDefinitionDocumentReader.java
 /** * Parse the elements at the root level in the document: * "import", "alias", "bean". * @param root the DOM root element of the document */
  protected void parseBeanDefinitions(Element root, BeanDefinitionParserDelegate delegate) {
    if (delegate.isDefaultNamespace(root)) {
        NodeList nl = root.getChildNodes();
            for (int i = 0; i < nl.getLength(); i++) {
                Node node = nl.item(i);
                if (node instanceof Element) {
                    Element ele = (Element) node;
                    if (delegate.isDefaultNamespace(ele)) {
                        parseDefaultElement(ele, delegate); //解析默認標籤
                    }
                    else {
                        delegate.parseCustomElement(ele); //解析自定義標籤
                    }
                }
            }
    }
    else {
         delegate.parseCustomElement(root);
    }
 }

 // org.springframework.beans.factory.xml.BeanDefinitionParserDelegate.java
 public BeanDefinition parseCustomElement(Element ele) {
     return parseCustomElement(ele, null);
 }

 public BeanDefinition parseCustomElement(Element ele, BeanDefinition containingBd) {
     String namespaceUri = getNamespaceURI(ele);
     NamespaceHandler handler = this.readerContext.getNamespaceHandlerResolver().resolve(namespaceUri);
     if (handler == null) {
         error("Unable to locate Spring NamespaceHandler for XML schema namespace [" + namespaceUri + "]", ele);
         return null;
     }
     return handler.parse(ele, new ParserContext(this.readerContext, this, containingBd));
 }
複製代碼

3 Dubbo的Schema解析

以以下Dubbo Provider的Spring配置爲例:

<beans xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:dubbo="http://code.alibabatech.com/schema/dubbo" xmlns="http://www.springframework.org/schema/beans" xsi:schemaLocation="http://www.springframework.org/schema/beans http://www.springframework.org/schema/beans/spring-beans-2.5.xsd http://code.alibabatech.com/schema/dubbo http://code.alibabatech.com/schema/dubbo/dubbo.xsd">

    <!-- 提供方應用信息,用於計算依賴關係 -->
    <dubbo:application name="demo-provider"/>
    <!-- 使用multicast廣播註冊中心暴露服務地址 -->
    <dubbo:registry address="multicast://224.5.6.7:1234"/>
    <!-- 用dubbo協議在20880端口暴露服務 -->
    <dubbo:protocol name="dubbo" port="20880"/>
    
    <dubbo:reference id="registryService" interface="com.alibaba.dubbo.registry.RegistryService">
        <property name= checkvalue= false」/>
    </dubbo:reference>
    <!-- 和本地bean同樣實現服務 -->
    <bean id="demoService" class="com.alibaba.dubbo.demo.provider.DemoServiceImpl"/>
    <!-- 聲明須要暴露的服務接口 -->
    <dubbo:service interface="com.alibaba.dubbo.demo.DemoService" ref="demoService"/>
</beans>
複製代碼

3.1 XML轉化beanDefinition

根據Spring可擴展Schema,咱們先去dubbo.jar內的META-INF/spring.handlers配置內容:

http\://code.alibabatech.com/schema/dubbo=com.alibaba.dubbo.config.spring.schema.DubboNamespaceHandler
複製代碼

咱們從這個類(DubboNamespaceHandler)開刀吧,DubboNamespaceHandler代碼:

public class DubboNamespaceHandler extends NamespaceHandlerSupport {
    static {
        // 確保系統中只存在一份解析處理器類定義
        Version.checkDuplicate(DubboNamespaceHandler.class);
    }
    public void init() {
        // DubboBeanDefinitionParser定義瞭如何解析dubbo節點信息
        // DubboBeanDefinitionParser的第一個參數是beanclass
        // 配置<dubbo:application>標籤解析器
	registerBeanDefinitionParser("application", new DubboBeanDefinitionParser(ApplicationConfig.class, true));
        // 配置<dubbo:module>標籤解析器
	registerBeanDefinitionParser("module", new DubboBeanDefinitionParser(ModuleConfig.class, true));
        //配置<dubbo:registry>標籤解析器
	registerBeanDefinitionParser("registry", new DubboBeanDefinitionParser(RegistryConfig.class, true));
        //配置<dubbo:monitor>標籤解析器
	registerBeanDefinitionParser("monitor", new DubboBeanDefinitionParser(MonitorConfig.class, true));
        //配置<dubbo:provider>標籤解析器
	registerBeanDefinitionParser("provider", new DubboBeanDefinitionParser(ProviderConfig.class, true));
        //配置<dubbo:consumer>標籤解析器
	registerBeanDefinitionParser("consumer", new DubboBeanDefinitionParser(ConsumerConfig.class, true));
        //配置<dubbo:protocol>標籤解析器
	registerBeanDefinitionParser("protocol", new DubboBeanDefinitionParser(ProtocolConfig.class, true));
	//配置<dubbo:service>標籤解析器
	registerBeanDefinitionParser("service", new DubboBeanDefinitionParser(ServiceBean.class, true));
	//配置<dubbo:refenrence>標籤解析器
	registerBeanDefinitionParser("reference", new DubboBeanDefinitionParser(ReferenceBean.class, false));
	//配置<dubbo:annotation>標籤解析器
	registerBeanDefinitionParser("annotation", new DubboBeanDefinitionParser(AnnotationBean.class, true));
    }
}
複製代碼

按照Spring提供的機制,Dubbo把每一個自定義的可以使用配置元素和對應的解析器綁定到一塊兒。而真正負責把配置文件中聲明的內容解析成對應的BeanDefinition(能夠想象爲Bean的模子)是靠DubboBeanDefinitionParser.parse類完成,全部dubbo的標籤,都統一用DubboBeanDefinitionParser進行解析,基於一對一屬性映射,將XML標籤解析爲Bean對象。具體代碼以下:

/** 
 * 解析dubbo自定義標籤,往BeanDefinition設置屬性值,這個時候bean尚未建立 
 * @param element 
 * @param parserContext 
 * @param beanClass 
 * @param required 
 * @return 
 */  
@SuppressWarnings("unchecked")  
private static BeanDefinition parse(Element element, ParserContext parserContext, Class<?> beanClass, boolean required) {  
    RootBeanDefinition beanDefinition = new RootBeanDefinition();  
    beanDefinition.setBeanClass(beanClass);  
    // 設置懶加載爲false,表示當即加載,spring啓動時,馬上進行實例化  
    // 若是設置爲true,那麼要第一次向容器經過getBean索取bean時實例化,在spring bean的配置裏能夠配置  
    // 這裏會設置懶加載爲false,其實還能夠獲得一個推斷就是dubbo標籤建立的bean就是單例bean(singleton bean)  
    // 由於lazy-init的設置只對singleton bean有效,對原型bean(prototype無效)  
    beanDefinition.setLazyInit(false);  
    String id = element.getAttribute("id");  
    // 若是沒有設置bean的id  
    if ((id == null || id.length() == 0) && required) {  
        String generatedBeanName = element.getAttribute("name");  
        // 若是name沒有配置  
        if (generatedBeanName == null || generatedBeanName.length() == 0) {  
            // 若是是ProtocolConfig類型,bean name默認爲 dubbo,其餘的爲配置的interface值  
            if (ProtocolConfig.class.equals(beanClass)) {  
                generatedBeanName = "dubbo";  
            } else {  
                generatedBeanName = element.getAttribute("interface");  
            }  
        }  
        /* 
         * 若是generatedBeanName仍爲null,那麼取 beanClass 的名字,beanClass 其實就是要解析的類型
         * 如:com.alibaba.dubbo.config.ApplicationConfig 
         */  
        if (generatedBeanName == null || generatedBeanName.length() == 0) {  
            generatedBeanName = beanClass.getName();  
        }  
        //若是id沒有設置,那麼 id = generatedBeanName,若是是ProtocolConfig類型的話,天然就是 dubbo  
        id = generatedBeanName;   
        int counter = 2;  
        /* 
         * 因爲spring的bean id不能重複,但有些標籤可能會配置多個如:dubbo:registry 
         * 因此 id 在後面加數字 二、三、4 區分 
         */  
        while(parserContext.getRegistry().containsBeanDefinition(id)) {  
            id = generatedBeanName + (counter ++);  
        }  
    }  
    if (id != null && id.length() > 0) {  
        // 檢查是否有 bean id 相同的  
        if (parserContext.getRegistry().containsBeanDefinition(id))  {  
            throw new IllegalStateException("Duplicate spring bean id " + id);  
        }  
        /* 
         * 註冊 bean 定義 
         * org.springframework.beans.factory.support.DefaultListableBeanFactory#registerBeanDefinition 
         * 會按照 id 即beanName作一些檢查,判斷是否重載已加載過的bean等等 
         * 跟到代碼裏其實 bean 的註冊也是放到 ConcurrentHashMap 裏 
         * beanName也就是這裏的 id 會放到 list 裏 
         */  
        parserContext.getRegistry().registerBeanDefinition(id, beanDefinition);  
        // 給bean添加屬性值  
        beanDefinition.getPropertyValues().addPropertyValue("id", id);  
    }  
    if (ProtocolConfig.class.equals(beanClass)) { //解析<dubbo:protocol
        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())) {
                    // RuntimeBeanReference:這個的類的主要做用是根據bean名稱返回bean實例的引用,避免客戶端顯示獲取bean實例;  
                    definition.getPropertyValues().addPropertyValue("protocol", new RuntimeBeanReference(id));  
                }  
            }  
        }  
    } else if (ServiceBean.class.equals(beanClass)) { // 解析<dubbo:service  
        String className = element.getAttribute("class");// 獲取類全名  
        if(className != null && className.length() > 0) {  
            RootBeanDefinition classDefinition = new RootBeanDefinition();  
            // 經過反射獲取類  
            classDefinition.setBeanClass(ReflectUtils.forName(className));  
            classDefinition.setLazyInit(false);  
            /* 
             *   解析子節點,有些配置多是: 
             *   <dubbo:service interface="com.alihealth.dubbo.api.drugInfo.service.DemoService" executes="10"> 
             *       <property name="ref" ref="demoService"></property> 
             *       <property name="version" value="1.0.0"></property> 
             *   </dubbo:service> 
             */  
            parseProperties(element.getChildNodes(), classDefinition);  
            /* 
             *   ref直接設置成了 接口名 + Impl 的bean
             */  
            beanDefinition.getPropertyValues().addPropertyValue("ref", new BeanDefinitionHolder(classDefinition, id + "Impl"));  
        }  
    } else if (ProviderConfig.class.equals(beanClass)) {  
        /* 
         *   <dubbo:provider 爲缺省配置 ,因此在解析的時候,若是<dubbo:service有些值沒配置,那麼會用<dubbo:provider值進行填充 
         */  
        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);  
    }

    Set<String> props = new HashSet<String>();  
    ManagedMap parameters = null;  
    for (Method setter : beanClass.getMethods()) {  
        String name = setter.getName();  
        // 給model注入值時,如ServiceConfig,方法必須是set開頭,而且參數數量只能爲1  
        if (name.length() > 3 && name.startsWith("set")  
                && Modifier.isPublic(setter.getModifiers())  
                && setter.getParameterTypes().length == 1) {  
            // 方法參數類型,由於參數只能是1,因此直接取[0]  
            Class<?> type = setter.getParameterTypes()[0];  
            // 根據set方法名獲取屬性值,如:setListener 獲得的屬性爲:listener  
            String property = StringUtils.camelToSplitName(name.substring(3, 4).toLowerCase() + name.substring(4), "-");  
            props.add(property);  
            Method getter = null;  
            try {  
                getter = beanClass.getMethod("get" + name.substring(3), new Class<?>[0]);  
            } catch (NoSuchMethodException e) {  
                try {  
                    getter = beanClass.getMethod("is" + name.substring(3), new Class<?>[0]);  
                } catch (NoSuchMethodException e2) {  
                }  
            }  
            if (getter == null   
                    || ! Modifier.isPublic(getter.getModifiers())  
                    || ! type.equals(getter.getReturnType())) {  
                continue;  
            }  

            if ("parameters".equals(property)) {  
                /* 
                 * 若是屬性爲 parameters,如ProtocolConfig裏的setParameters(Map<String, String> parameters) 
                 * 那麼去子節點獲取 <dubbo:parameter 
                 * <dubbo:protocol name="dubbo" host="127.0.0.1" port="9998" accepts="1000"  > 
                 *    <dubbo:parameter key="adsf" value="adf" /> 
                 *    <dubbo:parameter key="errer" value="aerdf" /> 
                 * </dubbo:protocol> 
                 */  
                parameters = parseParameters(element.getChildNodes(), beanDefinition);  
            } else if ("methods".equals(property)) {  
                /* 
                 *  解析 <dubbo:method 並設置 methods 值 --ServiceConfig中 
                 */  
                parseMethods(id, element.getChildNodes(), beanDefinition, parserContext);  
            } else if ("arguments".equals(property)) {  
                /* 
                 *   同上 ,解析<dubbo:argument --- MethodConfig中 
                 */  
                parseArguments(id, element.getChildNodes(), beanDefinition, parserContext);  
            } else {  
                String value = element.getAttribute(property);  
                if (value != null) {  
                    value = value.trim();  
                    if (value.length() > 0) {  
                        // 不發佈到任何註冊中心時 registry = "N/A"  
                        if ("registry".equals(property) && RegistryConfig.NO_AVAILABLE.equalsIgnoreCase(value)) {  
                            RegistryConfig registryConfig = new RegistryConfig();  
                            registryConfig.setAddress(RegistryConfig.NO_AVAILABLE);  
                            beanDefinition.getPropertyValues().addPropertyValue(property, registryConfig);  
                        } else if ("registry".equals(property) && value.indexOf(',') != -1) {  
                            // 多註冊中心用 , 號分隔  
                            parseMultiRef("registries", value, beanDefinition, parserContext);  
                        } else if ("provider".equals(property) && value.indexOf(',') != -1) {  
                            parseMultiRef("providers", value, beanDefinition, parserContext);  
                        } else if ("protocol".equals(property) && value.indexOf(',') != -1) {  
                            // 同上 多協議暴露  
                            parseMultiRef("protocols", value, beanDefinition, parserContext);  
                        } else {  
                            Object reference;  
                            if (isPrimitive(type)) {//若是參數類型爲 java 的基本類型  
                                if ("async".equals(property) && "false".equals(value)  
                                        || "timeout".equals(property) && "0".equals(value)  
                                        || "delay".equals(property) && "0".equals(value)  
                                        || "version".equals(property) && "0.0.0".equals(value)  
                                        || "stat".equals(property) && "-1".equals(value)  
                                        || "reliable".equals(property) && "false".equals(value)) {  
                                  /* 
                                   * 兼容舊版本xsd中的default值,以上配置的值在xsd中有配置defalt值 
                                   * <xsd:attribute name="version" type="xsd:string" use="optional" default="0.0.0"> 
                                  */  
                                    value = null;  
                                }  
                                reference = value;  
                            } else if ("protocol".equals(property)  
                                    // 若是屬性爲 protocol 那麼要判斷protocol對應的拓展點配置有沒有  
                                    && ExtensionLoader.getExtensionLoader(Protocol.class).hasExtension(value)  
                                    // 檢查當前使用的協議是否已經解析過 可能在這裏被解析過<dubbo:protocol name="dubbo"  
                                    && (! parserContext.getRegistry().containsBeanDefinition(value)  
                                            || ! ProtocolConfig.class.getName().equals(parserContext.getRegistry().getBeanDefinition(value).getBeanClassName()))) {  
                                if ("dubbo:provider".equals(element.getTagName())) {  
                                    logger.warn("Recommended replace <dubbo:provider protocol=\"" + value + "\" ... /> to <dubbo:protocol name=\"" + value + "\" ... />");  
                                }  
                                // 兼容舊版本配置  
                                ProtocolConfig protocol = new ProtocolConfig();  
                                protocol.setName(value);  
                                reference = protocol;  
                            } else if ("monitor".equals(property)  
                                    // 同上  
                                    && (! parserContext.getRegistry().containsBeanDefinition(value)  
                                            || ! MonitorConfig.class.getName().equals(parserContext.getRegistry().getBeanDefinition(value).getBeanClassName()))) {  
                                // 兼容舊版本配置  
                                reference = convertMonitor(value);  
                            } else if ("onreturn".equals(property)) {  
                                // 回調方法 相似onSuccess  
                                int index = value.lastIndexOf(".");  
                                // bean的名字  
                                String returnRef = value.substring(0, index);  
                                String returnMethod = value.substring(index + 1);  
                                reference = new RuntimeBeanReference(returnRef);  
                                beanDefinition.getPropertyValues().addPropertyValue("onreturnMethod", returnMethod);  
                            } else if ("onthrow".equals(property)) {  
                                // 回調 異常執行的方法 ,相似 onError  
                                int index = value.lastIndexOf(".");  
                                String throwRef = value.substring(0, index);  
                                String throwMethod = value.substring(index + 1);  
                                reference = new RuntimeBeanReference(throwRef);  
                                beanDefinition.getPropertyValues().addPropertyValue("onthrowMethod", throwMethod);  
                            } else {  
                                if ("ref".equals(property) && parserContext.getRegistry().containsBeanDefinition(value)) {  
                                    BeanDefinition refBean = parserContext.getRegistry().getBeanDefinition(value);  
                                    /* 
                                     *  必須是單例bean(singleton),原型bean(prototype)不行,sevice初始化一次,在spring容器裏也只有一個 實例 
                                     *  是否是和dubbo的冪等有關,若是爲原型bean,那麼服務就變成有狀態的了 
                                     */  
                                    if (! refBean.isSingleton()) {  
                                        throw new IllegalStateException("The exported service ref " + value + " must be singleton! Please set the " + value + " bean scope to singleton, eg: <bean id=\"" + value+ "\" scope=\"singleton\" ...>");  
                                    }  
                                }  
                                reference = new RuntimeBeanReference(value);  
                            }  
                            /* 
                             *  設置屬性,值爲另一個關聯的bean 
                             *  RuntimeBeanReference 固定佔位符類,當在beanfactory中做爲另一個bean的引用時,做爲屬性值對象,將在運行時進行解析 
                             */  
                            beanDefinition.getPropertyValues().addPropertyValue(property, reference);  
                        }  
                    }  
                }  
            }  
        }  
    }  
    NamedNodeMap attributes = element.getAttributes();  
    int len = attributes.getLength();  
    for (int i = 0; i < len; i++) {  
        Node node = attributes.item(i);  
        String name = node.getLocalName();  
        // 通過上面的解析,若是還有一些屬性沒有解析到的  
        if (! props.contains(name)) {  
            if (parameters == null) {  
                parameters = new ManagedMap();  
            }  
            String value = node.getNodeValue();  
            parameters.put(name, new TypedStringValue(value, String.class));  
        }  
    }  
    if (parameters != null) {  
        beanDefinition.getPropertyValues().addPropertyValue("parameters", parameters);  
    }  
    return beanDefinition;  
}

@SuppressWarnings("unchecked")  
private static void parseMultiRef(String property, String value, RootBeanDefinition beanDefinition,  
        ParserContext parserContext) {  
    // 解析 registries 、providers、protocols 時支持多引用  
    String[] values = value.split("\\s*[,]+\\s*");  
    ManagedList list = null;  
    for (int i = 0; i < values.length; i++) {  
        String v = values[i];  
        if (v != null && v.length() > 0) {  
            if (list == null) {  
                list = new ManagedList();  
            }  
            list.add(new RuntimeBeanReference(v));  
        }  
    }  
    beanDefinition.getPropertyValues().addPropertyValue(property, list);  
}  

private static void parseNested(Element element, ParserContext parserContext, Class<?> beanClass,  
                                 boolean required, String tag, String property, String ref, BeanDefinition beanDefinition) {  
     NodeList nodeList = element.getChildNodes();  
     if (nodeList != null && nodeList.getLength() > 0) {  
         boolean first = true;  
         for (int i = 0; i < nodeList.getLength(); i++) {  
             Node node = nodeList.item(i);  
             if (node instanceof Element) {  
                 if (tag.equals(node.getNodeName())  
                         || tag.equals(node.getLocalName())) {  
                     if (first) {  
                         first = false;  
                         String isDefault = element.getAttribute("default");  
                         /* 
                          *  若是 <dubbo:provider 標籤沒有配置default開關,那麼直接設置 default = "false" 
                          *  這樣作的目的是爲了讓 <dubbo:provider裏的配置都只是 <dubbo:service 或 <dubbo:reference的默認或缺省配置 
                          */  
                         if (isDefault == null || isDefault.length() == 0) {  
                             beanDefinition.getPropertyValues().addPropertyValue("default", "false");  
                         }  
                     }  
                     BeanDefinition subDefinition = parse((Element) node, parserContext, beanClass, required);  
                     if (subDefinition != null && ref != null && ref.length() > 0) {  
                         subDefinition.getPropertyValues().addPropertyValue(property, new RuntimeBeanReference(ref));  
                     }  
                 }  
             }  
         }  
     }  
 }

private static void parseProperties(NodeList nodeList, RootBeanDefinition beanDefinition) {  
    if (nodeList != null && nodeList.getLength() > 0) {  
        for (int i = 0; i < nodeList.getLength(); i++) {  
            Node node = nodeList.item(i);  
            if (node instanceof Element) {  
                // 若是是 <property 元素  
                if ("property".equals(node.getNodeName())  
                        || "property".equals(node.getLocalName())) {  
                    String name = ((Element) node).getAttribute("name");  
                    if (name != null && name.length() > 0) {  
                        String value = ((Element) node).getAttribute("value");  
                        // 獲取 ref  
                        String ref = ((Element) node).getAttribute("ref");  
                        if (value != null && value.length() > 0) {  
                            beanDefinition.getPropertyValues().addPropertyValue(name, value);  
                        } else if (ref != null && ref.length() > 0) {  
                            beanDefinition.getPropertyValues().addPropertyValue(name, new RuntimeBeanReference(ref));  
                        } else {  
                            /* 
                             *   只支持兩種property的設置方法: 
                             *   <property  ref="" name=""> 
                             *   <property  value="" name=""> 
                             */  
                            throw new UnsupportedOperationException("Unsupported <property name=\"" + name + "\"> sub tag, Only supported <property name=\"" + name + "\" ref=\"...\" /> or <property name=\"" + name + "\" value=\"...\" />");  
                        }  
                    }  
                }  
            }  
        }  
    }  
}  

@SuppressWarnings("unchecked")  
private static ManagedMap parseParameters(NodeList nodeList, RootBeanDefinition beanDefinition) {  
    if (nodeList != null && nodeList.getLength() > 0) {  
        ManagedMap parameters = null;  
        for (int i = 0; i < nodeList.getLength(); i++) {  
            Node node = nodeList.item(i);  
            if (node instanceof Element) {  
                // 解析 <dubbo:parameter  
                if ("parameter".equals(node.getNodeName())  
                        || "parameter".equals(node.getLocalName())) {  
                    if (parameters == null) {  
                        parameters = new ManagedMap();  
                    }  
                    String key = ((Element) node).getAttribute("key");  
                    String value = ((Element) node).getAttribute("value");  
                    boolean hide = "true".equals(((Element) node).getAttribute("hide"));  
                    if (hide) {  
                        key = Constants.HIDE_KEY_PREFIX + key;  
                    }  
                    // 添加參數,String 類型  
                    parameters.put(key, new TypedStringValue(value, String.class));  
                }  
            }  
        }  
        return parameters;  
    }  
    return null;  
}  

@SuppressWarnings("unchecked")  
private static void parseMethods(String id, NodeList nodeList, RootBeanDefinition beanDefinition,  
                          ParserContext parserContext) {  
    if (nodeList != null && nodeList.getLength() > 0) {  
        ManagedList methods = null;  
        for (int i = 0; i < nodeList.getLength(); i++) {  
            Node node = nodeList.item(i);  
            if (node instanceof Element) {  
                Element element = (Element) node;  
                // <dubbo:method  
                if ("method".equals(node.getNodeName()) || "method".equals(node.getLocalName())) {  
                    String methodName = element.getAttribute("name");  
                    if (methodName == null || methodName.length() == 0) {  
                        throw new IllegalStateException("<dubbo:method> name attribute == null");  
                    }  
                    if (methods == null) {  
                        methods = new ManagedList();  
                    }  
                    // 解析 <dubbo:method MethodConfig  
                    BeanDefinition methodBeanDefinition = parse(((Element) node),  
                            parserContext, MethodConfig.class, false);  
                    String name = id + "." + methodName;  
                    BeanDefinitionHolder methodBeanDefinitionHolder = new BeanDefinitionHolder(  
                            methodBeanDefinition, name);  
                    methods.add(methodBeanDefinitionHolder);  
                }  
            }  
        }  
        if (methods != null) {  
            beanDefinition.getPropertyValues().addPropertyValue("methods", methods);  
        }  
    }  
}  
複製代碼

解析的最終目的是返回 RootBeanDefinition 對象,RootBeanDefinition包含了解析出來的關於bean的全部信息,注意,在bean的解析完後其實只是spring將其轉化成spring內部的一種抽象的數據對象結構,bean的建立(實例化)是第一次調用 getBean 時建立的

3.2 beanDefinition轉化Bean

beanDefinition轉化bean的過程其實都是有Spring來完成的,這部分是屬於Spring的內容,下圖大致描述了Spring內部是如何初始化bean:

Spring獲取Bean實例
相關文章
相關標籤/搜索