net.sohelp.boot.demo.web.user

类 UserThirdpartQywxController

java.lang.Object

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

net.sohelp.boot.demo.web.user.UserThirdpartQywxController

@RestController(value="admin-user-thirdpart-qywx")
 @RequestMapping(value="/admin/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="")
 @Transactional(rollbackFor=java.lang.Exception.class)
public ApiResult<String> sendQywx(@RequestBody
                                                                                                                                                   Map<String,Object> paramMap)
                                                                                                                                            throws Exception

发送企业微信用户消息 向指定的企业微信用户发送一条文本消息，并记录通知信息到数据库中。

参数:

paramMap - 请求参数，必须包含 to_user_id 和 message 字段 - to_user_id：接收用户的ID - message：要发送的消息内容

返回:

ApiResult 返回操作结果，成功时返回“发送成功!”，失败则返回错误原因

抛出:

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

qywxBinding

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

绑定企业微信账户 引导当前登录用户跳转至企业微信授权页面进行扫码绑定操作。

返回:

ApiResult 成功后重定向到企业微信授权页，否则返回错误提示

抛出:

IOException - IO异常（如URL编码或重定向）

TokenAuthenticationException - 认证异常（如无法获取登录ID）

invokeQywxBinding

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

处理企业微信绑定回调请求 接收来自企业微信的授权码并完成用户与企业微信账号的绑定流程。

参数:

paramMap - 请求参数，应包含 code 和 userId 字段 - code：企业微信授权码 - userId：系统中的用户ID

返回:

Object 成功后重定向到用户信息页，失败则跳转到错误页面

抛出:

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

qywxUnbind

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

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

返回:

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

抛出:

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