W2M數(shù)據(jù)網(wǎng)關(guān)模板標(biāo)簽說明

1、W2M 數(shù)據(jù)網(wǎng)關(guān)模板標(biāo)簽說明文件標(biāo)識：文件標(biāo)識：CoVics-W2M-RD-UR當(dāng)前版本：當(dāng)前版本：1.0作作 者：者：Wu Lei文件狀態(tài)：文件狀態(tài)： 草稿 正式發(fā)布完成日期：完成日期：2010-9-6文件控制版本記錄版本記錄日期日期作者作者參與者參與者變更說明變更說明2010-9-6Wu Lei目目目 錄錄錄1.文檔介紹文檔介紹.41.1.目的.41.2.范圍.41.3.讀者對象.41.4.參考資料.42.數(shù)據(jù)網(wǎng)關(guān)概述數(shù)據(jù)網(wǎng)關(guān)概述.43.模板簡介模板簡介.53.1.模板規(guī)范.54.擴(kuò)展標(biāo)簽擴(kuò)展標(biāo)簽.64.1.SUB 替換標(biāo)簽.64.2.LIST 列表標(biāo)簽 .74.3.CONTENT 內(nèi)容標(biāo)

2、簽.74.4.PLUGIN 插件標(biāo)簽 .81. 文檔介紹文檔介紹1.1. 目的目的本文主要定義 W2M 數(shù)據(jù)網(wǎng)關(guān)模板制作規(guī)范及模板擴(kuò)展標(biāo)簽，以使讀者理解并熟悉擴(kuò)展標(biāo)簽及其使用方法，并作為模板制作的主要依據(jù)。1.2. 范圍范圍針對 W2M 數(shù)據(jù)網(wǎng)關(guān)模板制作規(guī)范及擴(kuò)展標(biāo)簽說明。1.3. 讀者對象讀者對象本文讀者包括但不限于以下對象：項(xiàng)目經(jīng)理、系統(tǒng)架構(gòu)師、開發(fā)工程師、測試工程師、技術(shù)支持工程師1.4. 參考資料參考資料2. 數(shù)據(jù)網(wǎng)關(guān)概述數(shù)據(jù)網(wǎng)關(guān)概述W2M 數(shù)據(jù)網(wǎng)關(guān)采用 HTTP 反向代理的技術(shù)，將用戶手機(jī)訪問手機(jī)站點(diǎn)的請求，轉(zhuǎn)發(fā)到源 WEB 站點(diǎn)上，獲取源 WEB 網(wǎng)站返回的網(wǎng)頁內(nèi)容，并加載模板，對

3、源 WEB 網(wǎng)頁內(nèi)容按模板設(shè)定的規(guī)則重新組織和格式化，最后返回給用戶手機(jī)。如下圖所示：源 WEB 網(wǎng)站W(wǎng)2M 數(shù)據(jù)網(wǎng)關(guān)用戶手機(jī)模板請求手機(jī)網(wǎng)站請求源網(wǎng)站返回原始網(wǎng)頁內(nèi)容返回轉(zhuǎn)換后的內(nèi)容加載模板，重新組織內(nèi)容3. 模板簡介模板簡介由上述可知，模板的作用主要是對源網(wǎng)頁內(nèi)容重新組織和格式化，并展示給終端用戶。W2M 數(shù)據(jù)網(wǎng)關(guān)模板是基于 XHTML 的文檔，可以在模板中使用符合 XHTML BASIC 或 XHTML MOBILE PROFILE 標(biāo)準(zhǔn)的元素和屬性。以下元素不能在模板中使用：frame, frameset, iframe, script。事件也不能使用，如：onclick, onloa

4、d 等。此外，模板擴(kuò)展了一套專用標(biāo)簽，通過這些擴(kuò)展標(biāo)簽對源網(wǎng)頁內(nèi)容進(jìn)行操作和處理。后面有專門的章節(jié)詳述擴(kuò)展標(biāo)簽的具體使用方法。3.1. 模板規(guī)范模板規(guī)范一個(gè)標(biāo)準(zhǔn)的模板文檔，應(yīng)包括文檔類型聲明以及由標(biāo)簽包含的和消息體。例如下面的文檔：高維信誠此外，模板必須符合 XHTML 規(guī)范，包括：1.所有的標(biāo)記都必須要有一個(gè)相應(yīng)的結(jié)束標(biāo)記 。如.或2. 所有標(biāo)簽的元素和屬性的名字都必須使用小寫。如：3. 所有的 XML 標(biāo)記都必須合理嵌套 。如.4. 所有的屬性必須用引號括起來 。5. 所有非標(biāo)簽的或&等特殊符號用編碼表示 。如：< > &6. 屬性必須賦

