net.sohelp.boot.dev.web.user

类 UserThirdpartQywxController

java.lang.Object

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

net.sohelp.boot.dev.web.user.UserThirdpartQywxController

@RestController(value="dev-user-thirdpart-qywx")
 @RequestMapping(value="/dev/user/qywx")
public class UserThirdpartQywxController
extends BaseController

企业微信第三方控制器 提供与企业微信相关的用户绑定、消息发送及解绑功能。

从以下版本开始:

2024/10/23 17:26

作者:

ShenganWu

字段概要

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

request, response

构造器概要

构造器

构造器和说明
UserThirdpartQywxController()

方法概要

限定符和类型	方法和说明
Object	invokeQywxBinding(Map<String,Object> paramMap) 处理企业微信绑定回调请求 接收来自企业微信的授权码，获取用户信息后完成用户与企业微信账号的绑定关系。
ApiResult<String>	qywxBinding() 跳转至企业微信绑定页面 根据系统配置的企业微信登录参数构造跳转链接并重定向至企业微信授权页。
ApiResult<String>	qywxUnbind() 解除当前用户的企微绑定关系 删除当前登录用户在系统中的企业微信绑定记录。
ApiResult<String>	sendQywx(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

构造器详细资料

UserThirdpartQywxController

public UserThirdpartQywxController()

方法详细资料

sendQywx

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

发送企业微信用户消息 将指定的消息内容通过企业微信发送给目标用户，并记录通知信息到数据库。

参数:

paramMap - 请求参数集合，应包含以下字段： - to_user_id：接收人的用户ID（必填） - message：要发送的消息文本（必填）

返回:

ApiResult 返回操作结果状态和提示信息

抛出:

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

qywxBinding

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

跳转至企业微信绑定页面 根据系统配置的企业微信登录参数构造跳转链接并重定向至企业微信授权页。

返回:

ApiResult 成功时返回null（执行跳转），失败则返回错误信息

抛出:

IOException - IO异常

TokenAuthenticationException - 认证异常

invokeQywxBinding

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

处理企业微信绑定回调请求 接收来自企业微信的授权码，获取用户信息后完成用户与企业微信账号的绑定关系。

参数:

paramMap - 回调携带的参数，包括code等认证信息

返回:

Object 绑定成功跳转至用户详情页，失败跳转至错误页

抛出:

Exception - 可能发生的业务或IO异常

qywxUnbind

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

解除当前用户的企微绑定关系 删除当前登录用户在系统中的企业微信绑定记录。

返回:

ApiResult 返回解绑操作的结果描述

抛出:

Exception - 数据库删除过程可能出现的异常