DIV CSS 佈局教程網

您现在的位置: DIV+CSS佈局教程網 >> 網頁腳本 >  >> XML學習教程 >> XML詳解
CAM 內容裝配機制入門:用「結構與規則分離」提升 XML 驗證水準
編輯:XML詳解     

CAM 是 Content Assembly Mechanism(內容裝配機制)的縮寫,它是一套 XML 結構驗證方法。由於它相對年輕、文件稀少,本文的目標就是充当那份「缺少的手冊」。

從 DTD 到 CAM:驗證技術的演進

XML 文件的驗證,核心要確認兩件事:文件是完整的,並且符合文件類型定義(Document Type Definition,DTD)中指定的規則。DTD 是最早的規範方法,提供了有用但有限的功能來驗證結構,語義能力幾乎為零。

隨後出現的 XML Schema 帶來更多彈性與更強的結構支援,語義表達也明顯改善;Schematron 與 RelaxNG 則嘗試進一步提升語義支援,但推進幅度有限。CAM 是一項在 OASIS 傘下開發的全新技術。

CAM 不只是一個 schema 語言。它的設計目標是更好地滿足業務交流與互操作性要求,同時驗證 XML 的結構與語義,並力求簡潔、易用、易維護。它最關鍵的特性是上下文機制:能依據 XML 文件的其他部分或外部參數,動態調整哪些 XML 實例應被視為有效。

必須誠實說明的是,CAM 的開發速度很快,因此文中難免出現「在撰寫本文時」這類時間限定語。開發團隊反應積極,你回報的問題很可能很快就被修掉,甚至有些問題你還沒發現就已經不存在了。撰寫本文時,CAM 的文件狀態是:一份正式規範、一份白皮書、一份簡報,以及若干簡要介紹編輯器與 API 的網頁,尚無明確的指引與教學。

閱讀前的準備

  • 基本的 XPath 知識:CAM 大量使用 XPath 來定義業務規則,建議先複習 w3school 的 XPath 教程。
  • 基本的 XML Schema 知識:本文表面上看起來像是 XML Schema 的延伸,因為它廣泛依賴與 XML Schema 的對比來溝通,建議先複習 w3school 的 XML Schema 教程。

什麼才算「合法的 XML」

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> 中未能明確嵌入的所有語義,包括資料型別、約束、基數、條件等。

CAM 的優勢

下表相對於 XML Schema 與 DTD 總結了 CAM 的關鍵優勢,其中每一項都會在本文後續或未來的文章中介紹。

#項目DTDXML SchemaCAM範例/註釋
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採用情況成熟成熟初生嬰兒成熟的技術穩定性更好、支援更多
16APIJava、Perl、Ruby、.NetJava
17開放標準是是是

表 1 重要驗證特性對比:DTD、XML Schema 與 CAM。

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 把規則視圖中的內容集中整理如下,即使還沒深入研究細節,你也能歸納出幾個特徵:

  • 規則可以是有條件的或絕對的,例如 orderDate 的格式要求會依其長度而改變。
  • 項目與條件都以 XPath 指定。CAM 大量使用 XPath,這帶來極大的彈性與清晰度;相比之下,XML Schema 1.0 只在 xs:unique 與 xs:key 這類進階概念中用到 XPath。
  • 規則的適用範圍可寬可窄。XPath 支援選取文件中的任何部分:單一元素、單一屬性、所有指定名稱的元素、樹中特定位置的元素等。
  • 規則是壓縮、簡潔且非常直觀的。實際上,撰寫 CAM 規則的過程和撰寫應用程式需求幾乎相同。
條件項目行為
//purchaseOrder/@orderDatemakeOptional()
string-length(.) < 11//purchaseOrder/@orderDatesetDateMask(YYYY-MM-DD)
string-length(.) > 10//purchaseOrder/@orderDatesetDateMask(YYYY-MM-DDZ)
//shipTo/@countrymakeOptional()
//shipTo/@countrydatatype(NMTOKEN)
//shipTo/zipsetNumberMask(######.##)
//billTo/@countrymakeOptional()
//billTo/@countrydatatype(NMTOKEN)
//billTo/zipsetNumberMask(######.##)
//purchaseOrder/commentmakeOptional()
//items/itemmakeRepeatable()
//items/itemmakeOptional()
//item/quantitysetNumberMask(######)
//item/quantitysetNumberRange(1-999999)
//item/USPricesetNumberMask(######.##)
//item/commentmakeOptional()
//item/shipDatemakeOptional()
string-length(.) < 11//item/shipDatesetDateMask(YYYY-MM-DD)
string-length(.) > 10//item/shipDatesetDateMask(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 編輯器修正它。

若照著本文操作時模板不如預期運作,請檢查兩件事:

  • 點擊「工具 → 驗證 CAM 模板」以找出所有問題。
  • 若在執行 JCam 對話框中點「完成」卻好像什麼都沒發生,請按「取消」關閉,然後查看主控台視圖的錯誤訊息。例如忘記指定要驗證的 XML 檔時,對話框不會停用「完成」按鈕,而主控台視圖會回報「模板是空的」——這訊息多少有點誤導。若主控台視圖什麼都沒顯示,那就代表一切正常。

建立業務規則

在結構視圖中選取 <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)
90952PassPass
90952.1FailFail
123456FailFail
90952-1234FailFail
1PassFail
(空白)FailFail
90952aFailFail
-12345PassFail
(123)FailFail

表 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 在資料型別/排序/基數方面的詳細對比,最後還會說明如何避開常見錯誤。

XML學習教程| jQuery入門知識| AJAX入門| Dreamweaver教程| Fireworks入門知識| SEO技巧| SEO優化集錦|
Copyright © DIV+CSS佈局教程網 All Rights Reserved