net.sohelp.boot.dev.web.user

类 UserThirdpartQQController

java.lang.Object

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

net.sohelp.boot.dev.web.user.UserThirdpartQQController

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

QQ第三方登录控制器，提供QQ账号与系统用户的绑定、解绑及回调处理功能。

从以下版本开始:

2024/10/22 13:45

作者:

AaronFung

字段概要

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

request, response

构造器概要

构造器

构造器和说明
UserThirdpartQQController()

方法概要

限定符和类型	方法和说明
ApiResult<Map<String,Object>>	invokeQqBinding(Map<String,Object> paramMap) 处理QQ授权后的回调请求，并完成QQ账号与系统用户的绑定逻辑。
ApiResult<String>	qqBinding() 发起QQ绑定流程。
ApiResult<String>	qqUnbind() 解除当前用户与QQ账号的绑定关系。

从类继承的方法 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

构造器详细资料

UserThirdpartQQController

public UserThirdpartQQController()

方法详细资料

qqUnbind

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

解除当前用户与QQ账号的绑定关系。

返回:

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

抛出:

Exception - 数据库删除过程中可能抛出异常

qqBinding

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

发起QQ绑定流程。根据系统配置跳转至QQ授权页面进行绑定。

返回:

成功时重定向到QQ授权页；若缺少必要配置项，则返回错误信息。

抛出:

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

TokenAuthenticationException - 用户身份验证失败

invokeQqBinding

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

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

参数:

paramMap - 请求参数集合，包括授权码(code)和状态(state)，其中state用于标识用户ID

返回:

绑定完成后重定向至用户信息页；若发生异常则跳转至错误页并携带错误消息

抛出:

Exception - 操作数据库或调用服务过程中的潜在异常