轉載：為什麼在 Spring 的配置裡，最好不要配置 xsd 檔案的版本號

kycool發表於2021-12-08
Spring

轉載地址：https://www.cnblogs.com/javastack/p/13952036.html

1 為什麼 dubbo 啟動沒有問題？

這篇 blog 源於一個疑問：

我們公司使了阿里的dubbo，但是阿里的開源網站 http://code.alibabatech.com，掛掉有好幾個月了，為什麼我們的應用啟動沒有問題？

我們的應用的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"
       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檔案的。或者為什麼在Eclipse裡xml沒有錯誤提示？

比如這樣的一個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">

我們也可以在後面加上版本號：

xsi:schemaLocation="http://www.springframework.org/schema/beans
    http://www.springframework.org/schema/beans/spring-beans-3.0.xsd">

2 XML的一些概念

首先來看下xml的一些概念：

xml 的 schema 裡有 namespace，可以給它起個別名。比如常見的 spring 的 namespace：

xmlns:mvc="http://www.springframework.org/schema/mvc"
xmlns:context="http://www.springframework.org/schema/context"

通常情況下，namespace對應的 URI 是一個存放 XSD 的地址，儘管規範沒有這麼要求。

如果沒有提供 schemaLocation ，那麼 Spring 的 xml 解析器會從 namespace 的 URI 里載入 XSD 檔案。我們可以把配置檔案改成這個樣子，也是可以正常工作的：

<?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。

3 如何跳過Spring的XML校驗？

可以用這樣的方式來跳過校驗：

GenericXmlApplicationContext context = new GenericXmlApplicationContext();context.setValidating(false);

4 如何寫一個自己的spring xml namespace擴充套件?

可以參考 Spring 的文件，實際上是相當簡單的。只要實現自己的 NamespaceHandler，再配置一下 spring.handlers 和 spring.schemas 就可以了。

http://docs.spring.io/spring/docs/current/spring-framework-reference/html/extensible-xml.html

5 其它的一些東東

防止 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
    aop - AopNamespaceHandler
    c - SimpleConstructorNamespaceHandler
    cache - CacheNamespaceHandler
    context - ContextNamespaceHandler
    jdbc - JdbcNamespaceHandler
    jee - JeeNamespaceHandler
    jms - JmsNamespaceHandler
    lang - LangNamespaceHandler
    mvc - MvcNamespaceHandler
    oxm - OxmNamespaceHandler
    p - SimplePropertyNamespaceHandler
    task - TaskNamespaceHandler
    tx - TxNamespaceHandler
    util - UtilNamespaceHandler

Spring Security
    security - SecurityNamespaceHandler
    oauth - OAuthSecurityNamespaceHandler

Spring integration
    int - IntegrationNamespaceHandler
    amqp - AmqpNamespaceHandler
    event - EventNamespaceHandler
    feed - FeedNamespaceHandler
    file - FileNamespaceHandler
    ftp - FtpNamespaceHandler
    gemfire - GemfireIntegrationNamespaceHandler
    groovy - GroovyNamespaceHandler
    http - HttpNamespaceHandler
    ip - IpNamespaceHandler
    jdbc - JdbcNamespaceHandler
    jms - JmsNamespaceHandler
    jmx - JmxNamespaceHandler
    mail - MailNamespaceHandler
    redis - RedisNamespaceHandler
    rmi - RmiNamespaceHandler
    script - ScriptNamespaceHandler
    security - IntegrationSecurityNamespaceHandler
    sftp - SftpNamespaceHandler
    stream - StreamNamespaceHandler
    twitter - TwitterNamespaceHandler
    ws - WsNamespaceHandler
    xml - IntegrationXmlNamespaceHandler
    xmpp - XmppNamespaceHandler

6 總結

為什麼不要在 Spring 的配置裡，配置上 XSD 的版本號？

因為如果沒有配置版本號，取的就是當前 jar 裡的 XSD 檔案，減少了各種風險。 而且這樣約定大於配置的方式很優雅。

參考：

相關文章