中国联通3G门户业务技术要求.doc

中国联通中国联通 3g 门户门户 业务技术要求业务技术要求 中国联合网络通信有限公司中国联合网络通信有限公司 中国联合网络通信有限公司 i 目 录 1概述概述1 1.1文档内容 .1 1.2适用范围 .1 1.3解释权及修订权 .1 1.4术语和缩略语 .2 1.5参考文献 .2 2业务技术要求业务技术要求3 2.1业务访问和订购流程 .3 2.1.1业务使用流程（访问非计费url）3 2.1.2业务使用流程（访问计费url）4 2.1.3订购业务流程.5 2.2页面开发规范 .6 2.2.1标记语言规范.6 2.2.2页面设计基本原则.7 2.2.3页面效果规范.7 2.2.4背景音乐规范.9 2.2.5图标与图形规范.10 2.2.6cache规范.11 2.2.7菜单规范.12 2.2.8页面返回规范.12 2.2.9文本显示规范.13 2.2.10用户输入规范.15 2.2.11格式化输入规范.15 2.2.12浏览器性能参考.16 2.2.13mhtml格式页面16 2.2.14终端适配.20 2.2.15cookies规范.20 2.3url 说明 21 2.4业务返回规范 .21 2.4.1说明.21 2.4.2适用范围.22 2.4.3页面和软键(数字键)的返回规定22 2.4.4业务的“返回上级”.23 2.4.5业务的“返回首页”.25 2.4.6业务的返回“频道首页”.26 2.5wap push规范 .27 2.5.1说明.27 2.6业务实现要求 .27 2.6.1对wap1.2的兼容27 2.6.2浏览类业务.31 2.6.3下载类业务.34 2.6.4业务订购.34 2.6.5push类业务35 2.7用户手机号码和手机型号获取说明 .35 2.8编码和代码 .36 2.9计费模式 .36 中国联合网络通信有限公司 1 1 概述概述 中国联通 wcdma 移动互联网业务开展以后，用户数增长迅速，用户使用的 各类业务越来越丰富，目前提供的各类业务均是按照 wap1.2 标准向用户提供的 服务。中国联通前期已建立了统一的 wap 2.0 门户站点，wap2.0 门户即将上线。 为了提供更好、功能更加强大的服务，2009 年新建 3g 门户与 2g 门户站点 相结合，对用户提供各类服务，为了保证统一 2g/3g 门户业务，特制定了本业务 规范。 1.1 文档内容文档内容 本规范内容包括 3g 业务门户的技术说明，业务访问流程，计费和价格原则以 及各类业务规范，并给出了相应的基本原则与例子。同时对于 2g 业务的兼容性和 延续性作了相关说明。 1.2 适用范围适用范围 本规范适用于中国联通各级机构和 cp/sp（内容/服务提供商）通过中国联通 2g/3g 业务门户站点向用户提供各类增值业务服务。 1.3 解释权及修订权解释权及修订权 本规范由中国联通制定、审核并发布，起草单位为中国联通产品创新部。 本规范将根据市场发展需要适时进行修改，其修改权和解释权属于中国联通产 品创新部。 中国联合网络通信有限公司 2 1.4 术语和缩略语术语和缩略语 wap: wireless application protocol sp: service provider,服务提供商 页面：每次请求，所得到的显示内容 频道：根据业务内容分类划分的区域，频道下为栏目列表 栏目：频道中的某一类服务，栏目下是业务列表 栏目标题：显示内容的页面顶端显示的内容标题 栏目名称：菜单栏目列表中指向内容链接或下一级菜单链接的栏目名 xml：extensible markup language, 扩展超文本标记语言, html 的最新版本 （v.4.1）是 xhtml 的基础。 xhtml mp: xhtml mobile profile, xhtml 移动描述。源于 xhtml basic 并且从完整的 xhtml 1.1 中增加了在移动浏览器中有用的元素和属性。 wap css：wap cascading style sheets，是 css 的移动版本，是 css 的 一个子集，但不包括那些不适用于特别小的设备功能。 cp/sp：内容提供商/服务提供商 资费确认：用户确认收费规则，如包月、点击及收费金额 计费：根据用户确认的收费策略，作计费处理，计算本次使用服务的费用 1.5 参考文献参考文献 中国联通 wcdma 移动互联网门户业务规范 中国联合网络通信有限公司 3 2 业务业务技术要求技术要求 2.1 业务访问和订购流程业务访问和订购流程 2.1.1 业务使用流程（访问非计费业务使用流程（访问非计费 url） 用户 web网关/http 代理 wap/web 门户 vacsp portal浏览 判断用户请求， 将用户请求定位到全国门户 poatal浏览 portal展现 浏览请求 判断用户访问的是非计费url 转发浏览请求 业务返回 流程描述： （1）用户一键上网，访问总部门户； （2）web网关判断用户请求，将用户请求定位到总部门户； （3）联通portal展现； （4）用户发起一个浏览请求； （5）http代理根据用户所请求访问的url判断出是非计费url，转发用户请求至免费sp； （6）sp给用户返回访问内容。 中国联合网络通信有限公司 4 2.1.2 业务使用流程（访问计费业务使用流程（访问计费 url） 用户 web网关/http 代理 wap/web 门户 vacsp portal浏览 判断用户请求， 将用户请求定位到全国门户 poatal浏览 poatal展现 浏览请求 判断用户访问的是计费url 转发浏览请求 业务返回 触发鉴权 认证鉴权 用用户户一一键键上上 网网，访访问问总总部部 门门户户 用用户户访访问问收收费费 内内容容 用用户户已已订订购购，用用 户户直直接接使使用用（按按次次 计计费费业业务务） 用用户户已已订订购购， 用用户户直直接接使使用用 （包包月月业业务务） 鉴权成功，用户已订购 生成话单 鉴权成功，用户已订购 重定向到资费提示页面 展现资费提示页面 用户确认资费 重定向到用户浏览页面 业务返回 生成话单 bss 同步话单 同步话单 用用户户未未订订购购，提提示示 用用户户订订购购 鉴权失败（用户未订购） 触发订购流程 修改话单生成/同步话单流程.只修订图 流程描述： （1）用户一键上网，访问总部门户； （2）web网关判断用户请求，将用户请求定位到总部门户； （3）联通portal展现； （4）用户发起一个浏览请求； （5）http代理根据用户所请求访问的url判断出是计费url，触发到vac鉴权 用户已订购，用户直接使用（包月业务）：用户已订购，用户直接使用（包月业务）： （6）鉴权成功，用户订购的是包月业务，则http代理转发用户请求至收费sp； （7）sp返回访问内容； （8）http代理触发到vac的话单生成请求； （9）vac生成话单，并同步给bss； 用户已订购，用户直接使用（按次计费业务）：用户已订购，用户直接使用（按次计费业务）： 中国联合网络通信有限公司 5 （6）鉴权成功，用户订购的是按次计费业务，则http代理重定向到资费提示页面； （7）用户确认资费； （8）页面重定向到用户浏览页面； （9）sp返回访问内容； （10）http代理触发到vac的话单生成请求； （11）vac生成话单，并同步给bss； 用户未订购，触发订购流程：用户未订购，触发订购流程： （6）鉴权失败，用户未订购，http代理重定向到业务订购提示页面。 2.1.3 订购业务流程订购业务流程 用户wap/web门户vacspocs/scpbss 用户访问订购页面 发起认证鉴权 扣费结果返回 预付费扣费 展现页面订购页面 订购请求 展现二次确认页面 用户确定订购 用户、业务、sp进行认证鉴权 生成订购关系/ 出话单 鉴权成功 展现订购成功页面订购关系通知sp 订购关系通知bss 参考vac规范 流程说明： （1）用户访问业务订购页面； （2）门户展现订购页面； （3）用户点击订购链接，发起订购请求； （4）门户展现二次确认页面； （5）用户点击确认链接； （6）门户发起到用户归属的vac的订购鉴权； （7）vac对用户进行状态认证、业务能力鉴权、终端能力鉴权、对业务进行鉴权、对sp进 行鉴权； （8）鉴权通过后判断用户是否是预付费用户，如果是，则发起到ocs/scp的实时扣费，并 接收扣费结果，如果扣费成功，则继续，否则鉴权失败，提示用户余额不足，订购失败。如果 用户是后付费用户则继续； （9）vac生成订购关系； （10）vac向sp发送订购关系通知，并获取sp回复信息； 中国联合网络通信有限公司 6 （11）vac向bss发送订购关系通知，并获取bss回复信息； （12）vac返回订购鉴权成功响应给门户。 （13）门户向用户展示订购成功提示页面。 2.2 页面开发规范页面开发规范 2.2.1 标记语言规范标记语言规范 1. 所有页面都要求由 xhtml 编写，严格遵循 xhtml mp 规范，请参考本 文以上内容，或者参考： /documentation/xhtml_mp_css_reference_70/index.html 2. 页面验证工具：/ 3.所有的页面都要已以下格式开始 4. 页面编码为 utf-8。 5. 所有属性要求双引号。 6. 所有的 7. 所有的标签(除了文件头的 doctype)都是小写，并且注意。 8. 标签是大小写相关的，比如: 应当写为： 9. 所有的标签都要封闭 10. 所有的标签的嵌套关系要符合 xhtml mp 规范, 比如 后，要加 11. 业务内地址要求用相对地址，且不要用 refresh 功能. comment a1: 待确定 中国联合网络通信有限公司 7 2.2.2 页面设计基本原则页面设计基本原则 1.相比 2g 网络，3g 网络在网络带宽上大大增加，引领用户进入真正的无 线互联网时代；cp/sp 应基于 3g 网络的特点开发出内容更丰富的应用， 在 3g 门户的页面设计上考虑更丰富的媒体类型和内容元素。 2.由于手机终端具有屏幕狭小、输入受限等特点，同时移动互联网带宽受 限，因此 cp/sp 业务设计本着引导与方便用户使用原则而开展。 3.cp/sp 所开发业务既要较快让用户进入与使用，又要方便用户出来使用其 它栏目或者 cp/sp 业务。用户进入后无法通过链接返回首页的业务视为 重大错误。 4.浏览类与信息类业务要求各 cp/sp 要有功能与风格基本一致的界面。 2.2.3 页面效果规范页面效果规范 页面的效果应把握“提高访问速度的前提下，提高页面浏览流量、提高页面视 觉冲击效果”的原则： 1.单页面图片与文字总和的整体容量应控制在 150k 以下，普通页面的全部 展现时间应保证小于 4s，多图形页面的全部展现时间应保证小于 6s（包 括页面内置对象） 。 2.对于业务入口页面，在保证速度的前提下，应尽可能做得丰富一些，增 强用户的视觉感受；对于第二级和第三级及其以下的页面，可以稍微简 化页面的效果，但是不允许出现纯文本的页面。 3.对于使用图片的页面，应该设置与图片主色调相近的背景色，在用户触 发页面的下载后，应保证用户通过迅速见到出现的背景色而能感受到下 载已经进行，绝对不能在下载进行中向用户展现白屏。 4.如果使用表格的嵌套，嵌套的层数应该少于 2 层。 5.css 应该定义到每一个文件，不能单独做成一个文件，应使用页面内包含。 中国联合网络通信有限公司 8 6.对于背景的图片，建议使用小图片的平铺方式，可以大大提高下载速度， 平铺应该优先考虑手机 170 像素的屏宽。否则将会出现明显的接缝痕迹， 示例如下: 未考虑手机平铺效果： 建议平铺效果： 7. html body 下的子 tag 中的内容应尽量少，尽量少定义全局，应分散到多 个子 tag 中，tag 禁止相互嵌套，代码示例: 方孤苦伶仃接口管理发动机可法律界公开勒索奋斗 应该为： 中国联合网络通信有限公司 9 方孤苦伶仃接口管理发动机可法律界公开勒索奋斗 8. 页面中所有显示图片应加 alt， 在图片未完全下载前，能够用文字给用 户以图片展示内容的说明。示例代码如下： 2.2.4 背景音乐规范背景音乐规范 1.背景音乐使用 midi 格式。 2.为了满足用户在不同场景中的需要， 页面中应该设置明显的可以开启或 关闭背景音的操作方式。 3.背景音乐的请求代码应该放在图片的请求代码的之后，以保证下载速度 和用户感受，示例代码如下： 推荐的写法： comment a2: 待确定 comment a3: 待确定 comment a4: 待确定 中国联合网络通信有限公司 10 fkdgjkldgjklfjdksgjkdl gjklfdjgkldjf 不推荐的写法： fkdgjkldgjklfjdksgjkdl gjklfdjgkldjf 2.2.5 图标与图形规范图标与图形规范 1.为了保证页面的整体下载时间，建议单页面图片的容量应该控制在 100k 以内。 2.图片下载必须提供图片预览功能，预览时显示文字应为“生成预览中” ， 预览图片应为 80x80 像素，大小应控制在 6k 以内，以保证预览生成的 生成预览中 圣诞老人 1256 字节 下载 返回上级* 联通首页# 圣诞老人 1256 字节 下载 返回上级* 联通首页# comment a5: 待确定 comment a6: 待确定 中国联合网络通信有限公司 11 速度在 3 秒以内。正式下载的图片应尽量保证容量较大，图像清晰。建 议下载图片大小在 25k 左右， 预览页面效果如图： 3.浏览器对于不同格式的图片解码速度是不同的，根据测试值得出 （openwave 浏览器） ，解码速度 bmppngjpeggif， 建议 cp/sp 在保证图片质量的基础上，最好选择 gif 和 png 格式的图片，并且应经 过 photoshop 压缩。 4.由于使用小图标会增加 http 请求的个数从而影响页面的整体下载速度， 所以不推荐在栏目列表中使用较多的小图标，建议使用特殊符号或者数 字符号代替小图标，可以很大程度上提高浏览速度；如果必须使用，则 每页使用小图标的个数不应超过 15 个，且单个图标大小应在 500byte 以 内。 2.2.6 cache 规范规范 1.为加快用户浏览页面显示速度，业务入口页面，以及公共性和架构类的 页面应使用 cache，其他页面不应使用 cache。 2.不要将时效性很强的内容（如新闻、股票信息等）留在 cache 中。 3.天气信息、交通信息等特定内容在 cache 中的有效时间为 6 小时。 4.对动态信息要强制更新。 comment 园园园园7: 待定 中国联合网络通信有限公司 12 2.2.7 菜单规范菜单规范 1.菜单项按业务的重要性的顺序来排列，用户最可能选择的业务排在前面。 2.菜单项应遵循的排列格式：在保证美观的基础上，如果菜单一列显示， 文本部分左对齐，图片菜单部分中间对齐；如果分列显示，文本部分左 对齐，图片菜单项要尽量与屏幕宽度相同，如果不能相同，则要保证中 间对齐。 3.菜单项应尽量避免使用小图标。 4.建议使用数字快捷键作为菜单选择手段，但是菜单选项应该使用明显的 标识提示用户使用数字快捷键，菜单选项多于 9 个时，定义“0”键表示 进入下一页，定义“*”键表示返回上级；定义“#”键表示返回首页。 对于不支持字符触发的终端， “返回上级”和“联通首页”应采用小图标 和文字链接，可以通过方向键选择。 5. 菜单尽量不要小图标（icon）和数字快捷键同时使用，因为这样，对于 大部分终端，会造成菜单文字的换行，影响界面的美观。 6. 如果需要在一个菜单项上执行多个操作，可以通过弹出式菜单实现。 2.2.8 页面返回规范页面返回规范 用户经常使用手机中的返回按键（通常就是删除按键）返回或退出，因此，返 回连接对一个业务的成功是十分关键的，要倍加关注，对返回连接设计好的业务， 将会显著地提高用户的使用次数。 1.在所有业务的页面底部必须有一个“联通首页#”和“返回上级*”的链接 (注意必须在链接的文字后提供“#”和“*”作为明显的标识提示用户)； “返回首页”的链接为：，页面效果如图： （个人图片)（图片下载） （铃声下载） （屏保动画） （音乐动画）(背景图片) 返回上级返回上级* 联通首页联通首页# 中国联合网络通信有限公司 13 返回上级：指返回 sp 的应用菜单 联通首页：指返回互动视界的首页 2.如果上一个页面是重定向页面，则“返回上级”应跳过重定向页面。 3.为了便于用户的使用，在有些情况下，允许返回上级功能不直接返回上 一个页面，而是将用户带到最方便使用业务的页面。 例：用户在使用铃声搜索或者单词翻译的业务时，当输入的要搜索的铃声 或者翻译的单词，然后进入确认页面，点击确认后，当没有找到时出现的 提示页面中的返回，不是返回到确认页面，而是返回到重新输入页面； 2.2.9 文本显示规范文本显示规范 1.一个 card 中显示 5k 以下字符，即 2000 汉字以内。 2.当需要显示的内容超过范围时，在底部提供一个“下一页”连接，但在 每个栏目下，传送给用户的内容最好不要超过 3 页。 3.将超出一行的内容分行显示，但主菜单及子栏目标题则应尽量将文字压 缩为一行。如：“少女系列三十一”此标题字符过长，可将其压缩为 “少女系列 31” 。 4.所有文本左对齐。 5.每段文字的首字需要保证对应的文字缩进。 6.浏览图片和新闻等内容时，应提供明示下一主题或内容的连接说明，用 中国联合网络通信有限公司 14 于用户直接转到下一个主题或内容，比如“下一张” 、 “下一条”等，而 不要仅仅显示“下一页” ，以免造成用户的混淆。 7.所有提示性文字应使用统一的简体中文，避免出现英文与中文混合的内 容，如“loading请稍后” ，应为“正在下载中请稍后” 。 8.菜单中的各项要按照一定的逻辑顺序来排列，如按照类型、时间、字母 顺序等。如果没有逻辑顺序，就按优先级排列，将最可能选择的排在最 前面，将最新更新的部分放在最前面，并加入“new”字样。 9.新闻类栏目要在新闻标题的后面显示新闻发布的日期及出处。如图： 10. 当用户阅读文本时，应能主动预读取下一页文本到手机的 cache 中， 加快用户阅读的切换速度。 比如： 1.中国队大胜香港 队。(2004。11 。18，摘自 xx 时 报) 2.央视招标突破 50 亿。(2004。11 。18，摘自 xx 晚 报报) 3.北京警方成功破获 多起抢劫 案。(2004.11.1 8，摘自 xx 时报) 下一页 返回上级返回上级* 联通首页联通首页# 中国联合网络通信有限公司 15 page 1 of 2 。 上面的代码展示了如何利用预取功能对一个卡片组中的下一个卡片进行访 问。 2.2.10用户输入规范用户输入规范 1.尽量减少用户的文本输入。 2.当已激活输入区域时，只需要有一个确认连接，不需要提供其他功能。 3.为每一个输入项尽可能直观的提示与描述，但不要多于 10 个汉字。 4.对每一个输入项，将输入的内容限制在 254 个字符之内。 5.应通过设定输入框的内容类型，避免用户增加切换输入法的操作。 6.对用户输入的密码，不要用*进行掩盖，在手机上明文显示即可。 7.使用 maxlength 参数来限制用户输入密码的长度，避免用户出错。 2.2.11格式化输入规范格式化输入规范 格式化输入主要包括输入日期、信用卡号码等具有固定格式的内容。 1.对所有格式化输入都必须表明输入格式，如输入如期时可以表示为： mm/yyyy 见下 例： 2.对输入的类型进行强制匹配，该输入数字的地方，不能输入字母。 3.可以通过 maxlength 参数限制输入的字符数。 4.对确定的内容进行预制， 如输入日期时可以表示为 20xx，只让用户输 comment 园园园园8: 版本确认 中国联合网络通信有限公司 16 入后两位数字就可以。 5. 对可确定用户输入的文字功能实现自动切换，如需用户输入密码时， 应自动切换为“数字功能” ，要求用户输入 email 地址时，应自动切换 为“英文”等。 2.2.12浏览器性能参考浏览器性能参考 1.建议 cp/sp 建议控制页面中 http link 数目。 2.页面中 http link 请求的顺序是按照编写的顺序产生的，建议 cp/sp 对 于较大的对象应尽量放在后面。 3.页面编码应采用 utf-8， 可减少 proxy 或终端的转化。 2.2.13mhtml 格式页面格式页面 概述概述 鉴于 4.2.11 章节中提到的手机浏览器单连接同步发送请求的特性，减少同一页 面中请求数量可以有效的加快页面翻转速度。mhtml 格式页面恰恰可以满足如上 需求。 目前 openwave 6.x 版本的浏览器已经被普遍的应用在 wap2.0 终端上，该版 本手机浏览器可以支持 multipart/related mime type。由于 mhtml 格式页面对于 “多图”页面能够显著提供页面翻转速度，因此，对于由页面下载速度缓慢而严重 影响用户感知、用户体验的页面，建议采用 mhtml 格式页面进行打包，将多个 请求转换为一个请求，缩短由于手机浏览器的局限而导致页面翻转较长的耗时。 实现原理实现原理 网页打包技术是一种基于 http 的传输扩展协议，可以参考互联网标准协议 rfc2557mime encapsulation of aggregate documents, such as html (mhtml) ， 中国联合网络通信有限公司 17 通过在传输过程中实现页面和页面内嵌对象的整合编码技术，实现一次连接可以传 输完整页面及页面内嵌对象的技术标准。本协议是对 rfc2557 在 wap 传输上的 修正，针对无线网络的特性，去掉了冗余数据，结合 wcdma 的高速数据通道实 现无缝高效传输。 传统的 wap 页面传输过程： 1.向服务器发送请求，请求页面文件(wml 或 xhtml)。 2.显示初步页面。 3.浏览器针对页面进行分析，得到页面内嵌对象（如图片，铃声）的 url。 4.继续发送对页面内嵌对象请求。 5.显示完整页面。 页面元素文件 xhtml 文件 多次请求/应答 一次请求/应答 wml/xhtml 格式页面传输示意图 打包技术页面传输过程： 1.向服务器发送页面请求，传输整个 mhtml 页面文件。 2.对打包文件解码，显示完整页面。 手机 服务器 手机服务器 中国联合网络通信有限公司 18 mhtml 文件 一次请求/应答 mhtml 技术传输示意图 简单实现过程简单实现过程 .1 将网页转成将网页转成 multipart 格式格式 1.使用 ie 打开某业务入口页面。 2.在菜单中选择另存为。 3.在对话框内选择保存类型为web 档案，单一文件。 4.选择编码为 utf-8,文件名为 test.mht，确定保存。 5.在菜单中选择另存为。 6.在对话框内选择保存类型为网页，html 格式。 7.文件名为 test. html，确定保存。 8.使用文本编辑器打开 test.mht。 9.去掉前的 16 行（前 16 行为 ie 自行添加的冗余信息） 。 10. 增加以下内容： -=_nextpart_000_0003_01c54672.b1702520 content-type: text/html;charset=“utf-8“ content-transfer-encoding: quoted-printable content-location: page 手机服务器 中国联合网络通信有限公司 19 .2 将页面元素转成将页面元素转成 base64 格式格式 接前一章节： 1.查找图片文件的 url 位置。 2.修改为本地路径。 3.去掉最后一行的标识-=_nextpart_000_0000_01c54b57.43303d40- （对于不同情况，黄色背景部分可能略有不同） 。 4.在文件尾部加上以下内容（假设该测试页面只内嵌了 2 个对象）： -=_nextpart_000_0003_01c54672.b1702520 content-type: image/gif content-transfer-encoding: base64 content-location: a.gif -=_nextpart_000_0003_01c54672.b1702520 content-type: image/gif content-transfer-encoding: base64 content-location: b.gif -=_nextpart_000_0003_01c54672.b1702520- 5.在 test.files 文件夹中找出图片文件并使用 base64 进行编码，获得纯 文本字符串，或参照以下步骤使用 outlook 对图片进行编码。 a)打开outlook,新建一个邮件 b)在附件中选择以上的图片文件 c)发送邮件 d)在邮件发送箱中找到该邮件 e)查看邮件属性里的详细信息 f)选择编号好的图片文件内容 .3 整合为整合为 mhtml 文件文件 1.在 test.mht 中粘贴对内嵌对象进行 base64 编码后的纯文本字符串。如， 中国联合网络通信有限公司 20 -=_nextpart_000_0003_01c54672.b1702520 content-type: image/gif content-transfer-encoding: base64 content-location: a.gif 此处粘贴 a.gif 进行 base64 编码后的纯文本字符串 -=_nextpart_000_0003_01c54672.b1702520 content-type: image/gif content-transfer-encoding: base64 content-location: b.gif 此处粘贴 b.gif 进行 base64 编码后的纯文本字符串 -=_nextpart_000_0003_01c54672.b1702520- 2.将 test.mht 另存为 test.jsp。 3.部署到应用服务器。 4.进行测试。 应用范围应用范围 如 章节要求，对于由页面下载速度缓慢而严重影响用户感知、用户 体验的页面，我们建议采用 mhtml 格式页面进行打包。 以下举例说明建议采用 mhtml 格式进行开发的现网业务页面（灰色涂抹部 分为尚未下载完成的图片说明，顾及影响，此处以灰色进行涂抹） 。 以上页面效果严重影响用户感知、用户体验，因此，对于此类业务页面，我们 建议以 mhtml 格式进行开发。 2.2.14终端适配终端适配 1.由于终端支持的选择性的，相同设计的页面在不同的终端上有着不同 的表现形式，因此，请 cp/sp 在开发时注意通过终端适配，识别不同 comment 园园园园9: 待定 comment 园园园园10: 待定 中国联合网络通信有限公司 21 的终端并根据其不同的能力属性来推送适配的页面。 2.由于终端 cpu 性能的影响，一些终端在解码时 cpu 资源占用严重， 影响浏览速度，这类终端不适合图片内容较多的页面的展现， cp/sp 应单独对这类终端进行适配。 2.2.15cookies 规范规范 鉴于终端浏览器可以设置不支持 cookie，因此，对于需要保存会话关系的 wap 2.0/http 应用程序，应通过 url 重写（url rewriting）的方式来保存会 话关系，即将用户的会话信息保存在 url 中，当用户点击链接时送回服务器端来 保持用户的会话关系。 2.3 url 说明说明 sp 在中国联通 3g 门户中提供一个业务时，需遵循中国联通基于 url 计费 （信息费）的原则，对于接入的任何收费业务需要提供如下几类 url： 参数名称参数举例用途描述 入口 url /wap/ index.jsp 业务的入口 url，唯一的一个 计费 url /wap/ content/fee1/ /wap/ content/fee2/ 如果用户访问的 url 包含此 url，http 代理触发鉴权请 求到 vac 进行处理。 可以为多个。 说明： （1） 由于手机支持的 url 长度有限，而且不同的机型支持的长度也不一致，为 了能够使各种机型均能够正常使用 wap 业务，要求接入的业务内容的 url 中国联合网络通信有限公司 22 长度不能够超过 128 个字符，并不允许出现中文字符。 2.4 业务返回规范业务返回规范 2.4.1 说明说明 为了统一中国联通 3g 业务风格，保证 3g 业务的可用性和易用性，现对有关页 面的返回上级和返回首页制定本规范。对通过中国联通 3g 门户网站提供连接或者 由中国联通审核通过的接入 cp/sp 所提供的的代计费功能的 3g 业务均要求遵循本 规范中的相关原则与规定。 中国联通将对本规范进一步的修改与完善，同时也欢迎广大合作伙伴就 3g 业务 规范给中国联通提供建议与意见。 中国联通保留本规范的最终解释权。 2.4.2 适用范围适用范围 本规范适用于中国联通 wcdma wap/http 全网业务。 2.4.3 页面页面和软键和软键(数字键数字键)的返回规定的返回规定 （1） 在一级栏目页面（或者是业务的起始页面）必须有一个“返回首页”的 链接；同时， wap1.2 业务页面的右软键被定义为“回首页”的链接。 （2） 在二级栏目以下的页面（或者是业务使用中的页面）必须同时有“返回 上级”和“返回首页”的链接；同时，wap1.2 业务的页面右软键被定义为 “回首页”的链接； （3） 当页面的指示光标没有指向一个链接的时候，浏览器的左软键定义为 “返回” ，链接至上级页面；同时，wap1.2 业务的页面右软键被定义为“回 首页”的链接； （4） 为了便于用户的使用，在有些情况下，允许返回上级功能不直接返回上 中国联合网络通信有限公司 23 一个页面，而是将用户带到最方便使用业务的页面； 例：用户在使用铃声搜索或者单词翻译的业务时，当输入的要搜索的铃声 或者翻译的单词，然后进入确认页面，点击确认后，当没有找到时出现的 提示页面中的返回，不是返回到确认页面，而是返回到重新输入页面； （5） 需特别注意的关于软键的规定：需特别注意的关于软键的规定：基于 wap1.2 开发的业务必须支持以上 定义的左、右软键功能。 对基于 wap2.0/http 开发的业务，可以不支持软 键功能，但是，假如某个业务选择使用软键功能，那么就必须遵循以上定义 的整套软键规范； （6） 特别地，对于 wap2.0/http 业务，cp 必须在业务的每一个页面上使用数 字键（accesskey）完成返回的功能，统一规范为：“*”键表示返回上级； “#”键表示返回首页。 2.4.4 业务的业务的“返回上级返回上级” 全网业务的全网业务的“返回上级返回上级” 全网业务的返回上级可以分为以下两种情况： 1、从 cp 业务的底层页面返回到 cp 业务的上一级页面； 2、从 cp 业务的入口页面或者需要返回到 wap 门户对应栏目的页面返回到 wap 栏目，做到“从哪里来回哪里去” 。 第一种情况的返回上级是由 cp 开发人员根据业务本身的流程，设定返回上级 应当返回的最佳页面。 第二种情况必须按照以下的说明，完成相关 url 的设定。 当平台操作员通过平台 portal 管理功能将 cp 的业务入口加入平台某个栏目时， 平台会向自动向 cp 业务的入口 url 传送参数“pt” ，该参数由两部分组成，以冒 号“：”分隔，前一部分为 portalid，通过此 id 来判断用户是来自于哪一个门户， comment 园园园园11: 待定 comment 园园园园12: 待定 中国联合网络通信有限公司 24 根据此 id 决定 cp 业务返回首页应当返回哪个门户的页面；后面一部分为栏目 id，决定返回到哪个具体的栏目页面。 总部 3g 门户栏目的 url 由两部分组成：门户 url 和栏目 id。门户 url 可 以根据 portalid 对应表查得。栏目 id 则是作为“dir”参数的参数值传递给门户平 台的。 对于本身不带参数的入口 url，例如： /cy/hwkt.jsp 当用户点击该栏目的业务链接时，该业务的 cp 服务器获得的对应请求 url 为：/cy/hwkt.jsp?pt=2:11375 。 对于已经带参数业务入口 url，则会自动加“取得用户手机的 ua 字符串，如下 代码所示： uastring = req.getheader(suseragentheadername); 2取得 ua 信息后，根据不同的 ua 返回不同格式的页面，处理程序如下： public class getuastyle private long uaguid; /ua 标志 private mobileinfo mobile; private static final string format_adapt_by_ua = “global.hsportal.wap.portal.adapt.value“; （1）初始化此对象 public getuastyle(httpservletrequest req) this.mobile = new wapmobileinfo(req); uaguid = mobile.getuseragent().getnumuaguid(); 中国联合网络通信有限公司 29 （2）根据 ua 信息得到该手机支持的显示格式 xhtmlhtmlwml（此步骤涉 及到数据库的登记 ua 信息）： public string getdisstyle() if (“false“.equalsignorecase(configurate.getinfo(format_adapt_by_ua) return “wml“; string strsql = “select vc2uagid“ + “ from hsv_uarefuag “ + “ where numctguid = 7“ + “ and numuaguid = ?“ + “ order by numorder“; dbaccess db = null; preparedstatement pst = null; resultset rs = null; string result = “; try db = new dbaccess(); pst = db.getconnection().preparestatement(strsql); pst.setlong(1, uaguid); debug.debug(“strsql is : “ + strsql + “ and uaguid is:“ + uaguid +“); rs = pst.executequery(); result = “wml“; /默认为 wml if(rs.next() result = rs.getstring(“vc2uagid“); rs.close(); pst.close(); debug.debug(“get the wap ua style is: “+result+“); 中国联合网络通信有限公司 30 catch(exception e) return result; finally if (rs != null) try rs.close(); catch (sqlexception ex1) rs = null; if (pst != null) try pst.close(); catch (sqlexception ex2) pst = null; if (db != null) db.destroy(); db = null; return result; （3）根据得到的重定向的文件类型（xhtml/xml/html/wml）为参数，返回 需要重定向的具体文件名： public string getfile(string style) 中国联合网络通信有限公司 31 if(style.equalsignorecase(“html“) return configurate.getinfo(configtagnames.wap_portal_html_pageurl); else if(style.equalsignorecase(“xhtml“) return configurate.getinfo(configtagnames.wap_portal_xhtml_pageurl); else return configurate.getinfo(configtagnames.wap_portal_wml_pageurl); 3通过以上方法后得到要重定向的具体的文件名，此时可以 forward 到得到的文 件。下面给出一个完整调用的示例： 1 getuastyle style = new getuastyle(request); 2 string redirectfile = style.getdisstyle(); 3 string forwardfile = style.getfile(redirectfile) 4 javax.servlet.requestdispatcher dispatcher = request.getrequestdispatcher(forwardfile); 以上代码是所有完整的调用，其中： 第一句是初始化 getuastyle 对象，取得手机型号（ua）相关信息 第二句通过 ua 信息得到此 ua 支持的格式信息 第三句是通过得到的格式信息返回相应的具体页面文件名（此步骤需要预 先配置好相关页面与格式的匹配信息） 中国联合网络通信有限公司 32 第四句重定向到上一步取得的页面。 2.6.2 浏览类业务浏览类业务 基本要求基本要求 用户可以通过终端的浏览器查看从门户服务器上收到的信息。 用户在门户上浏览，访问非计费url，门户展现用户所点击的相关页面。 用户在门户上浏览，访问计费url，根据对用户订购关系的认证鉴权结果，门 户展现用户所订购业务的内容或者展现订购页面。 .1展现适配展现适配 页面适配过程是针对用户手机终端的属性如屏幕尺寸、色彩、终端能力等因素， 为页面中每个频道选择适合的频道模板的过程。手机终端类型繁多，为了提高页面 适配的可操作性和适配效率，可将手机终端分组，对应终端分组分别开发适合的页 面模板。这样门户展现系统的终端适配过程可以概括为以下的进程： (1) 当用户终端通过无线网络访问门户系统时，门户系统根据所获得的用户终 端信息，确定其所属的终端分组。 (2) 以终端分组信息为依据匹配页面模板。 (3) 根据匹配的模板中嵌入的标记信息，门户展现系统将缓存或者数据库中对 应的页面数据元素提取出来，完成内容填充。 (4) 系统对内容进行适配规则的检验，并将内容变成最终的展现页面，实现页 面适配。 .2 业务适配业务适配 业务适配的基础是用户的产品订购、用户组信息及地域信息等。所谓用户订购 是指某些业务只有在用户订购的情况下才能显示；所谓用户组信息是指用户所属用 户组，如某集团用户、某业务的测试用户、归属地用户等，系统会根据用户所属用 户组情况进行业务筛选，然后把适合该组的部分展现出来； 中国联合网络通信有限公司 33 业务适配也可对用户手机终端不支持的业务进行屏蔽，或者不屏蔽但用户访问 的时候提示用户不能进行此类业务操作。同时，可以对手机终端展现其特有的业务。 业务适配功能可以根据以上这些情况选择符合用户的频道、栏目、内容等，提 供给门户展现模块。 .3 个性化适配个性化适配 个人喜好适配是指根据用户的使用习惯进行业务内容的调整及展现的适配。个 人喜好适配并不改变提供给用户的数据信息，而只是对这些数据的组织形式及次序 等发生影响。 用户访问门户系统后，门户系统会获取该用户的个性化信息及历史访问情况，并且 在页面展现时根据这些内容进行个人喜好适配。如某用户喜爱体育内容，而且对足 球特别感兴趣，根据用户的访问历史，系统把体育频道排列在第一位，而且把该频 道的足球栏目排序在最前面。 .4 内容套接内容套接 系统支持在首页面上展现相关内容，当点击此内容后，在二级页面上展现包含 该内容在内的某个栏目的内容条目列表。 .5页面优化页面优化 门户展现系统各种功能的复杂性会增加系统的响应时延和服务器的压力，影响 用户的业务体验。系统应提供缓存服务策略优化页面的展示效率。缓存服务包括对 新增数据的缓存和对用户访问页面的缓存服务。 其中新增数据缓存包括以下数据： rss获取的数据 内容管理发布的数据 门户模板信息 模板匹配规则 对用户访问页面的缓存指系统缓存用户访问过的页面内容，当用户多次访问该页面 时，大部分请求都能够从缓存中获取，从而加快响应速度。 中国联合网络通信有限公司 34 .6 内容灵活展现内容灵活展现 动态栏目 动态栏目指根据设定的规则，自动更改显示内容的栏目。门户展现系统为动态栏目维 持一个内容列表，并根据该内容列表中的内容去动态更新栏目中显示给用户的内容。 例如一个新闻栏目，运营人员可以把这个栏目设定为动态栏目，并设定其动态更新方式， 如一小时更