net.sohelp.boot.demo.web.user

类 UserThirdpartEmailController

java.lang.Object

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

net.sohelp.boot.demo.web.user.UserThirdpartEmailController

@RestController(value="admin-user-thirdpart-email")
 @RequestMapping(value="/admin/user/email")
public class UserThirdpartEmailController
extends BaseController

邮件第三方控制器 提供与用户邮箱相关的操作接口，包括发送邮件、发送验证码、绑定和解绑邮箱等功能。

从以下版本开始:

2024/10/23 16:43

作者:

ShenganWu

字段概要

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

request, response

构造器概要

构造器

构造器和说明
UserThirdpartEmailController()

方法概要

限定符和类型	方法和说明
ApiResult<String>	emailBinding(Map<String,Object> paramMap) 绑定当前登录用户到指定邮箱 验证提供的验证码是否有效并匹配，若验证通过则将邮箱信息保存至数据库并与当前用户关联。
ApiResult<String>	emailUnbind() 解除当前登录用户与邮箱的绑定关系 删除数据库中当前用户对应的邮箱绑定记录。
ApiResult<String>	sendMail(Map<String,Object> paramMap) 发送邮件消息给指定用户 根据接收用户的ID查询其绑定的邮箱，并插入通知记录后通过邮件服务发送消息。
ApiResult<String>	sendMailCode(Map<String,String> 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, success, success, success, success, validateToken

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

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

构造器详细资料

UserThirdpartEmailController

public UserThirdpartEmailController()

方法详细资料

sendMail

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

发送邮件消息给指定用户 根据接收用户的ID查询其绑定的邮箱，并插入通知记录后通过邮件服务发送消息。

参数:

paramMap - 请求参数，必须包含 to_user_id（接收人用户ID） 和 message（邮件内容）

返回:

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

抛出:

Exception - 操作过程中可能抛出异常

sendMailCode

@PostMapping(value="/sendMailCode")
 @Permission(value="")
public ApiResult<String> sendMailCode(@RequestBody
                                                                                                   Map<String,String> paramMap)
                                                                                            throws Exception

向指定邮箱发送验证码 先校验系统中是否正确配置了邮件相关参数，然后向目标邮箱发送随机生成的验证码。

参数:

paramMap - 请求参数，必须包含 email 字段表示要发送验证码的目标邮箱地址

返回:

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

抛出:

Exception - 操作过程中可能抛出异常

emailBinding

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

绑定当前登录用户到指定邮箱 验证提供的验证码是否有效并匹配，若验证通过则将邮箱信息保存至数据库并与当前用户关联。

参数:

paramMap - 请求参数，需包含 email（待绑定邮箱）和 code（收到的验证码）

返回:

返回操作结果，成功则返回“绑定成功”

抛出:

Exception - 操作过程中可能抛出异常

emailUnbind

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

解除当前登录用户与邮箱的绑定关系 删除数据库中当前用户对应的邮箱绑定记录。

返回:

返回操作结果，成功则返回“解绑成功!”

抛出:

Exception - 操作过程中可能抛出异常