沃云详细设计书_SNS_分享.docx

沃云详细设计书SNS 分享version: 0.1last update:2012-4-23版本历史版本提案人批准人日期描 述0.1杨鹏新建全体目 录1概要42详细设计42.1保存待分享文件的元信息42.1.1功能描述42.1.2程序结构42.2建立分享关系52.2.1功能描述52.2.2处理过程52.2.3程序时序图82.2.4程序结构82.2.5DB访问92.3上传待分享文件102.3.1功能描述102.3.2程序结构102.4获取分享消息慢同步/获取分享消息的元信息112.5获取分享消息快同步112.6获取分享文件的元信息112.6.1功能描述112.6.2处理过程112.6.3程序时序图132.6.4程序结构132.6.5DB访问143补充说明15概要SNS指用户好友、好友组相关的管理功能。好友功能包括对创建、编辑、获取、删除、好友等功能的支持。分享的业务流程如下：1.用户选择本地待分享的文件，选择分享的好友（组）2.发送分享请求消息，带上文件META信息，好友（组）ID3.上传文件流，带上分享文件ID4.好友确认接收，获取消息中心分享消息及分享文件ID5.获取分享文件META信息6.下载分享文件详细设计保存待分享文件的元信息功能描述向DB中保存待分享的媒体文件元信息，并返回文件ID。参考“沃云详细设计书_备份.docx”中章节“2.3 创建文件的元信息”。程序结构程序UML图如下所示：建立分享关系功能描述用户分享某些文件给好友或好友组，建立文件与好友或好友组的分享关系，并建立分享消息通知好友。处理过程获取必要参数参数名数据类型参数来源说明idStringHttpServletRequest分享文件ID（复数）friendsStringHttpServletRequest好友ID（复数）msgStringHttpServletRequest分享消息friendgroupidStringHttpServletRequest好友组（复数）调用同步引擎Sync4jEngine.getServerSource(sourceName)方法，获得同步源。初始化同步源的设备ID，即将2取得的同步源的DeviceId设置为SapiSessionHandler.syncState.device对象的DeviceId。当参数friendgroupid非空时，建立文件与指定好友组的分享关系： 用参数friendgroupid中每个groupid为条件，获取该好友组所包含的好友。（检索表sns_friend_group_ref）参数名类型数据来源说明id查询sns_friend好友iduserid条件jsession用户IDgroupid条件参数好友组ID校验4处理所得好友ID及参数friends中每个好友ID（去掉重复数据）是否为请求用户的有效好友：参数名类型数据来源说明id查询sns_friend好友idid条件4处理结果和参数好友iduserid条件jsession用户IDsource_uri条件jsessionURIstatus条件 D非删除状态echo_status条件Y以通过验证为5处理结果取得的所有好友ID建立分享关系。（插入表sns_outer_shared）参数名类型数据来源说明id插入DBIDGenerator(idspace=f.outershared.id)分享IDuserid插入jsession用户IDsource_uri插入jsessionURIdeviceid插入3处理结果设备IDlast_update插入系统时间更新时间status插入N新建标识fdo_id插入参数文件IDfriend_id插入5处理结果好友IDfriend_group_id插入若好友未分组则设置-1好友组IDupload_status插入N未开始shared_time插入系统时间分享时间若分享关系建立成功，则建立系统消息：参数名类型数据来源说明id插入DBIDGenerator (idspace= sms.id)消息IDuserid插入5处理结果好友IDsource_uri插入sharedmsgURIdeviceid插入3取得值设备IDlast_update插入系统时间更新时间status插入N新建标识content插入消息内容消息内容from_source插入jsession用户IDview_status插入N未读状态op_status插入N未处理状态time插入系统时间系统时间category插入80消息分类将6获取的分享ID集按照接口要求封装为JSONObject，放入响应报文中。（NormalResponse）处理结束。程序时序图程序时序图如下所示：程序结构程序UML图如下所示：DB访问Table IDI / ORIUDsns_fri