警告：以下內容如果對xml schema不瞭解可能會感覺不適。

eclipse使用xsd檔案可以輔助編輯xml檔案。如果我們自定義了schema檔案，需要匯入到xml catalog才可以生效。

如，自定義了logback配置檔案的xsd，名為：logback.xsd

那麼匯入Eclipse中的方法有兩種。

匯入Namespace name key

Preferences -> XML -> xml Catalog;

點選 Add 按鈕，分別輸入如下內容：

Location：選擇專案或檔案系統中的xsd檔案。
Key type: Namespace name
Key: http://logback.qos.ch/logback.xsd
 

那麼logback.xml檔案如下設定：

<?xml version="1.0" encoding="UTF-8"?>
<configuration xmlns="http://logback.qos.sh/logback"
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
</configuration>

schemaLocation中填寫前面指定的”Key”的字串。

匯入Schema Location key

使用名稱空間

見多了Spring中的配置檔案可能會發現，schemaLocation是如下的形式指定的：

xsi:schemaLocation="[namespace] [schemalocation]"

如果要使用這種方式，需要建立SchemaLocation。

Preferences -> XML -> xml Catalog;

點選 Add 按鈕，分別輸入如下內容：

Location：選擇專案或檔案系統中的xsd檔案。
Key type: Schema Location
Key: http://logback.qos.ch/logback.xsd

相應的配置檔案如下：

<configuration xmlns="http://logback.qos.ch/logback"
 

xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xsi:schemaLocation="http://logback.qos.ch/logback http://logback.qos.ch/logback.xsd">

此處的名稱空間是schema中定義的targetNamespace，而不是當前xml檔案的xmlns。

不使用名稱空間

如果schema定義中沒有使用名稱空間，那麼使用noNamespaceSchemaLocation指定schema的key。

由於xsd中沒有使用名稱空間，那麼xml也不要使用名稱空間，即”xmlns”不要設定，否則無法在xmlns中找xsd定義的無名稱空間的configuration節點。

<?xml version="1.0" encoding="UTF-8"?>
<configuration
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xsi:noNamespaceschemaLocation="http://logback.qos.ch/logback0.xsd">

注：xsd檔案也需要刪除targetNameSpace。

如果eclipse提示：white space is required between publicid and systemid 可以在xml第二行新增：<!DOCTYPE configuration>,注意修改根節點名稱。

測試發現一個問題，可以進行語法校驗，但沒有語法提示，或許eclipse的xml editor是根據ns去檢索的？。

小結：

使用 “Namespace name”，在eclipse增加catalog為Namespace，那麼xml中直接使用名稱空間就可以使用xsd檔案來控制xml。

使用 “Schema location”，分為兩種情況：

規範的使用名稱空間，xml中需要通過屬性"xsi:schemaLocation"來指定"[namespace] [schemalocation]";

不使用名稱空間，xml中需要通過屬性"xsi:noNamespaceschemaLocation"來指定"Scheme location"。注：xsd和xml均不可使用名稱空間。

xsd檔案修改以後，需要在xml catalog中reload一下，xml檔案也關閉重新開啟一下。

例項

你希望為logback建立一個schema。

使用名稱空間的schema

schema程式碼

限於篇幅，只寫了appender節點。

<?xml version="1.0" encoding="UTF-8"?>
<schema xmlns="http://www.w3.org/2001/XMLSchema"
 targetNamespace="http://logback.qos.sh/logback"
 xmlns:xs="http://www.w3.org/2001/XMLSchema"
 xmlns:tns="http://logback.qos.sh/logback" elementFormDefault="qualified" attributeFormDefault="qualified">

    <element name="configuration" type="tns:ConfiurationType"></element>

    <complexType name="ConfiurationType">
        <sequence>
            <element name="appender" type="tns:AppenderType"></element>
        </sequence>
        <attribute name="debug" type="boolean" default="false"></attribute>
        <attributeGroup ref="tns:scanConf"></attributeGroup>
    </complexType>
    <attributeGroup name="scanConf">
        <attribute name="scan" type="boolean" default="false"></attribute>
        <attribute name="scanPeriod" type="string" default="60 seconds"></attribute>
    </attributeGroup>

    <complexType name="AppenderType">
        <sequence>
            <element name="Encoder" type="tns:EncoderType" maxOccurs="1" minOccurs="1"></element>
        </sequence>
        <attribute name="name" type="string" use="required"></attribute>
        <attribute name="class" type="string" use="required"></attribute>
    </complexType>

    <complexType name="EncoderType">
        <sequence>
            <element name="pattern" type="string" maxOccurs="1" minOccurs="1"></element>
        </sequence>
    </complexType>

