沃云详细设计书 用户设置version: 0.1last update:版本历史版本历史版本版本提案人提案人批准人批准人日期日期描描 述述0.1杨鹏新建全体目 录1概要52详细设计.52.1获取用户信息52.1.1 功能描述52.1.2 处理过程52.1.3 程序时序图 62.1.4 程序结构72.1.5 DB 访问.72.2更新用户信息82.2.1 功能描述82.2.2 处理过程82.2.3 程序时序图 102.2.4 程序结构102.2.5 DB 访问.112.3推荐沃云 .122.3.1 功能描述122.3.2 处理过程122.3.3 程序时序图 142.3.4 程序结构142.3.5 DB 访问.152.4获取存储空间152.4.1 功能描述152.4.2 处理过程162.4.3 程序时序图 162.4.4 程序结构172.4.5 DB 访问.173补充说明.181 概要概要沃云服务器管理用户安全认证信息，包括获取用户、设备的安全认证信息，认证用户令牌、刷新认证令牌等功能。2 详细设计详细设计2.1获取用户安全认证信息获取用户安全认证信息2.1.1 功能描述功能描述获取用户的安全认证信息。2.1.2 处理过程处理过程1、获取必要参数参数名数据类型参数来源说明usernameStringHttpServletRequest用户 IDpasswordStringHttpServletRequest用户密码deviceidStringHttpServletRequest设备 IDgrant_typeStringHttpServletRequest授权类型2、调用同步引擎 Sync4jEngine.getServerSource(sourceName)方法，获得同步源。3、初始化同步源的设备 ID，即将 2 取得的同步源的 DeviceId 设置为SapiSessionHandler.syncState.device 对象的 DeviceId。4、获取用户基本信息检索表 wo_user：参数名类型数据来源说明username查询wo_usernickname查询wo_userarea_province查询wo_userarea_city查询wo_usermail查询wo_usermail_active查询wo_userstatus查询wo_userarea_id查询wo_usercreate_date查询wo_userupdate_date查询wo_usermobile查询wo_usermobile_active查询wo_userauthcode查询wo_usergen_authcode_time查询wo_useruserid条件参数用户 ID5、将 4 获取的用户信息集按照接口要求封装为 JSONObject，放入响应报文中。（NormalResponse）6、处理结束。2.1.3 程序时序图程序时序图程序时序图如下所示：2.1.4 程序结构程序结构程序 UML 图如下所示：2.1.5 DB 访问访问I / OTable IDRIUDwo_userY-2.2更新用户信息更新用户信息2.2.1 功能描述功能描述更新用户的基本信息。2.2.2 处理过程处理过程1、获取必要参数参数名数据类型参数来源说明usernameStringHttpServletRequest用户 IDpasswordStringHttpServletRequest密码nicknameStringHttpServletRequest昵称provinceStringHttpServletRequest所属省cityStringHttpServletRequest所属市mailStringHttpServletRequest邮件地址mobileStringHttpServletRequest电话号码2、调用同步引擎 Sync4jEngine.getServerSource(sourceName)方法，获得同步源。3、初始化同步源的设备 ID，即将 2 取得的同步源的 DeviceId 设置为SapiSessionHandler.syncState.device 对象的 DeviceId。4、若为用户手机激活处理，即 MobileActive 为“Y“，则校验手机号码是否重复。并返回错误码 4，处理结束。检索表 fnbl_user参数名类型数据来源说明userid条件参数 usernamemail条件参数6、更新沃云用户基本信息a. 更新表 wo_user：参数名类型数据来源说明mobile更新参数若参数 mobile 不为空mobile_active更新Y若参数 mobile 不为空carrier更新若参数 mobile 不为空mail更新参数若参数 mail 不为空mail_active更新Y若参数 mail 不为空username更新参数nickname更新参数area_province更新参数area_city更新参数update_date更新系统时间更新时间userid条件参数用户 IDb. 更新表 fnbl_user：参数名类型数据来源说明mobile更新参数若参数 mobile 不为空mail更新参数若参数 mail 不为空password更新参数若参数 password 不为空username更新参数nickname更新参数userid条件参数用户 ID7、若用户手机号码变化，则建立手机消息，提示用户激活手机号码。参考“沃云详细设计书_消息中心.docx”章节“2.3 新建消息”8、若用户邮件地址变化，则建立邮件消息，提示用户激活邮件地址。参考“沃云详细设计书_消息中心.docx”章节“2.3 新建消息”9、按照接口要求封装为 JSONObject，放入响应报文中。 （NormalResponse）10、处理结束。2.2.3 程序时序图程序时序图程序时序图如下所示：2.2.4 程序结构程序结构程序 UML 图如下所示：2.2.5 DB 访问访问I / OTable IDRIUDwo_userY-Y-fnbl_userY-Y-2.3推荐沃云推荐沃云2.3.1 功能描述功能描述指沃云用户向非沃云用户推荐沃云产品。2.3.2 处理过程处理过程1、获取必要参数参数名数据类型参数来源说明idStringRequestJsonObject推荐 IDtargetsStringRequestJsonObject目标 ID（复数）messageStringRequestJsonObject消息内容2、调用同步引擎 Sync4jEngine.getServerSource(sourceName)方法，获得同步源。3、初始化同步源的设备 ID，即将 2 取得的同步源的 DeviceId 设置为SapiSessionHandler.syncState.device 对象的 DeviceId。4、初始化媒体文件对象，并将 1 获得的参数作为该对象的初始值。5、判断 1 取得的 id 参数，若 id 为空，则新增推荐。a. 判断目标 ID 是否已存在：查询表 fnbl_user参数名类型数据来源说明userid查询fnbl_usermobile 条件参数mailOr 条件参数b. 若 a 查询得出目标已存在，则忽略该目标，否则新增推荐记录：插入表 sns_invite_log参数名类型数据来源说明id插入DBIDGenerator(idspace=f.invite.id)userid插入jsessionsource_uri插入jsessiondeviceid插入3 取得值last_update插入系统时间status插入Ninvite_target插入参数target_type插入M / E手机/邮件invite_msg插入参数invite_code插入6 位随机数字invite_status插入Ptime插入系统时间c. 若用户手机号码变化，则建立手机消息，提示用户注册沃云。参考“沃云详细设计书_消息中心.docx”章节“2.3 新建消息”d. 若用户邮件地址变化，则建立邮件消息，提示用户注册沃云。参考“沃云详细设计书_消息中心.docx”章节“2.3 新建消息”6、判断 1 取得的 id 参数，若 id 非空，则更新推荐记录：更新表 sns_invite_log参数名类型数据来源说明deviceid更新3 取得值设备 IDlast_update更新系统时间更新时间status更新U更新标识invite_target更新参数推荐目标target_type更新M / E手机/邮件invite_msg更新参数推荐消息invite_code更新原 invite_code推荐码invite_status更新原 invite_status推荐状态time更新系统时间操作时间userid条件jsession用户 IDsource_uri条件jsessionURI7、接口要求封装为 JSONObject，放入响应报文中。 （NormalResponse）8、处理结束。2.3.3 程序时序图程序时序图程序时序图如下所示：2.3.4 程序结构程序结构程序 UML 图如下所示：2.3.5 DB 访问访问I / OTable IDRIUDsns_invite_log-YY-fnbl_userY2.4获取存储空间获取存储空间2.4.1 功能描述功能描述获取用户存储空间信息。2.4.2 处理过程处理过程1、获取必要参数参数名数据类型参数来源说明idStringRequestJsonObject文件 IDnameStringRequestJsonObject文件夹名parentIdStringRequestJsonObject父文件夹 IDinnerSharedStatusStringRequestJsonObject共享状态2、调用同步引擎 Sync4jEngine.getServerSource(sourceName)方法，获得同步源。3、初始化同步源的设备 ID，即将 2 取得的同步源的 DeviceId 设置为SapiSessionHandler.syncState.device 对象的 DeviceId。4、查询用户已用空间。参数名类型数据来源说明sum(size_on_storage)查询fnbl_file_data_objectuserid条件jsession用户 IDsource_uri条件 D非删除状态5、接口要求封装为 JSONObject，放入响应报文中。 （NormalResponse）6、处理结束。2.4.3 程序时序图程序时序图程序时序图如下所示：2.4.4 程序结构程序结构程序 UML 图如下所示：2.4.5 DB 访问访问Table IDI / ORIUDfnbl_file_data_objectY-3 补充说明补充说明相关接口参考“沃云 Sapi 协议.docx” 。