1、沃云详细设计书SNS 好友version: 0.1last update:2012-4-21版本历史版本 提案人 批准人 日期 描 述0.1 杨鹏 新建全体目 录1 概要 .62 详细设计 .62.1 慢同步/获取好友 .62.1.1 功能描述 .62.1.2 处理过程 .62.1.3 程序时序图 .82.1.4 程序结构 .92.1.5 DB 访问 .92.2 快同步 .102.3 创建/修改好友 .102.3.1 功能描述 .102.3.2 处理过程 .102.3.3 程序时序图 .132.3.4 程序结构 .142.3.5 DB 访问 .142.4 删除好友 .152.4.1 功能描述
2、.152.4.2 处理过程 .152.4.3 程序时序图 .162.4.4 程序结构 .172.4.5 DB 访问 .182.5 好友分组入 .182.5.1 功能描述 .182.5.2 处理过程 .182.5.3 程序时序图 .202.5.4 程序结构 .202.5.5 DB 访问 .212.6 好友分组出 .222.6.1 功能描述 .222.6.2 处理过程 .222.6.3 程序时序图 .232.6.4 程序结构 .232.6.5 DB 访问 .242.7 更新好友信息 .252.7.1 功能描述 .252.7.2 处理过程 .252.7.3 程序时序图 .262.7.4 程序结构 .
3、262.7.5 DB 访问 .272.8 查找好友 .272.8.1 功能描述 .272.8.2 处理过程 .282.8.3 程序时序图 .292.8.4 程序结构 .292.8.5 DB 访问 .302.9 接受好友请求 .312.9.1 功能描述 .312.9.2 处理过程 .312.9.3 程序时序图 .342.9.4 程序结构 .352.9.5 DB 访问 .362.10 拒绝好友请求 .372.10.1 功能描述 .372.10.2 处理过程 .372.10.3 程序时序图 .392.10.4 程序结构 .402.10.5 DB 访问 .413 补充说明 .421 概要SNS 指用户
4、好友、好友组相关的管理功能。好友功能包括对创建、编辑、获取、删除、好友等功能的支持。新增好友业务流程如下:1. A 请求加 B 为好友2. B 获取好友变化信息,获取好友 META 信息,发送确认好友消息3. A 获取好友变化信息,获取好友 META 信息删除好友业务流程如下:1. A 请求删除好友 B,参数:好友 ID。删除好友关系2. B 获取好友变化信息,删除好友关系2 详细设计2.1慢同步/获取好友2.1.1 功能描述获取用户全部好友,或指定 id 的好友。该功能用于慢同步、或其他需要获取好友的情况。2.1.2 处理过程1、 获取必要参数参数名 数据类型 参数来源 说明id Strin
5、g HttpServletRequest 好友 ID(复数个)jsessionId String HttpServletRequest Session IDlimit String HttpServletRequest 最大数量offset String HttpServletRequest 偏移2、 判断 1 获得的参数 “id”,若 id 为空,获取该用户全部好友信息。注:若 limit 和 offset 非空,需考虑获取最大数量和起始偏移参数名 类型 数据来源 说明id 查询 sns_friend 好友 iduserid 条件 jsession 用户 IDsource_uri 条件 js
6、ession URIstatus 条件 D 非删除状态获取好友头像信息:参数名 类型 数据来源 说明id 条件 fnbl_file_data_object 头像文件 IDdeviceid 查询 fnbl_file_data_object 设备 IDtrue_name 查询 fnbl_file_data_object 头像文件名object_size 查询 fnbl_file_data_object 头像文件大小userid 条件 jsession 用户 IDsource_uri 条件 face 头像文件 URIstatus 条件 D 非删除状态id 排序 desc 头像文件 ID注:因好友仅有一个头像,为提高效率,该查询仅返回第一条数据即可。4、 将 3 获取的好友信息集按照接口要求封装为 JSONObject,放入响应报文中。(NormalResponse)5、 处理结束。2.1.3 程序时序图程序时序图如下所示:2.1.4 程序结构程序 UML 图如下所示:2.1.5 DB 访问I / OTable IDR I U Dsns_friend Y - - -fnbl_file_data_object Y - - -2.2快同步参考“沃云详细设计书_ 同步 .docx”的 2.2 节。