</schema>

xml catalog中配置Namespace name

xml catalog配置項

Location：選擇這個xsd檔案
Key type: Namespace name
Key: http://logback.qos.sh/ns

注，這裡的key沒有強制要求必須是xsd中定義的targetNamespace，或者說這裡可以覆蓋預設的targetNamespace。

xml引用Namespace name

<?xml version="1.0" encoding="UTF-8"?>
<configuration xmlns="http://logback.qos.sh/ns"
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
</configuration>

xml中預設名稱空間，即xmlns與配置的Key相同，即可生效。

另外一種配置方式，我的xml中配置了自己的預設名稱空間，那麼可以為schema指定別名：

<?xml version="1.0" encoding="UTF-8"?>
<logback:configuration xmlns="http://www.example.com/myapp" xmlns:logback="http://logback.qos.sh/ns">
</logback:configuration>

這是xml規範的基本知識，更多參考xml規範文件。

xml catalog中配置schema location

xml catalog配置項

注，這裡的key沒有強制要求必須是xsd檔案的物理uri，但是，為了便於你的使用者深入瞭解細節，應該提供物理存在的uri。

xml引用Schema location

<?xml version="1.0" encoding="UTF-8"?>
<configuration xmlns="http://logback.qos.sh/logback"
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xsi:schemaLocation="http://logback.qos.sh/logback http://logback.qos.ch/logback.xsd">
</configuration>

注：這裡xmlns為schema檔案中的targetNamespace。

同樣有另一種別名的方式：

<?xml version="1.0" encoding="UTF-8"?>
<logback:configuration xmlns="http://www.example.com/myapp" xmlns:logback="http://logback.qos.sh/logback"
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xsi:schemaLocation="http://logback.qos.sh/logback http://logback.qos.ch/logback.xsd">
</logback:configuration>

注：這裡 xmlns:logback 為schema檔案中的targetNamespace。

不使用名稱空間的schema

schema程式碼

<?xml version="1.0" encoding="UTF-8"?>
<xs:schema xmlns:xs="http://www.w3.org/2001/XMLSchema"
 xmlns:tns="http://logback.qos.sh/logback" elementFormDefault="qualified">

    <xs:element name="configuration" type="ConfiurationType"></xs:element>

    <xs:complexType name="ConfiurationType">
        <xs:sequence>
            <xs:element name="appender" type="AppenderType"></xs:element>
        </xs:sequence>
        <xs:attribute name="debug" type="xs:boolean" default="false"></xs:attribute>
        <xs:attributeGroup ref="scanConf"></xs:attributeGroup>
    </xs:complexType>
    <xs:attributeGroup name="scanConf">
        <xs:attribute name="scan" type="xs:boolean" default="false"></xs:attribute>
        <xs:attribute name="scanPeriod" type="xs:string" default="60 seconds"></xs:attribute>
    </xs:attributeGroup>

    <xs:complexType name="AppenderType">
        <xs:sequence>
            <xs:element name="Encoder" type="EncoderType" maxOccurs="1" minOccurs="1"></xs:element>
        </xs:sequence>
        <xs:attribute name="name" type="xs:string" use="required"></xs:attribute>
        <xs:attribute name="class" type="xs:string" use="required"></xs:attribute>
    </xs:complexType>

    <xs:complexType name="EncoderType">
        <xs:sequence>
            <xs:element name="pattern" type="xs:string" maxOccurs="1" minOccurs="1"></xs:element>
        </xs:sequence>
    </xs:complexType>
</xs:schema>

與前面的比較就是刪除了targetNamespace，同時將型別引用中的tns:字首刪除。

xml catalog中配置schema location

xml catalog配置項

注，這裡的key沒有強制要求必須是xsd檔案的物理uri，但是，為了便於你的使用者深入瞭解細節，應該提供物理存在的uri。

xml引用Schema location

<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE configuration>
<configuration xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
    xsi:noNamespaceSchemaLocation="http://logback.qos.sh/logback_nons.xsd">
<appender name="d" class="c">
    <Encoder>
        <pattern>a</pattern>
    </Encoder>
</appender>
</configuration>