W2M數據網關模板標簽說明

1、W2M 數據網關模板標簽說明文件標識：文件標識：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.數據網關概述數據網關概述.43.模板簡介模板簡介.53.1.模板規(guī)范.54.擴展標簽擴展標簽.64.1.SUB 替換標簽.64.2.LIST 列表標簽 .74.3.CONTENT 內容標

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

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

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

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

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

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

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