沃云详细设计书_安全认证

沃云详细设计书用户设置version: 0.1last update:版本历史版本提案人批准人日期描 述0.1杨鹏新建全体目 录1概要52详细设计52.1获取用户信息52.1.1功能描述52.1.2处理过程52.1.3程序时序图62.1.4程序结构72.1.5DB访问72.2更新用户信息82.2.1功能描述82.2.2处理过程82.2.3程序时序图102.2.4程序结构102.2.5DB访问112.3推荐沃云122.3.1功能描述122.3.2处理过程122.3.3程序时序图142.3.4程序结构142.3.5DB访问152.4获取存储空间152.4.1功能描述152.4.2处理过程162.4.3程序时序图162.4.4程序结构172.4.5DB访问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访问Table IDI / ORIUDwo_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条件参数usernamemobile条件参数5、 若为用户邮件激活处理，即MailActive为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访问Table IDI / ORIUDwo_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访问Table IDI / ORIUDsns_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条件js