W2M数据网关模板标签说明

1、W2M 数据网关模板标签说明文件标识：文件标识：CoVics-W2M-RD-UR当前版本：当前版本：1.0作作 者：者：Wu Lei文件状态：文件状态： 草稿 正式发布完成日期：完成日期：2010-9-6文件控制版本记录版本记录日期日期作者作者参与者参与者变更说明变更说明2010-9-6Wu Lei目目目 录录录1.文档介绍文档介绍.41.1.目的.41.2.范围.41.3.读者对象.41.4.参考资料.42.数据网关概述数据网关概述.43.模板简介模板简介.53.1.模板规范.54.扩展标签扩展标签.64.1.SUB 替换标签.64.2.LIST 列表标签 .74.3.CONTENT 内容标

2、签.74.4.PLUGIN 插件标签 .81. 文档介绍文档介绍1.1. 目的目的本文主要定义 W2M 数据网关模板制作规范及模板扩展标签，以使读者理解并熟悉扩展标签及其使用方法，并作为模板制作的主要依据。1.2. 范围范围针对 W2M 数据网关模板制作规范及扩展标签说明。1.3. 读者对象读者对象本文读者包括但不限于以下对象：项目经理、系统架构师、开发工程师、测试工程师、技术支持工程师1.4. 参考资料参考资料2. 数据网关概述数据网关概述W2M 数据网关采用 HTTP 反向代理的技术，将用户手机访问手机站点的请求，转发到源 WEB 站点上，获取源 WEB 网站返回的网页内容，并加载模板，对

3、源 WEB 网页内容按模板设定的规则重新组织和格式化，最后返回给用户手机。如下图所示：源 WEB 网站W2M 数据网关用户手机模板请求手机网站请求源网站返回原始网页内容返回转换后的内容加载模板，重新组织内容3. 模板简介模板简介由上述可知，模板的作用主要是对源网页内容重新组织和格式化，并展示给终端用户。W2M 数据网关模板是基于 XHTML 的文档，可以在模板中使用符合 XHTML BASIC 或 XHTML MOBILE PROFILE 标准的元素和属性。以下元素不能在模板中使用：frame, frameset, iframe, script。事件也不能使用，如：onclick, onloa

4、d 等。此外，模板扩展了一套专用标签，通过这些扩展标签对源网页内容进行操作和处理。后面有专门的章节详述扩展标签的具体使用方法。3.1. 模板规范模板规范一个标准的模板文档，应包括文档类型声明以及由标签包含的和消息体。例如下面的文档：高维信诚此外，模板必须符合 XHTML 规范，包括：1.所有的标记都必须要有一个相应的结束标记 。如.或2. 所有标签的元素和属性的名字都必须使用小写。如：3. 所有的 XML 标记都必须合理嵌套 。如.4. 所有的属性必须用引号括起来 。5. 所有非标签的或&等特殊符号用编码表示 。如：< > &6. 属性必须赋

5、值，而不能简写。 如：7. 注释内容中 不能出现”-”或“-”。8. 图片标签必须有 alt 属性说明文字。如：4. 扩展标签扩展标签扩展标签名称及属性名称使用小写，属性值不区分大小写。标签属性值支持单引号或双引号包容，根据实际使用情况自定。4.1. Sub 替换标签替换标签在输入源网页内容时将指定文本内容替换成另外的内容。用法用法待替换的内容|替换后的内容说明说明以”|”分隔开待替换的内容和替换后的内容。示例示例abc|ABC将源网页中出现的 abc 字符串替换成大写的 ABC备注备注如果有多个要替换的内容，可以使用多个 sub 标签。如果待替换或替换后的内容中包含有破坏原 XML 文档结构

6、的特殊字符，如”，应使用 CDATA 将整个值括起，如：!CDATA表示将”。4.2. List 列表标签列表标签获取源网页中指定节点中所包含的所有超链接（元素） ，以列表形式展现。用法用法说明说明tag：指明要获取的内容块节点的开始标签。如：表示获取源网页的到之间的所有超链接。此开始标签也可以包含属性。如： 指匹配到之间的超链接。如果是则匹配任何 div 标签中的超链接，包括或等。 sequence 属性指出当源网页中出现多个相同的内容节点时，要获取第几个内容节点。如：表示取源网页第二个节点中的所有超链接。sequence 不是必须的属性。如果没有该属性则默认取第一个匹配的内容块。split

7、：每个超链接之间的分隔字符串。如：表示每个超链接之间换行间隔， | 则表示每个超链接以字符“|”间隔。示例示例4.3. Content 内容标签内容标签取出源网页中指定节点中所包含的内容。用法用法说明说明tag：指明要获取的内容块节点，用法与 list 标签的 tag 相同。如：表示获取源网页的到中的内容。sequence 属性指出当源网页中出现多个相同的内容节点时，要获取第几个内容节点。如：表示取源网页第二个节点中的内容。sequence 不是必须的属性。如果没有该属性则默认取第一个匹配的内容块。revtag：要保留的源网页标签。如果有多个标签需要保留，以“|”分隔。如：table|tr|t

8、d|div表示保留、等标签。该值如果为空表示只输出文本内容而不保留任何 html 标签。示例示例4.4. Plugin 插件标签插件标签在当前位置输出一段由外部程序产生的 html 内容。该外部程序可以是一个外部网页链接，也可以是一个实现了CoVics.W2M.ReverseProxyBL命名空间下的ICustomApp接口的程序集。用法用法说明说明src 属性指定网页类型的外部链接地址。该地址必须是一段不带查询参数的 url，系统会附加用户的请求查询参数来请求该地址。class 属性指定实现 IcustomApp 接口的命名空间和类名，assembly 属性指定该类所在的程序集名。这两个属性必须一起使用。可以根据需要只设置 src 的值或 assembly 和