溫馨提示×

您好,登錄后才能下訂單哦!

密碼登錄×
登錄注冊(cè)×
其他方式登錄
點(diǎn)擊 登錄注冊(cè) 即表示同意《億速云用戶服務(wù)條款》

Spring解析占位符的方法

發(fā)布時(shí)間:2021-06-21 13:52:53 來源:億速云 閱讀:265 作者:chen 欄目:開發(fā)技術(shù)

本篇內(nèi)容介紹了“Spring解析占位符的方法”的有關(guān)知識(shí),在實(shí)際案例的操作過程中,不少人都會(huì)遇到這樣的困境,接下來就讓小編帶領(lǐng)大家學(xué)習(xí)一下如何處理這些情況吧!希望大家仔細(xì)閱讀,能夠?qū)W有所成!

目錄
  • 什么是Spring的占位符?

  • Spring什么時(shí)候去解析并占位符

什么是Spring的占位符?

在以前的Spring Xml配置中我們可能會(huì)有如下配置:

<?xml version="1.0" encoding="UTF-8"?>
<beans xmlns="http://www.springframework.org/schema/beans"
       xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
       xmlns:context="http://www.springframework.org/schema/context"
       xsi:schemaLocation="http://www.springframework.org/schema/beans
       http://www.springframework.org/schema/beans/spring-beans.xsd
       http://www.springframework.org/schema/context
       http://www.springframework.org/schema/context/spring-context.xsd>
    <context:property-placeholder ignore-unresolvable="true"   location="classpath:jdbc.properties"/>

    <bean id="jdbc"  class="com.john.properties.jdbcBean" >
        <property name="url" value="${jdbc.url}"/>
    </bean></beans>

在上面的配置中jdbc這個(gè)Bean的url屬性值${jdbc.url}就代表占位符,占位符的真實(shí)值就存放在上述配置中的自定義元素的location屬性所代表的配置文件jdbc.properties中,這個(gè)配置文件里就一行內(nèi)容:

jdbc.url=127.0.0.1

那問題就來了,Spring又是在什么階段去解析并且把占位符替換為實(shí)際值的呢?

Spring什么時(shí)候去解析并占位符

從我們就可以知道它是一個(gè)自定義xml標(biāo)簽,那Spring勢(shì)必要解析它,我就直接黏貼Spring解析這個(gè)自定義元素的入口代碼給各位看官。該代碼就在BeanDefinitionParserDelegate這個(gè)類中:

/**
     * Parse the elements at the root level in the document:
     * "import", "alias", "bean".
     * @param root the DOM root element of the document
     */
    //todo doRegisterBeanDefinitions ->  parseBeanDefinitions -> parseDefaultElement
    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;

                    //如果屬于beans命名空間
                    if (delegate.isDefaultNamespace(ele)) {
                        //處理默認(rèn)標(biāo)簽
                        parseDefaultElement(ele, delegate);
                    }
                    else {
                        //自定義標(biāo)簽
                        //用到了parser
                        //todo parser內(nèi)部 去注冊(cè)BeanDefinition 2021-3-15
                        delegate.parseCustomElement(ele);
                    }
                }
            }
        }
        else {
            delegate.parseCustomElement(root);
        }
    }

主要關(guān)注點(diǎn):delegate.parseCustomElement(ele);

@Nullable
    public BeanDefinition parseCustomElement(Element ele) {
        return parseCustomElement(ele, null);
    }

    //todo property 子元素 也有可能 解析自定義元素 parsePropertySubElement
    @Nullable
    public BeanDefinition parseCustomElement(Element ele, @Nullable BeanDefinition containingBd) {
        String namespaceUri = getNamespaceURI(ele);
        if (namespaceUri == null) {
            return null;
        }
        //resolve里有初始化過程
        //根據(jù)命名空間uri獲取 NamespaceHandler

        //todo 獲取命名空間下的自定義handler 比如 ContextNamespaceHandler
        NamespaceHandler handler = this.readerContext.getNamespaceHandlerResolver().resolve(namespaceUri);
        if (handler == null) {
            //todo 如果在spring.handlers配置文件 里沒有定義這個(gè)命令空間的handler就會(huì) 報(bào)這個(gè)錯(cuò) 2020-09-14
            error("Unable to locate Spring NamespaceHandler for XML schema namespace [" + namespaceUri + "]", ele);
            return null;
        }
        //調(diào)用parse方法
        //這里ParserContext注入registry
        //readerContext里 reader->XmlBeanDefinitionReader 里包含了 registry
        //TODO 會(huì)初始化一個(gè)ParserContext進(jìn)去
        return handler.parse(ele, new ParserContext(this.readerContext, this, containingBd));
    }

