在列表中追加新值是一種常見且必要的需求。Schema 設計者往往希望能在系統架構中預留一種添加附加值的方法,而這些值在設計階段通常是未知的。那麼,如何創建一個既可擴展、又易於實現的枚舉列表?本文介紹幾種可行的方案。
遺憾的是,XML Schema 規範並不允許在枚舉列表創建後進行擴展——設計階段选定的值是固定的。儘管如此,人們仍會採用各種替代方案來實現擴展,尤其是那些使用既有、無法修改的模式的客戶,他們希望在增加新功能的同時保持向後兼容。
枚舉列表是某個數據點的一组指定值。例如國家代碼列表可能包含 DE(德國)、US(美國)、JP(日本)。當出現一個新國家,如 TL(東帝汶)或 BA(波赫)時,使用舊列表的客戶就必須修改實現來容納新值。
在尋找解決方案時,可從四個關鍵標準衡量:
有些人認為根本不應擴展枚舉列表,若數據建模者能控制原始模型,直接創建更大的模型或許是理想做法;但當你無法控制原始模式、又需要在設計後擴展時,這種方法就行不通。也有人主張繞過 XML Schema 解析器,用 Genericode 在第二層驗證,但這無法在單一週期內完成。
下面以婚姻狀況組件為例,原始列表如下:
<xsd:simpleType name="MaritalStatusEnumType">
<xsd:restriction base="xsd:normalizedString">
<xsd:enumeration value="Divorced"/>
<xsd:enumeration value="Married"/>
...
</xsd:restriction>
</xsd:simpleType>
假設某公司需要支持貿易夥伴使用的新值 CivilUnion,該如何實現?
最直接的方法是保留模式的本地副本並加入新枚舉值。優點是易於實現;缺點是需要修改原始模式、難以控制版本演進,且手動編輯容易出錯。
創建一個新的枚舉列表,再用 <xsd:union> 與原列表合併:
<xsd:simpleType name="MaritalStatusType_Union"> <xsd:union memberTypes="MyExtMaritalStatusEnumType MaritalStatusEnumType"/> </xsd:simpleType>
優點是不改變原始枚舉列表;缺點是設計階段必須已知所有值,且需要工具支持 xsd:union。
以眼睛顏色為例,先建立一個正則表達式模式,凡是以 x: 為前綴的任意字符串都算擴展值:
<xsd:simpleType name="StringPatternType">
<xsd:restriction base="xsd:string">
<xsd:pattern value="x:\S.*"/>
</xsd:restriction>
</xsd:simpleType>
再用 union 把兩者結合,讓同一節點同時擁有標準值與擴展值:
<PersonEyeColor>Black</PersonEyeColor> <PersonEyeColor>x:Teal</PersonEyeColor>
優點是同一元素可用於所有數據、擴展值清晰分隔、並允許後期綁定新值;缺點是需要解析內容以判斷是否擴展,且解析器須支持正則表達式與 union。
保持枚舉字段不變,另設一個擴展字段來容納附加值。這種方式對原始列表零侵入,適合無法改動既有字段的場景。