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

1、W2M 數(shù)據(jù)網(wǎng)關(guān)模板標(biāo)簽說(shuō)明文件標(biāo)識(shí)：文件標(biāo)識(shí)：CoVics-W2M-RD-UR當(dāng)前版本：當(dāng)前版本：1.0作作 者：者：Wu Lei文件狀態(tài)：文件狀態(tài)： 草稿 正式發(fā)布完成日期：完成日期：2010-9-6文件控制版本記錄版本記錄日期日期作者作者參與者參與者變更說(shuō)明變更說(shuō)明2010-9-6Wu Lei目目目 錄錄錄1.文檔介紹文檔介紹.41.1.目的.41.2.范圍.41.3.讀者對(duì)象.41.4.參考資料.42.數(shù)據(jù)網(wǎng)關(guān)概述數(shù)據(jù)網(wǎng)關(guān)概述.43.模板簡(jiǎn)介模板簡(jiǎn)介.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. 范圍范圍針對(duì) W2M 數(shù)據(jù)網(wǎng)關(guān)模板制作規(guī)范及擴(kuò)展標(biāo)簽說(shuō)明。1.3. 讀者對(duì)象讀者對(duì)象本文讀者包括但不限于以下對(duì)象：項(xiàng)目經(jīng)理、系統(tǒng)架構(gòu)師、開(kāi)發(fā)工程師、測(cè)試工程師、技術(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ī)訪問(wèn)手機(jī)站點(diǎn)的請(qǐng)求，轉(zhuǎn)發(fā)到源 WEB 站點(diǎn)上，獲取源 WEB 網(wǎng)站返回的網(wǎng)頁(yè)內(nèi)容，并加載模板，對(duì)

3、源 WEB 網(wǎng)頁(yè)內(nèi)容按模板設(shè)定的規(guī)則重新組織和格式化，最后返回給用戶手機(jī)。如下圖所示：源 WEB 網(wǎng)站W(wǎng)2M 數(shù)據(jù)網(wǎng)關(guān)用戶手機(jī)模板請(qǐng)求手機(jī)網(wǎng)站請(qǐng)求源網(wǎng)站返回原始網(wǎng)頁(yè)內(nèi)容返回轉(zhuǎn)換后的內(nèi)容加載模板，重新組織內(nèi)容3. 模板簡(jiǎn)介模板簡(jiǎn)介由上述可知，模板的作用主要是對(duì)源網(wǎng)頁(yè)內(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)簽，通過(guò)這些擴(kuò)展標(biāo)簽對(duì)源網(wǎng)頁(yè)內(nèi)容進(jìn)行操作和處理。后面有專門的章節(jié)詳述擴(kuò)展標(biāo)簽的具體使用方法。3.1. 模板規(guī)范模板規(guī)范一個(gè)標(biāo)準(zhǔn)的模板文檔，應(yīng)包括文檔類型聲明以及由標(biāo)簽包含的和消息體。例如下面的文檔：高維信誠(chéng)此外，模板必須符合 XHTML 規(guī)范，包括：1.所有的標(biāo)記都必須要有一個(gè)相應(yīng)的結(jié)束標(biāo)記 。如.或2. 所有標(biāo)簽的元素和屬性的名字都必須使用小寫(xiě)。如：3. 所有的 XML 標(biāo)記都必須合理嵌套 。如.4. 所有的屬性必須用引號(hào)括起來(lái) 。5. 所有非標(biāo)簽的或&等特殊符號(hào)用編碼表示 。如：< > &6. 屬性必須賦