到這里我們又要關(guān)注這個(gè)NamespaceHandler是怎么獲取到的,從上面代碼可知,Spring會(huì)從當(dāng)前readerContext獲取到NamespaceHandlerResolver后通過其resolve方法并根據(jù)傳入的當(dāng)前namespaceUri就可以獲得當(dāng)前適合的NamespaceHandler。

/**
     * Create the {@link XmlReaderContext} to pass over to the document reader.
     */
    public XmlReaderContext createReaderContext(Resource resource) {
        //把當(dāng)前reader放進(jìn)去 ,reader存放了 beanRegistry
        //beanRegistry 里定義了 registerBeanDefinition 這個(gè)重要的方法
        return new XmlReaderContext(resource, this.problemReporter, this.eventListener,
                this.sourceExtractor, this, getNamespaceHandlerResolver());
    }

    /**
     * Lazily create a default NamespaceHandlerResolver, if not set before.
     * 解析自定義標(biāo)簽時(shí)用到
     * @see #createDefaultNamespaceHandlerResolver()
     */
    public NamespaceHandlerResolver getNamespaceHandlerResolver() {
        if (this.namespaceHandlerResolver == null) {
            this.namespaceHandlerResolver = createDefaultNamespaceHandlerResolver();
        }
        return this.namespaceHandlerResolver;
    }

    /**
     * Create the default implementation of {@link NamespaceHandlerResolver} used if none is specified.
     * <p>The default implementation returns an instance of {@link DefaultNamespaceHandlerResolver}.
     * @see DefaultNamespaceHandlerResolver#DefaultNamespaceHandlerResolver(ClassLoader)
     */
    protected NamespaceHandlerResolver createDefaultNamespaceHandlerResolver() {
        ClassLoader cl = (getResourceLoader() != null ? getResourceLoader().getClassLoader() : getBeanClassLoader());
        return new DefaultNamespaceHandlerResolver(cl);
    }

    //返回默認(rèn)的
    public DefaultNamespaceHandlerResolver(@Nullable ClassLoader classLoader) {
        this(classLoader, DEFAULT_HANDLER_MAPPINGS_LOCATION);
    }

從上面的代碼中可知Spring使用的是默認(rèn)的DefaultNamespaceHandlerResolver,它當(dāng)然也給開發(fā)者留了自定義NamespaceHandlerResolver的機(jī)會(huì)。那我們現(xiàn)在就可以看看DefaultNamespaceHandlerResolver如何根據(jù)namespaceUri解析到對(duì)應(yīng)的NamespaceHandler的。

首先獲取到的就是context命名空間,完整路徑為http\://www.springframework.org/schema/context。我們從DefaultNamespaceHandlerResolver類中可以看到它是如何解析這個(gè)命名空間的。

/**
     * Locate the {@link NamespaceHandler} for the supplied namespace URI
     * from the configured mappings.
     * @param namespaceUri the relevant namespace URI
     * @return the located {@link NamespaceHandler}, or {@code null} if none found
     */
    @Override
    @Nullable
    public NamespaceHandler resolve(String namespaceUri) {
        Map<String, Object> handlerMappings = getHandlerMappings();
        Object handlerOrClassName = handlerMappings.get(namespaceUri);
        if (handlerOrClassName == null) {
            return null;
        }
        else if (handlerOrClassName instanceof NamespaceHandler) {
            return (NamespaceHandler) handlerOrClassName;
        }
        else {
            String className = (String) handlerOrClassName;
            try {
                Class<?> handlerClass = ClassUtils.forName(className, this.classLoader);
                if (!NamespaceHandler.class.isAssignableFrom(handlerClass)) {
                    throw new FatalBeanException("Class [" + className + "] for namespace [" + namespaceUri +
                            "] does not implement the [" + NamespaceHandler.class.getName() + "] interface");
                }
                NamespaceHandler namespaceHandler = (NamespaceHandler) BeanUtils.instantiateClass(handlerClass);
                //todo  命名空間處理器 調(diào)用初始化過程 2020-09-04
                namespaceHandler.init();
                handlerMappings.put(namespaceUri, namespaceHandler);
                return namespaceHandler;
            }
            catch (ClassNotFoundException ex) {
                throw new FatalBeanException("Could not find NamespaceHandler class [" + className +
                        "] for namespace [" + namespaceUri + "]", ex);
            }
            catch (LinkageError err) {
                throw new FatalBeanException("Unresolvable class definition for NamespaceHandler class [" +
                        className + "] for namespace [" + namespaceUri + "]", err);
            }
        }
    }

    /**
     * Load the specified NamespaceHandler mappings lazily.
     */
    private Map<String, Object> getHandlerMappings() {
        Map<String, Object> handlerMappings = this.handlerMappings;
        if (handlerMappings == null) {
            synchronized (this) {
                handlerMappings = this.handlerMappings;
                if (handlerMappings == null) {
                    if (logger.isTraceEnabled()) {
                        logger.trace("Loading NamespaceHandler mappings from [" + this.handlerMappingsLocation + "]");
                    }
                    try {
                        //todo handlerMappings為空 才去 獲取所有屬性映射 2020-09-04
                        //spring-aop spring-beans spring-context
                        Properties mappings =
                                PropertiesLoaderUtils.loadAllProperties(this.handlerMappingsLocation, this.classLoader);
                        if (logger.isTraceEnabled()) {
                            logger.trace("Loaded NamespaceHandler mappings: " + mappings);
                        }
                        handlerMappings = new ConcurrentHashMap<>(mappings.size());
                        CollectionUtils.mergePropertiesIntoMap(mappings, handlerMappings);
                        this.handlerMappings = handlerMappings;
                    }
                    catch (IOException ex) {
                        throw new IllegalStateException(
                                "Unable to load NamespaceHandler mappings from location [" + this.handlerMappingsLocation + "]", ex);
                    }
                }
            }
        }
        return handlerMappings;
    }

