net.sohelp.boot.demo.web.user

类 UserThirdpartDingdingController

java.lang.Object

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

net.sohelp.boot.demo.web.user.UserThirdpartDingdingController

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

用户第三方登录控制器，用于处理与钉钉相关的用户绑定、解绑及消息发送功能。

从以下版本开始:

2024/10/22 13:39

作者:

AaronFung

字段概要

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

request, response

构造器概要

构造器

构造器和说明
UserThirdpartDingdingController()

方法概要

限定符和类型	方法和说明
ApiResult<String>	dingdingBinding() 跳转至钉钉授权页面进行绑定流程。
ApiResult<String>	dingdingUnbind() 解除当前用户的钉钉绑定关系。
Object	invokeDingdingBinding(Map<String,Object> paramMap) 处理钉钉授权后的回调请求，并完成用户与钉钉账号的绑定逻辑。
ApiResult<String>	sendDingDing(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, success, success, success, success, validateToken

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

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

构造器详细资料

UserThirdpartDingdingController

public UserThirdpartDingdingController()

方法详细资料

dingdingUnbind

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

解除当前用户的钉钉绑定关系。

返回:

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

抛出:

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

dingdingBinding

@GetMapping(value="/binding")
 @Permission(value="")
public ApiResult<String> dingdingBinding()
                                                                                         throws IOException,
                                                                                                TokenAuthenticationException

跳转至钉钉授权页面进行绑定流程。

返回:

成功时重定向到钉钉授权页；失败时返回错误信息

抛出:

IOException - IO 异常（如 URL 编码）

TokenAuthenticationException - 认证相关异常

invokeDingdingBinding

@RequestMapping(value="/invoke/binding",
                method={GET,POST})
 @Transactional(rollbackFor=java.lang.Exception.class)
 @Permission(value="")
public Object invokeDingdingBinding(@RequestParam
                                                                                                                                                                                                  Map<String,Object> paramMap)
                                                                                                                                                                                           throws Exception

处理钉钉授权后的回调请求，并完成用户与钉钉账号的绑定逻辑。

参数:

paramMap - 请求参数集合，包括 authCode 和 state（即用户 ID）

返回:

绑定成功后跳转到指定页面或发生错误时跳转到错误页面

抛出:

Exception - 可能发生的数据库或其他业务层异常

sendDingDing

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

向目标用户发送钉钉通知消息。

参数:

paramMap - 包含 to_user_id 和 message 字段的消息数据

返回:

发送成功的确认信息

抛出:

Exception - 数据库插入或调用服务接口时可能出现的异常