CAM 是 Content Assembly Mechanism(內容裝配機制)的縮寫,它是一套 XML 結構驗證方法。由於它相對年輕、文件稀少,本文的目標就是充当那份「缺少的手冊」。
XML 文件的驗證,核心要確認兩件事:文件是完整的,並且符合文件類型定義(Document Type Definition,DTD)中指定的規則。DTD 是最早的規範方法,提供了有用但有限的功能來驗證結構,語義能力幾乎為零。
隨後出現的 XML Schema 帶來更多彈性與更強的結構支援,語義表達也明顯改善;Schematron 與 RelaxNG 則嘗試進一步提升語義支援,但推進幅度有限。CAM 是一項在 OASIS 傘下開發的全新技術。
CAM 不只是一個 schema 語言。它的設計目標是更好地滿足業務交流與互操作性要求,同時驗證 XML 的結構與語義,並力求簡潔、易用、易維護。它最關鍵的特性是上下文機制:能依據 XML 文件的其他部分或外部參數,動態調整哪些 XML 實例應被視為有效。
必須誠實說明的是,CAM 的開發速度很快,因此文中難免出現「在撰寫本文時」這類時間限定語。開發團隊反應積極,你回報的問題很可能很快就被修掉,甚至有些問題你還沒發現就已經不存在了。撰寫本文時,CAM 的文件狀態是:一份正式規範、一份白皮書、一份簡報,以及若干簡要介紹編輯器與 API 的網頁,尚無明確的指引與教學。
XML 文件是元素的多層次組合,本質上是一個用來儲存任意文字或資料結構的樹狀結構。文件必須格式良好(well-formed):只有一個根,元素與屬性必須符合基本的 XML 語法規則。
但在 XML 尚未對應到特定問題域(數學運算、書籍協作、金融交易等)之前,它其實沒什麼用處。這種對應會把抽象的 XML 結構,透過某種專業 XML 語言與你的具體問題連結起來。任何專用語義都必須事先定義好,否則就會被判定為無效而遭到拒絕。
思考下面這個客戶地址片段:
<address>
<address_street>221B Baker Street</address_street>
...
</address>
若要在 XML Schema 中驗證它,通常會定義類似下面的結構:
<xs:element name="address">
...
<xs:element name="address_street" type="xs:string"/>
...
</xs:element>
這些限制條件指出:address_street 元素必須存在、必須包含在 address 元素內,且必須是一個字串。對地址而言,一個簡單的字串值或許堪用,但其他欄位你大概會想用更具體的型別——受限字串、日期、整數或其他自訂型別。
XML Schema 是基於語法的系統,你必須同時為語義與結構定義語法。另一方面,Schematron 是基於規則的系統,可以用規則同時指定語義與結構——你不僅用規則說明 address_street 是一個字串,還要用規則說明它必須出現在 address 元素內。不論哪種,XML Schema 與 Schematron 從根本上都把語義與結構糾纏在一起。用程式設計的語言來說,這是高度耦合,並不可取。
相比之下,CAM 是一個混合系統:它把結構從語義中獨立出來(低耦合),再用規則指定語義。同一個 address 範例在 CAM 中長這樣:
<as:Structure>
<address>
<address_street>%street number and name%</address_street>
...
</address>
</as:Structure>
<as:Rules>
<as:constraint action="datatype(//address_street,string)" />
</as:Rules>
CAM 模板的 <as:Structure> 小節定義了 XML 文件的層級結構。實際上它是直接從 XML 實例複製而來,只把真實資料替換成以百分比符號標記的占位符。也就是說,上面這個模板代表「一個使用 %street number and name% 作為占位符的 XML 實例」。
<as:Structure> 同時補充了部分語義:它定義了某元素包含哪些其他元素、以及順序。與 Schematron 不同,你不需要費力撰寫規則程式碼來描述結構——CAM 以所見即所得的方式指定結構。這就像用 Word 排版文件,比直接撰寫 RTF 標記輕鬆太多,後者既枯燥又容易出錯。
圖片看不清楚?請點擊這裡查看原圖(大圖)。
圖 1 所見即所得的示例:Word 以直觀形式編輯文件(左側),但這兩種方式其實在完成同一件事。
即使有 XmlSpy 或 Liquid XML Studio 這類工具能營造所見即所得的感覺,XML Schema 本身仍不是所見即所得的。看下面這段定義 cost 的程式碼,範圍 1–999、保留兩位小數:
<xs:element name="cost">
<xs:simpleType>
<xs:restriction base="xs:decimal">
<xs:fractionDigits value="2" />
<xs:totalDigits value="5" />
<xs:minInclusive value="1" />
<xs:maxInclusive value="999" />
</xs:restriction>
</xs:simpleType>
</xs:element>
而下面兩行 CAM 語法是完全等效的:
<as:constraint action="setNumberMask(//Part/cost,###.##)" />
<as:constraint action="setNumberRange(//Part/cost,1-999)" />
CAM 模板的 <as:Rules> 小節定義了 <as:Structure> 中未能明確嵌入的所有語義,包括資料型別、約束、基數、條件等。
下表相對於 XML Schema 與 DTD 總結了 CAM 的關鍵優勢,其中每一項都會在本文後續或未來的文章中介紹。
| # | 項目 | DTD | XML Schema | CAM | 範例/註釋 |
|---|---|---|---|---|---|
| 1 | 隔離結構與業務規則 | 無 | 無 | 有 | |
| 2 | 當前節點固定驗證 | 無 | 有 | 有 | 把 quantity 固定在 1 到 100 之間 |
| 3 | 當前節點條件驗證 | 無 | 受限 | 有 | zip 必須是 5 位數或 10 位數 |
| 4 | 跨節點條件驗證 | 無 | 受限 | 有 | 若 state 是 FL、NV、SD、TX、WA、WY、NH 或 TN,則 taxable 必須為 no,否則為 yes |
| 5 | 上下文機制 | 無 | 有 | 有 | 取決於條件 A 或 B 是否成立 |
| 6 | 結構可變性 | 無 | 無 | 有 | 訂購數量超過 25kg 的客戶必須選擇一種物流運送方式 |
| 7 | 參數化引用 | 無 | 無 | 有 | 從加拿大採購須符合條件 x、y、z;從紐西蘭訂購須符合條件 a、b、c |
| 8 | 命名空間感知 | 無 | 有 | 有 | |
| 9 | 自訂資料型別 | 不行 | 可以 | 可以 | bookNumber 必須是 8 位字串 |
| 10 | 語法與文件一致 | 不行 | 可以 | 可以 | |
| 11 | 程式碼重用 | 受限 | 可以 | 可以 | shipTo 與 billTo 位址共用相同的驗證規則 |
| 12 | 工具/編輯器 | 多 | 多 | 1 | |
| 13 | 圖形化設計器 | 多 | 多 | 無 | 使用 XML Schema 設計器時可設計出複雜結構 |
| 14 | 所見即所得 | 需擴充框架 | 需擴充框架 | 固有 | 業務規則語句與它們執行時幾乎一致,真正做到所見即所得 |
| 15 | 採用情況 | 成熟 | 成熟 | 初生嬰兒 | 成熟的技術穩定性更好、支援更多 |
| 16 | API | Java、Perl、Ruby、.Net | Java | ||
| 17 | 開放標準 | 是 | 是 | 是 | |
表 1 重要驗證特性對比:DTD、XML Schema 與 CAM。
可從 https://www.jcam.org.uk/ 下載最新版的 CAM 編輯器。選項有 CAM 模板編輯器與 JCam 引擎兩種;本文大部分內容只需要模板編輯器(JCam 引擎負責執行 CAM 驗證)。
啟動編輯器後,你可以從零開始,也可以從既有的 XML 文件或 XSD 文件建立模板。實際操作起來相當簡單。這裡沿用 W3C 的 Purchase Order 模型:先把該檔案存到本機並命名為 po.xsd,接著在編輯器中選擇「檔案 → 從模型新建模板」,指定剛才儲存的路徑與檔名(如圖 2)。處理過程可能停頓數秒,完成後編輯器會填入根元素的 comment 區域。
圖 2 「從模型新建模板」對話框:指定 XSD 的路徑與檔名,再從清單中選擇根元素,編輯器即為你建立基礎 CAM 模板。
Comment 元素其實是 po.xsd 中所有 <xsd:element> 節點依字母順序排列時的第一個名稱,該檔案包含 comment 與 purchaseOrder 兩個節點。你可以在清單 1 看到完整模型。
<xsd:schema xmlns:xsd="https://www.w3.org/2001/XMLSchema">
<xsd:annotation>
<xsd:documentation XML:lang="en">
Purchase order schema for Example.com.
Copyright 2000 Example.com. All rights reserved.
</xsd:documentation>
</xsd:annotation>
<xsd:element name="purchaseOrder" type="PurchaseOrderType"/>
<xsd:element name="comment" type="xsd:string"/>
<xsd:complexType name="PurchaseOrderType">
<xsd:sequence>
<xsd:element name="shipTo" type="USAddress"/>
<xsd:element name="billTo" type="USAddress"/>
<xsd:element ref="comment" minOccurs="0"/>
<xsd:element name="items" type="Items"/>
</xsd:sequence>
<xsd:attribute name="orderDate" type="xsd:date"/>
</xsd:complexType>
<xsd:complexType name="USAddress">
<xsd:sequence>
<xsd:element name="name" type="xsd:string"/>
<xsd:element name="street" type="xsd:string"/>
<xsd:element name="city" type="xsd:string"/>
<xsd:element name="state" type="xsd:string"/>
<xsd:element name="zip" type="xsd:decimal"/>
</xsd:sequence>
<xsd:attribute name="country" type="xsd:NMTOKEN" fixed="US"/>
</xsd:complexType>
<xsd:complexType name="Items">
<xsd:sequence>
<xsd:element name="item" minOccurs="0" maxOccurs="unbounded">
<xsd:complexType>
<xsd:sequence>
<xsd:element name="productName" type="xsd:string"/>
<xsd:element name="quantity">
<xsd:simpleType>
<xsd:restriction base="xsd:positiveInteger">
<xsd:maxExclusive value="100"/>
</xsd:restriction>
</xsd:simpleType>
</xsd:element>
<xsd:element name="USPrice" type="xsd:decimal"/>
<xsd:element ref="comment" minOccurs="0"/>
<xsd:element name="shipDate" type="xsd:date" minOccurs="0"/>
</xsd:sequence>
<xsd:attribute name="partNum" type="SKU" use="required"/>
</xsd:complexType>
</xsd:element>
</xsd:sequence>
</xsd:complexType>
<!-- Stock Keeping Unit, a code for identifying products -->
<xsd:simpleType name="SKU">
<xsd:restriction base="xsd:string">
<xsd:pattern value="\d{3}-[A-Z]{2}"/>
</xsd:restriction>
</xsd:simpleType>
</xsd:schema>
清單 1 po.xsd 模型。
你真正想要的根是 purchaseOrder,因此在對話框中把根元素切換成 purchaseOrder,點擊「確定」生成模板。程式接著會提示儲存,儲存後模板便在 CAM 模板編輯器中開啟(如圖 3)。
圖片看不清楚?請點擊這裡查看原圖(大圖)。
圖 3 CAM 編輯器:從 po.xsd 模型生成模板後,編輯器同時顯示結構與規則。
編輯器中每個標籤容器都對應一個視圖。結構視圖以樹狀呈現 XML 的層級:圖 3 中可見訂單有一個 orderDate 屬性與四個子節點(shipTo、billTo、comment、items),而 items 可包含多個 item 子節點。編輯器精確反映了底層的 CAM 模板檔(PurchaseOrder/purchaseOrder_from_schema.cam),其中 <as:AssemblyStructure> 小節的內容與結構視圖的資訊完全一致:
<as:AssemblyStructure>
<as:Structure taxonomy="XML" ID="purchaseOrder" reference="">
<purchaseOrder orderDate="%YYYY-MM-DDZ%">
<shipTo country="US">
<name>%string%</name>
<street>%string%</street>
<city>%string%</city>
<state>%string%</state>
<zip>%54321.00%</zip>
</shipTo>
<billTo country="US">
<name>%string%</name>
<street>%string%</street>
<city>%string%</city>
<state>%string%</state>
<zip>%54321.00%</zip>
</billTo>
<comment>%string%</comment>
<items>
<item partNum="%string%">
<productName>%string%</productName>
<quantity>%1%</quantity>
<USPrice>%54321.00%</USPrice>
<comment>%string%</comment>
<shipDate>%YYYY-MM-DDZ%</shipDate>
</item>
</items>
</purchaseOrder>
</as:Structure>
</as:AssemblyStructure>
對照之下,XSD 把結構與業務規則混在一起,維護成本自然更高。以下是完整 CAM 檔的頂層框架,可看到兩個主要區塊:
<as:CAM
xmlns:as="https://www.oasis-open.org/committees/cam"
xmlns:xsd="https://www.w3.org/2001/XMLSchema"
xmlns:xml="https://www.w3.org/XML/1998/namespace"
xmlns:camed="https://jcam.org.uk/editor"
CAMlevel="1"
version="1.0">
<as:Header />
<as:AssemblyStructure />
<as:BusinessUseContext />
</as:CAM>
完整的 CAM 模板如下(清單 2)。
<as:CAM xmlns:as="https://www.oasis-open.org/committees/cam"
xmlns:xsd="https://www.w3.org/2001/XMLSchema"
xmlns:xml="https://www.w3.org/XML/1998/namespace"
xmlns:camed="https://jcam.org.uk/editor"
CAMlevel="1" version="1.0">
<as:Header>
<as:Description>Generated for : purchaseOrder</as:Description>
<as:Owner>To be Completed</as:Owner>
<as:Version>0.1 generator v1.18</as:Version>
<as:DateTime>2008-12-08T12:31:34</as:DateTime>
</as:Header>
<as:AssemblyStructure>
<as:Structure taxonomy="XML" ID="purchaseOrder" reference="">
... (同前)
</as:Structure>
</as:AssemblyStructure>
<as:BusinessUseContext>
<as:Rules>
<as:default>
<as:context>
<as:constraint action="makeOptional(//purchaseOrder/@orderDate)" />
<as:constraint condition="string-length(.) < 11"
action="setDateMask(//purchaseOrder/@orderDate,YYYY-MM-DD)" />
<as:constraint condition="string-length(.) > 10"
action="setDateMask(//purchaseOrder/@orderDate,YYYY-MM-DDZ)" />
<as:constraint action="makeOptional(//shipTo/@country)" />
<as:constraint action="datatype(//shipTo/@country,NMTOKEN)" />
<as:constraint action="setNumberMask(//shipTo/zip,######.##)" />
<as:constraint action="makeOptional(//billTo/@country)" />
<as:constraint action="datatype(//billTo/@country,NMTOKEN)" />
<as:constraint action="setNumberMask(//billTo/zip,######.##)" />
<as:constraint action="makeOptional(//purchaseOrder/comment)" />>
<as:constraint action="makeRepeatable(//items/item)" />
<as:constraint action="makeOptional(//items/item)" />
<as:constraint action="setNumberMask(//item/quantity,######)" />
<as:constraint action="setNumberRange(//item/quantity,1-999999)" />
<as:constraint action="setNumberMask(//item/USPrice,######.##)" />
<as:constraint action="makeOptional(//item/comment)" />
<as:constraint action="makeOptional(//item/shipDate)" />
<as:constraint condition="string-length(.) < 11"
action="setDateMask(//item/shipDate,YYYY-MM-DD)" />
<as:constraint condition="string-length(.) > 10"
action="setDateMask(//item/shipDate,YYYY-MM-DDZ)" />
</as:context>
</as:default>
</as:Rules>
</as:BusinessUseContext>
</as:CAM>
清單 2 生成的 CAM 模板。
規則視圖(圖 3 中高亮處)列出所有構成模板語義的業務規則。與結構不同,規則在檔案中的存法與規則視圖的呈現並不一致。表 2 把規則視圖中的內容集中整理如下,即使還沒深入研究細節,你也能歸納出幾個特徵:
xs:unique 與 xs:key 這類進階概念中用到 XPath。| 條件 | 項目 | 行為 |
|---|---|---|
//purchaseOrder/@orderDate | makeOptional() | |
string-length(.) < 11 | //purchaseOrder/@orderDate | setDateMask(YYYY-MM-DD) |
string-length(.) > 10 | //purchaseOrder/@orderDate | setDateMask(YYYY-MM-DDZ) |
//shipTo/@country | makeOptional() | |
//shipTo/@country | datatype(NMTOKEN) | |
//shipTo/zip | setNumberMask(######.##) | |
//billTo/@country | makeOptional() | |
//billTo/@country | datatype(NMTOKEN) | |
//billTo/zip | setNumberMask(######.##) | |
//purchaseOrder/comment | makeOptional() | |
//items/item | makeRepeatable() | |
//items/item | makeOptional() | |
//item/quantity | setNumberMask(######) | |
//item/quantity | setNumberRange(1-999999) | |
//item/USPrice | setNumberMask(######.##) | |
//item/comment | makeOptional() | |
//item/shipDate | makeOptional() | |
string-length(.) < 11 | //item/shipDate | setDateMask(YYYY-MM-DD) |
string-length(.) > 10 | //item/shipDate | setDateMask(YYYY-MM-DDZ) |
表 2 編輯器中的業務規則:由 XML Schema 轉換而來,CAM 自動生成。
有了模板,就可以拿它來驗證 XML 文件。W3C 除了提供訂單模型,也附了一份訂單實例(PurchaseOrder/po.xml),但下載而來的檔案有個印刷錯誤。圖 4 中高亮處即是該錯誤;若嘗試開啟或驗證這個格式不良的檔案,CAM 編輯器會顯示堆疊轉儲與錯誤訊息,並拒絕載入。
圖片看不清楚?請點擊這裡查看原圖(大圖)。
圖 4 格式不良的 XML:說明了原始 po.xml 為何不合適,載入 CAM 編輯器時直接暴露錯誤。
把感嘆號與左半邊尖括號的順序對調修正後(正確檔案為 PurchaseOrder/po_corrected.xml),即可用 CAM 編輯器載入該 XML。編輯器以 XML 視圖呈現,並繪製成與結構視圖同樣的樹狀結構(圖 5),此刻模板中相同的元素顯示的是真實值而非占位符。
圖 5 XML 視圖:開啟 XML 檔時以樹狀呈現,可折疊與展開。
要進行驗證,選擇「執行 → 執行 JCam」,你會看到圖 6 的 JCam 執行對話框。預設情況下 JCam 會選取已載入的 XML 文件,可透過其結構 ID(如 purchaseOrder,即該結構的根)辨識。點擊「完成」關閉對話框開始驗證,結果顯示於主視窗下方的執行結果視圖中。
注意:驗證過程發現了兩個錯誤,即使圖 6 只顯示了一個。仔細看會發現出錯的節點上有黃色或紅色圖示,其母公司元素也會顯示錯誤標記。本例中錯誤發生在 <zip> 元素,其父元素 <shipTo> 有錯誤圖示,連根元素 <purchaseOrder> 也有。以此類推,第二個錯誤藏在 <billTo> 之中。
圖片看不清楚?請點擊這裡查看原圖(大圖)。
圖 6 執行驗證:結果顯示於執行結果視圖,每個驗證失敗的元素或屬性都有錯誤標記,其上級元素則有警告標記。
奇怪的是,這個 XML 在任何 XML Schema 編輯器中驗證都沒有錯誤,為什麼在這裡失敗了?執行結果視圖指出 zip 依 CAM 模板定義是無效的:模板檢查它是否為浮點數,而美國郵遞區號其實是 5 位或 9 位整數。這個 CAM 規則來自 XSD 規格——規格中把 zip 定義為十進位數(可從清單 1 的 USAddress 複雜型別中的 zip 欄位看到)。CAM 模板產生器忠實反映了輸入,沒有自行修正。你可能不同意:提交的 XSD 太寬鬆,資料型別應該是整數而非十進位數。下一節就示範如何用 CAM 編輯器修正它。
若照著本文操作時模板不如預期運作,請檢查兩件事:
在結構視圖中選取 <shipTo> 下的 <zip> 元素,附加於該元素的規則會顯示在項目規則(ItemRules)視圖中。本例只有一條規則,使用 setNumberMask 謂詞。在 category 欄上按右鍵開啟情境選單,選擇「編輯規則」,即開啟編輯約束規則對話框(圖 7)。
圖片看不清楚?請點擊這裡查看原圖(大圖)。
圖 7 編輯約束規則:為修正附加在 //shipTo/zip 上的 setNumberMask,於結構視圖選取該元素、開啟情境選單、選擇編輯規則,然後在「數字特徵碼」欄位明確指定特徵碼。
在「數字特徵碼」欄位上點擊可開啟特徵碼編輯器,此處只需把 ######.## 改成 #####。關閉兩個對話框後,主編輯器視窗會顯示更新後的規則。重新執行驗證,//shipTo/zip 的錯誤應不再出現,只留下 //billTo/zip 的錯誤——很明顯這是同一個問題,可用相同手段修復。但由於 //billTo/zip 與 //shipTo/zip 的值應該一致,其實可以用一條通用規則取代兩條個別規則;本文第二部分會詳談通用規則的寫法。
規則更新後,占位符也應該跟著更新(圖 7 的項目 1)。與圖 6 對照,你會發現值從 %54321.00% 變成 %54321%,這更能代表郵遞區號。在這個例子中,元素的占位符與關聯規則關係緊密,假設它們會自動互相追蹤是合理的;但在許多情況下關係並不這麼直接——元素與規則之間是多對多關係:你可以對一個元素套用多條規則,也可以讓一條規則套用到多個元素。
要更新圖 7 中的占位符,在結構視圖的 //shipTo/zip 上開啟情境選單,選擇「編輯文字」,在對話框中把 54321.00% 改成 %54321%。
占位符服務兩個角色。其一,CAM 處理程式單獨依賴它來判斷某元素的內容是否已被固定——判斷依據就是包圍在兩側的百分比符號。值得注意的是,在更新元素占位符之前,你應該先重新驗證 //shipTo/zip,確認百分比符號之間的值確實被 CAM 處理程式忽略。其二,百分比符號之間的文字應該準確而簡明地說明該放什麼內容。通常上下文已替你完成了大部分工作:元素名稱是 zip,在美國它會立刻被理解為 5 位或 9 位整數。透過把占位符設為 %54321%,你告訴使用者此模板只接受 5 字元的郵遞區號。
現在你已更新了占位符與規則,但只改這兩處就足以驗證郵遞區號了嗎?要確認,得給 CAM 處理程式不同的測試用例。最簡單的方式是開啟含待驗資料的 XML 視圖,修改 //shipTo/zip 的值,然後重新驗證。XML 視圖中的節點編輯方式與結構視圖相同:開啟情境選單、選擇編輯文字。把每個值都驗一次,盡量涵蓋邊界與反例。表 3 就是這樣一份清單——從結果可見有兩處通過、多處失敗,而這兩個驗證函數必須都通過才算合格。
| //shipTo/zip 的值 | setNumberMask(#####) | setStringMask(00000) |
|---|---|---|
| 90952 | Pass | Pass |
| 90952.1 | Fail | Fail |
| 123456 | Fail | Fail |
| 90952-1234 | Fail | Fail |
| 1 | Pass | Fail |
| (空白) | Fail | Fail |
| 90952a | Fail | Fail |
| -12345 | Pass | Fail |
| (123) | Fail | Fail |
表 3 郵遞區號測試用例:比較數字型特徵碼 ##### 與字串型特徵碼 00000 的驗證結果。
兩個「假通過」的案例背後是同一個原因:特徵碼是數字型的,而這兩個測試值都是合法數字。雖然郵遞區號只含數字,它本質上其實是字串——從數字角度看,00001 與 1 相等;但在郵遞區號的語域中,00001 是有效代碼,1 不是。因此應改用文字型特徵碼:為 //shipTo/zip 開啟編輯約束對話框,把行為從 setNumberMask 改成 setStringMask,在 String Mask 欄位點擊開啟特徵碼編輯器,輸入五個 0(或按 0–9 之間任一數字五次),然後退出兩個對話框。現在重新驗證表 3 的每個用例,你會發現結果全部正確。
正式 CAM 規格書第 3.4.3 節(CAM 內容特徵碼語法)列出了所有有效的特徵碼字元,表 4 即改寫自該節。
| 字元 | 說明 |
|---|---|
| 字串特徵碼 | |
X | 任何字元,強制性 |
A | 強制性英數字元或空格 |
a | 非強制性英數字元或空格 |
? | 任何單一字元 |
* | 0 個或更多字元 |
U | 一個可轉為大寫的字元 |
^ | 大寫,非強制 |
L | 一個可轉為小寫的字元 |
_ | 小寫,非強制 |
0 | 數字,含後綴與前端插入的 0,以及前端插入的正負號 |
# | 數字,含後綴,取消前端插入的 0,保留前端插入的正負號 |
' ' | 轉義字元 |
| 數字型特徵碼 | |
0 | 數字,含後綴與前端插入的 0,以及前端插入的正負號 |
# | 數字,含後綴,取消前端插入的 0,保留前端插入的正負號 |
. | 小數點 |
J | 作為特徵碼的第一個字元時,會改用 Java 的格式化方法處理;傳給 Java 時字面 J 會被忽略 |
| 日期型特徵碼 | |
DD | 一月中的某天 |
DDD | 一年中的某天 |
DDDD | 一月中的相對某天 |
MM | 一年中的月份 |
MMM... | 月份名稱(如 January),欄位會被填滿或截斷為 3–10 個字元 |
YY | 兩位數年份 |
YYYY | 四位數年份 |
W | 一周中的某天 |
WWW... | 星期名稱,欄位會被填滿或截斷為 3–10 個字元 |
/ | 斜線,日期分隔符 |
- | 連字號,另一種日期分隔符 |
表 4 特徵碼字元:當規則行為需要特徵碼時,這些字元具有特定含義。
如果你想找一個文件完整清晰、所有 bug 都已清除的工具,CAM 可能會讓你失望;但若你不介意寶石周圍那一點點瑕疵,它會是工具箱裡一件相當有力的武器。就我使用的 1.6.2 版而言,CAM 編輯器與 CAM 引擎的行為完全合理。
第一部分到此結束。你現在至少知道,使用 CAM 設計其實並不困難。第二部分將展示 CAM 更強大的一面,並深入討論模板與規則的開發技術,包括:通用結構與通用規則、依據內部或外部因子的條件驗證、XSD 在資料型別/排序/基數方面的詳細對比,最後還會說明如何避開常見錯誤。