為什麼在Spring的配置裡,最好不要配置xsd檔案的版本號
為什麼dubbo啟動沒有問題?
這篇blog源於一個疑問:
我們公司使了阿里的dubbo,但是阿里的開源網站http://code.alibabatech.com,掛掉有好幾個月了,為什麼我們的應用啟動沒有問題?
我們的應用的Spring配置檔案裡有類似的配置:
我們都知道Spring在啟動時是要檢驗XML檔案的。或者為什麼在Eclipse裡xml沒有錯誤提示?<?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:dubbo="http://code.alibabatech.com/schema/dubbo" xsi:schemaLocation="http://www.springframework.org/schema/beans http://www.springframework.org/schema/beans/spring-beans.xsd http://code.alibabatech.com/schema/dubbo http://code.alibabatech.com/schema/dubbo/dubbo.xsd">
比如這樣的一個Spring配置:
我們也可以在後面加上版本號:<?xml version="1.0" encoding="UTF-8"?> <beans xmlns="http://www.springframework.org/schema/beans" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="http://www.springframework.org/schema/beans http://www.springframework.org/schema/beans/spring-beans.xsd"> </beans>
xsi:schemaLocation="http://www.springframework.org/schema/beans http://www.springframework.org/schema/beans/spring-beans-3.0.xsd">
有這個版本號和沒有有什麼區別呢?
XML的一些概念
首先來看下xml的一些概念:
xml的schema裡有namespace,可以給它起個別名。比如常見的spring的namespace:
通常情況下,namespace對應的URI是一個存放XSD的地址,儘管規範沒有這麼要求。如果沒有提供schemaLocation,那麼Spring的XML解析器會從namespace的URI里加載XSD檔案。我們可以把配置檔案改成這個樣子,也是可以正常工作的:xmlns:mvc="http://www.springframework.org/schema/mvc" xmlns:context="http://www.springframework.org/schema/context"
<?xml version="1.0" encoding="UTF-8"?>
<beans xmlns="http://www.springframework.org/schema/beans/spring-beans.xsd"
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
schemaLocation提供了一個xml namespace到對應的XSD檔案的一個對映,所以我們可以看到,在xsi:schemaLocation後面配置的字串都是成對的,前面的是namespace的URI,後面是xsd檔案的URI。比如:
xsi:schemaLocation="http://www.springframework.org/schema/beans
http://www.springframework.org/schema/beans/spring-beans.xsd
http://www.springframework.org/schema/security
http://www.springframework.org/schema/security/spring-security.xsd"
Spring是如何校驗XML的
Spring預設在啟動時是要載入XSD檔案來驗證xml檔案的,所以如果有的時候斷網了,或者一些開源軟體切換域名,那麼就很容易碰到應用啟動不了。我記得當時Oracle收購Sun公司時,遇到過這個情況。
為了防止這種情況,Spring提供了一種機制,預設從本地載入XSD檔案。開啟spring-context-3.2.0.RELEASE.jar,可以看到裡面有兩個特別的檔案:
spring.handlers
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.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.xsd=org/springframework/context/config/spring-context-3.2.xsd
...
再開啟jar包裡的org/springframework/context/config/ 目錄,可以看到下面有spring-context-2.5.xsd
spring-context-3.0.xsd
spring-context-3.1.xsd
spring-context-3.2.xsd
很明顯,可以想到Spring是把XSD檔案放到本地了,再在spring.schemas裡做了一個對映,優先從本地裡載入XSD檔案。
並且Spring很貼心,把舊版本的XSD檔案也全放了。這樣可以防止升級了Spring版本,而配置檔案裡用的還是舊版本的XSD檔案,然後斷網了,應用啟動不了。
我們還可以看到,在沒有配置版本號時,用的就是當前版本的XSD檔案:
http\://www.springframework.org/schema/context/spring-context.xsd=org/springframework/context/config/spring-context-3.2.xsd
同樣,我們開啟dubbo的jar包,可以在它的spring.schemas檔案裡看到有這樣的配置:
http\://code.alibabatech.com/schema/dubbo/dubbo.xsd=META-INF/dubbo.xsd
所以,Spring在載入dubbo時,會從dubbo的jar里加載dubbo.xsd。如何跳過Spring的XML校驗?
可以用這樣的方式來跳過校驗:
GenericXmlApplicationContext context = new GenericXmlApplicationContext();
context.setValidating(false);
如何寫一個自己的spring xml namespace擴充套件
可以參考Spring的文件,實際上是相當簡單的。只要實現自己的NamespaceHandler,再配置一下spring.handlers和spring.schemas就可以了。
http://docs.spring.io/spring/docs/current/spring-framework-reference/html/extensible-xml.html
其它的一些東東
防止XSD載入不成功的一個思路
http://hellojava.info/?p=135
齊全的Spring的namespace的列表
http://stackoverflow.com/questions/11174286/spring-xml-namespaces-how-do-i-find-what-are-the-implementing-classes-behind-t
Spring core
Spring Security
Spring integration
總結:
為什麼不要在Spring的配置裡,配置上XSD的版本號?
因為如果沒有配置版本號,取的就是當前jar裡的XSD檔案,減少了各種風險。
而且這樣約定大於配置的方式很優雅。
參考:
http://stackoverflow.com/questions/10768873/spring-di-applicationcontext-xml-how-exactly-is-xsischemalocation-used
http://stackoverflow.com/questions/11174286/spring-xml-namespaces-how-do-i-find-what-are-the-implementing-classes-behind-t
http://docs.spring.io/spring/docs/current/spring-framework-reference/html/extensible-xml.html