上面代碼中的handlerMappingsLocation一般就是Spring默認(rèn)的路徑:

//指定了默認(rèn)的handler路徑 ,可以傳入指定路徑改變
    /**
     * The location to look for the mapping files. Can be present in multiple JAR files.
     */
    public static final String DEFAULT_HANDLER_MAPPINGS_LOCATION = "META-INF/spring.handlers";

我們就回到spring-context項(xiàng)目工程下的resoures/META-INF文件夾下的spring.handlers文件里定義了如下規(guī)則:

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

可以看到context自定義命名空間就是對(duì)應(yīng)的ContextNamespaceHandler。我們打開這個(gè)類瞧一瞧:

public class ContextNamespaceHandler extends NamespaceHandlerSupport {

    @Override
    public void init() {
        //調(diào)用抽象類NamespaceHandlerSupport的注冊(cè)解析器方法
        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());
    }
}

發(fā)現(xiàn)它只定義了一個(gè)init方法,顧名思義就是初始化的意思,那想當(dāng)然的就是它啥時(shí)候會(huì)執(zhí)行初始化呢?我們回到DefaultNamespaceHandler的resolve方法,發(fā)現(xiàn)它內(nèi)部有一處namespaceHandler.init();, 這里就執(zhí)行了對(duì)應(yīng)命名空間處理器的初始化方法。接下來我們又要看看初始化了做了些啥,我們發(fā)現(xiàn)它調(diào)用了同一個(gè)方法registerBeanDefinitionParser也就是注冊(cè)

Bean定義解析器,到這里我們先按下暫停鍵,再捋下上面的整體流程:

  1. Spring在解析自定義標(biāo)簽的時(shí)候會(huì)根據(jù)自定義命名空間去查找合適的NamespaceHandler.

  2. 自定義的NamespaceHandler是由NamespaceHandlerResolver去解析得到的。

  3. NamespaceHandlerResolver會(huì)根據(jù)classLoader.getResources查找所有類路徑下的spring.handlers。

  4. 查找到后把文件內(nèi)容轉(zhuǎn)換成handlerMappings,然后根據(jù)傳入的自定義命名空間匹配到NamespaceHandler

  5. 執(zhí)行NamespaceHandler的init方法注冊(cè)BeanDefinitionParser。

那這個(gè)parser做了點(diǎn)什么強(qiáng)大的功能呢?我們下回分解。

“Spring解析占位符的方法”的內(nèi)容就介紹到這里了,感謝大家的閱讀。如果想了解更多行業(yè)相關(guān)的知識(shí)可以關(guān)注億速云網(wǎng)站,小編將為大家輸出更多高質(zhì)量的實(shí)用文章!

向AI問一下細(xì)節(jié)

免責(zé)聲明:本站發(fā)布的內(nèi)容(圖片、視頻和文字)以原創(chuàng)、轉(zhuǎn)載和分享為主,文章觀點(diǎn)不代表本網(wǎng)站立場,如果涉及侵權(quán)請(qǐng)聯(lián)系站長郵箱:is@yisu.com進(jìn)行舉報(bào),并提供相關(guān)證據(jù),一經(jīng)查實(shí),將立刻刪除涉嫌侵權(quán)內(nèi)容。

AI