用户 - UserService

用户相关业务接口

使用逻辑

这个服务主要有两种用法，“快速注册/登录”（一键注册/登录）和“普通注册/登录”路径。

快速注册/登录

调用quickLogin即可完成用户的注册或者登录功能。

  • 第一次调用从本地localstorage中存储了随机生成的用户名，用这个用户名和固定的密码去注册（register）一个新用户。
  • 第二次调用的时候，从localstorage中获取存储的用户名作为登录凭据去登录（login）。
  • 可以通过update相关方法更新用户名和密码来重新给用户更换登录凭据，即userid不变，修改username和password，这个调用会同步更新在localstorage中保存的用户名和密码
  • 之后的调用quickLogin，会使用更新过的用户名和密码去登录（login）

普通注册和登录

调用register使用（用户输入的）用户名和密码注册新用户，调用login使用使用（用户输入的）用户名和密码登录。

API说明

sgt.UserService.isMatch(smobile, captcha, callback)

  • smobile: string 用户手机号
  • captcha: string 用户输入验证码
  • callback: Function 回调函数
  • return: string 是否验证成功结果

验证手机号和验证码是否匹配

sgt.UserService.login(userName, password, callback)

  • userName: string 用户名
  • password: string 密码
  • callback: Function 回调函数
  • return: User 登录后的的user对象

第三方登录

sgt.UserService.login3rd(type,callback)

  • type: int 第三方平台类型 eg:sgt.User.WECHAT_MP 是枚举的微信公众平台类型
  • callback: Function 回调函数
  • return: User 登录后的的user对象

手动登录

sgt.UserService.regist(user, callback)

  • user: User user对象
  • callback: Function 回调函数
  • return: User 注册后的user对象

客户端通过提交user对象完成注册

sgt.UserService.resetPassword(userName, callback)

  • userName: string 用户名
  • callback: Function 回调函数
  • return: null

重置密码发送邮件

sgt.UserService.saveLeaveInfo(userLeaveInfo, callback)

  • userLeaveInfo: UserLeaveInfo 用户留资对象
  • callback: Function 回调函数
  • return: UserLeaveInfo 用户留资对象

保存用户留资方法

sgt.UserService.sendCaptchaMessage(smobile, appName, callback)

  • smobile: string 用户手机号
  • appName: string 当前产品名称
  • callback: Function 回调函数
  • return: boolean true发送成功, false发送失败

发送手机验证码短信

sgt.UserService.updatePasswordByUserName(userName, password, callback)

  • userName: string 用户名
  • password: string 密码
  • callback: Function 回调函数
  • return: null

通过用户名更改密码

sgt.UserService.updateUser(user, callback)

  • user: User User数据对象
  • callback: Function 回调函数
  • return: User 更新之后的user

更新用户信息

sgt.UserService.updateUserByUserId(userid, userName, password, email, callback)

  • userid: string 用户ID
  • userName: string 用户名
  • password: string 密码
  • email: string 邮箱
  • callback: Function 回调函数
  • return: boolean true更新成功, false更新失败

更新用户名，密码，邮箱

sgt.UserService.updateUserNameAndPassword(userid, userName, password, callback)

  • userid: string 用户名
  • userName: string 用户名
  • password: string 密码
  • callback: Function 回调函数
  • return: boolean true更新成功, false更新失败

更新用户名，密码

sgt.UserService.validationToken(userName, token, callback)

  • userName: string 用户名
  • token: string token令牌
  • callback: Function 回调函数
  • return: boolean true合法，false不合法

检测token有效性

sgt.UserService.quickLogin(callback)

  • callback: Function 回调函数
  • return: User 登录后的user对象

快速登录

sgt.UserService.saveLocalStorage(userName, password)

  • userName: string 用户名
  • password: string 密码

存储或修改当前应用标识的用户名和密码到localStorage中,便于快速登录

sgt.UserService.removeLocalStorage()

删除localStorage中的当前应用标识的用户名和密码