5、值，而不能簡寫。 如：7. 注釋內(nèi)容中 不能出現(xiàn)”-”或“-”。8. 圖片標(biāo)簽必須有 alt 屬性說明文字。如：4. 擴(kuò)展標(biāo)簽擴(kuò)展標(biāo)簽擴(kuò)展標(biāo)簽名稱及屬性名稱使用小寫，屬性值不區(qū)分大小寫。標(biāo)簽屬性值支持單引號或雙引號包容，根據(jù)實(shí)際使用情況自定。4.1. Sub 替換標(biāo)簽替換標(biāo)簽在輸入源網(wǎng)頁內(nèi)容時(shí)將指定文本內(nèi)容替換成另外的內(nèi)容。用法用法待替換的內(nèi)容|替換后的內(nèi)容說明說明以”|”分隔開待替換的內(nèi)容和替換后的內(nèi)容。示例示例abc|ABC將源網(wǎng)頁中出現(xiàn)的 abc 字符串替換成大寫的 ABC備注備注如果有多個(gè)要替換的內(nèi)容，可以使用多個(gè) sub 標(biāo)簽。如果待替換或替換后的內(nèi)容中包含有破壞原 XML 文檔結(jié)構(gòu)

6、的特殊字符，如”，應(yīng)使用 CDATA 將整個(gè)值括起，如：!CDATA表示將”。4.2. List 列表標(biāo)簽列表標(biāo)簽獲取源網(wǎng)頁中指定節(jié)點(diǎn)中所包含的所有超鏈接（元素） ，以列表形式展現(xiàn)。用法用法說明說明tag：指明要獲取的內(nèi)容塊節(jié)點(diǎn)的開始標(biāo)簽。如：表示獲取源網(wǎng)頁的到之間的所有超鏈接。此開始標(biāo)簽也可以包含屬性。如： 指匹配到之間的超鏈接。如果是則匹配任何 div 標(biāo)簽中的超鏈接，包括或等。 sequence 屬性指出當(dāng)源網(wǎng)頁中出現(xiàn)多個(gè)相同的內(nèi)容節(jié)點(diǎn)時(shí)，要獲取第幾個(gè)內(nèi)容節(jié)點(diǎn)。如：表示取源網(wǎng)頁第二個(gè)節(jié)點(diǎn)中的所有超鏈接。sequence 不是必須的屬性。如果沒有該屬性則默認(rèn)取第一個(gè)匹配的內(nèi)容塊。split

7、：每個(gè)超鏈接之間的分隔字符串。如：表示每個(gè)超鏈接之間換行間隔， | 則表示每個(gè)超鏈接以字符“|”間隔。示例示例4.3. Content 內(nèi)容標(biāo)簽內(nèi)容標(biāo)簽取出源網(wǎng)頁中指定節(jié)點(diǎn)中所包含的內(nèi)容。用法用法說明說明tag：指明要獲取的內(nèi)容塊節(jié)點(diǎn)，用法與 list 標(biāo)簽的 tag 相同。如：表示獲取源網(wǎng)頁的到中的內(nèi)容。sequence 屬性指出當(dāng)源網(wǎng)頁中出現(xiàn)多個(gè)相同的內(nèi)容節(jié)點(diǎn)時(shí)，要獲取第幾個(gè)內(nèi)容節(jié)點(diǎn)。如：表示取源網(wǎng)頁第二個(gè)節(jié)點(diǎn)中的內(nèi)容。sequence 不是必須的屬性。如果沒有該屬性則默認(rèn)取第一個(gè)匹配的內(nèi)容塊。revtag：要保留的源網(wǎng)頁標(biāo)簽。如果有多個(gè)標(biāo)簽需要保留，以“|”分隔。如：table|tr|t

8、d|div表示保留、等標(biāo)簽。該值如果為空表示只輸出文本內(nèi)容而不保留任何 html 標(biāo)簽。示例示例4.4. Plugin 插件標(biāo)簽插件標(biāo)簽在當(dāng)前位置輸出一段由外部程序產(chǎn)生的 html 內(nèi)容。該外部程序可以是一個(gè)外部網(wǎng)頁鏈接，也可以是一個(gè)實(shí)現(xiàn)了CoVics.W2M.ReverseProxyBL命名空間下的ICustomApp接口的程序集。用法用法說明說明src 屬性指定網(wǎng)頁類型的外部鏈接地址。該地址必須是一段不帶查詢參數(shù)的 url，系統(tǒng)會附加用戶的請求查詢參數(shù)來請求該地址。class 屬性指定實(shí)現(xiàn) IcustomApp 接口的命名空間和類名，assembly 屬性指定該類所在的程序集名。這兩個(gè)屬性必須一起使用?？梢愿鶕?jù)需要只設(shè)置 src 的值或 assembly 和