W2M數(shù)據(jù)網(wǎng)關模板標簽說明

1、W2M 數(shù)據(jù)網(wǎng)關模板標簽說明文件標識：文件標識：CoVics-W2M-RD-UR當前版本：當前版本：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)關概述數(shù)據(jù)網(wǎng)關概述.43.模板簡介模板簡介.53.1.模板規(guī)范.54.擴展標簽擴展標簽.64.1.SUB 替換標簽.64.2.LIST 列表標簽 .74.3.CONTENT 內(nèi)容標

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

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

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

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

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

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

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