5、值，而不能簡(jiǎn)寫(xiě)。 如：7. 注釋內(nèi)容中 不能出現(xiàn)”-”或“-”。8. 圖片標(biāo)簽必須有 alt 屬性說(shuō)明文字。如：4. 擴(kuò)展標(biāo)簽擴(kuò)展標(biāo)簽擴(kuò)展標(biāo)簽名稱及屬性名稱使用小寫(xiě)，屬性值不區(qū)分大小寫(xiě)。標(biāo)簽屬性值支持單引號(hào)或雙引號(hào)包容，根據(jù)實(shí)際使用情況自定。4.1. Sub 替換標(biāo)簽替換標(biāo)簽在輸入源網(wǎng)頁(yè)內(nèi)容時(shí)將指定文本內(nèi)容替換成另外的內(nèi)容。用法用法待替換的內(nèi)容|替換后的內(nèi)容說(shuō)明說(shuō)明以”|”分隔開(kāi)待替換的內(nèi)容和替換后的內(nèi)容。示例示例abc|ABC將源網(wǎng)頁(yè)中出現(xiàn)的 abc 字符串替換成大寫(xiě)的 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)頁(yè)中指定節(jié)點(diǎn)中所包含的所有超鏈接（元素） ，以列表形式展現(xiàn)。用法用法說(shuō)明說(shuō)明tag：指明要獲取的內(nèi)容塊節(jié)點(diǎn)的開(kāi)始標(biāo)簽。如：表示獲取源網(wǎng)頁(yè)的到之間的所有超鏈接。此開(kāi)始標(biāo)簽也可以包含屬性。如： 指匹配到之間的超鏈接。如果是則匹配任何 div 標(biāo)簽中的超鏈接，包括或等。 sequence 屬性指出當(dāng)源網(wǎng)頁(yè)中出現(xiàn)多個(gè)相同的內(nèi)容節(jié)點(diǎn)時(shí)，要獲取第幾個(gè)內(nèi)容節(jié)點(diǎn)。如：表示取源網(wǎng)頁(yè)第二個(gè)節(jié)點(diǎn)中的所有超鏈接。sequence 不是必須的屬性。如果沒(méi)有該屬性則默認(rèn)取第一個(gè)匹配的內(nèi)容塊。split

7、：每個(gè)超鏈接之間的分隔字符串。如：表示每個(gè)超鏈接之間換行間隔， | 則表示每個(gè)超鏈接以字符“|”間隔。示例示例4.3. Content 內(nèi)容標(biāo)簽內(nèi)容標(biāo)簽取出源網(wǎng)頁(yè)中指定節(jié)點(diǎn)中所包含的內(nèi)容。用法用法說(shuō)明說(shuō)明tag：指明要獲取的內(nèi)容塊節(jié)點(diǎn)，用法與 list 標(biāo)簽的 tag 相同。如：表示獲取源網(wǎng)頁(yè)的到中的內(nèi)容。sequence 屬性指出當(dāng)源網(wǎng)頁(yè)中出現(xiàn)多個(gè)相同的內(nèi)容節(jié)點(diǎn)時(shí)，要獲取第幾個(gè)內(nèi)容節(jié)點(diǎn)。如：表示取源網(wǎng)頁(yè)第二個(gè)節(jié)點(diǎn)中的內(nèi)容。sequence 不是必須的屬性。如果沒(méi)有該屬性則默認(rèn)取第一個(gè)匹配的內(nèi)容塊。revtag：要保留的源網(wǎng)頁(yè)標(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)頁(yè)鏈接，也可以是一個(gè)實(shí)現(xiàn)了CoVics.W2M.ReverseProxyBL命名空間下的ICustomApp接口的程序集。用法用法說(shuō)明說(shuō)明src 屬性指定網(wǎng)頁(yè)類型的外部鏈接地址。該地址必須是一段不帶查詢參數(shù)的 url，系統(tǒng)會(huì)附加用戶的請(qǐng)求查詢參數(shù)來(lái)請(qǐng)求該地址。class 屬性指定實(shí)現(xiàn) IcustomApp 接口的命名空間和類名，assembly 屬性指定該類所在的程序集名。這兩個(gè)屬性必須一起使用?？梢愿鶕?jù)需要只設(shè)置 src 的值或 assembly 和