程序包 net.sohelp.boot.demo.web.user

类 UserThirdpartPhoneController

java.lang.Object

net.sohelp.boot.admin.core.base.BaseController

net.sohelp.boot.demo.web.user.UserThirdpartPhoneController

@RestController("admin-user-third-part-phone")
@RequestMapping("/admin/user/phone")
public class UserThirdpartPhoneController
extends BaseController

手机第三方控制器 提供与手机号相关的操作接口，包括发送短信、绑定/解绑手机号等。

从以下版本开始:

2024/10/23 17:32

作者:

ShenganWu

字段概要

从类继承的字段 net.sohelp.boot.admin.core.base.BaseController

request, response

构造器概要

构造器

构造器	说明
UserThirdpartPhoneController()

方法概要

修饰符和类型	方法	说明
ApiResult<String>	getCode(Map<String,String> paramMap)	发送手机验证码到指定号码
ApiResult<String>	phoneBinding(Map<String,Object> paramMap)	绑定当前登录用户的手机号
ApiResult<String>	phoneUnbind()	解除当前登录用户的手机号绑定关系
ApiResult<Object>	sendPhone(Map<String,Object> paramMap)	向指定用户发送手机通知消息

从类继承的方法 net.sohelp.boot.admin.core.base.BaseController

error, error, fail, fail, fail, getLoginID, getLoginName, getLoginOrgID, getLoginOrgName, getLoginUser, getNickname, getTenantId, getUserName, getUserNo, i18n, i18n, isAdministrator, isDeveloper, limit, offset, ok, ok, response, response, responseStream, success, success, success, success, validateToken

从类继承的方法 java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

构造器详细资料

UserThirdpartPhoneController

public UserThirdpartPhoneController()

方法详细资料

sendPhone

@PostMapping("/sendPhone")
@Permission("")
@Transactional(rollbackFor=java.lang.Exception.class)
public ApiResult<Object> sendPhone(@RequestBody
 Map<String,Object> paramMap)
                            throws Exception

向指定用户发送手机通知消息

参数:

paramMap - 请求参数，必须包含 to_user_id（目标用户ID） 和 message（消息内容）

返回:

返回发送结果，成功则返回“发送成功!”

抛出:

Exception - 数据库或服务调用异常时抛出

getCode

@PostMapping("/sendPhoneCode")
@Permission("")
public ApiResult<String> getCode(@RequestBody
 Map<String,String> paramMap)
                          throws Exception

发送手机验证码到指定号码

参数:

paramMap - 请求参数，必须包含 phone 字段表示要发送验证码的目标手机号

返回:

返回发送状态，成功则返回“发送成功”

抛出:

Exception - 当参数为空或其他业务逻辑错误时可能抛出异常

phoneBinding

@PostMapping("/binding")
@Transactional(rollbackFor=java.lang.Exception.class)
@Permission("")
public ApiResult<String> phoneBinding(@RequestBody
 Map<String,Object> paramMap)
                               throws Exception

绑定当前登录用户的手机号

参数:

paramMap - 包含 code（验证码）、phone（手机号）两个字段

返回:

成功返回“绑定成功”，失败返回对应提示信息

抛出:

Exception - 验证码校验失败、数据库操作异常等情况会抛出异常

phoneUnbind

@PostMapping("/unbind")
@Permission("")
@Transactional(rollbackFor=java.lang.Exception.class)
public ApiResult<String> phoneUnbind()
                              throws Exception

解除当前登录用户的手机号绑定关系

返回:

返回解绑结果，“解绑成功!”表示操作完成

抛出:

Exception - 数据库删除操作异常时抛出