封装通用第三方平台用户表(微信开放平台)

2024-08-21 19:44

本文主要是介绍封装通用第三方平台用户表(微信开放平台),希望对大家解决编程问题提供一定的参考价值,需要的开发者们随着小编来一起学习吧!

文章目录

    • 一. 注册微信开放平台
      • 1.1 开发者资质认证
      • 1.2 应用申请
      • 1.3 配置应用
    • 二.通用数据库表设计
    • 三.入库实体类
    • 四. 对接第三方平台
    • 4.1 微信开放平台VO对象
      • 4.2 通用方法


我们的系统可能要对接很多第三方系统,为了便利用户授权使用和对多平台账户的管理。有必要设计通用第三方平台表。用来统一用户管理,将以微信开放平台为例

一. 注册微信开放平台

首先强调的是 微信公众号平台和微信开放平台不是一个东西。 微信开放平台主要用于自己的系统对接微信。 而微信公众号平台主要使用微信公众号,小程序等微信内部程序对接微信开放接口。 而微信公众测试号不可用于微信开放平台。 微信开放平台必须通过企业认证注册应用实体,才能任意配置回调域使用测试域。

微信开放平台
微信开放平台文档
微信公众号平台
微信公众号平台测试号申请
微信公众号平台文档

1.1 开发者资质认证

在这里插入图片描述
主体必须以公司为认证实体
在这里插入图片描述

1.2 应用申请

扫描件内容必须与网站应用名称、网站应用简介、应用官网完全对应。 审查非常严格,不要得过且过。
在这里插入图片描述

1.3 配置应用

sercet只会出现一次,谨慎保管。如果我们需要登录或支付,其对应的接口状态必须为已获得
在这里插入图片描述
回调域配置,当认证通过后,我们可以使用内网穿透域名进行测试。或者使用公司公网,用nginx代理到个人电脑上进行测试开发
在这里插入图片描述
注意,授权回调域不要加http://或https:// 前缀,直接写域名即可,其中阅读开放平台开发文档时,让填写回调地址,那必须在接口请求时追加http:// 或https:// 前缀


二.通用数据库表设计

在这里插入图片描述

-- 第三方平台万能表  可以不绑定用户
-- access_token移除,作为token不入库
-- 移除 refresh_token ,让前端携带access_token同时携带refresh_token,保证可以刷新token
drop table if exists thirdauth_user;
create table thirdauth_user
(id          bigint unsigned                           not null comment '主键'primary key,user_id     bigint unsigned default 0 comment '用户id',tenant_id   varchar(32)     default '' comment '租户id 子平台再多,也不可能超过100个',nickname    varchar(32)     default ''                null comment '昵称',avator      varchar(255)    default ''                null comment '头像地址',scope       varchar(255)    default ''                null comment '授权范围',platform    varchar(32)                               not null comment '第三方平台名称',openid      varchar(64)                               not null comment '第三方平台用户id',unionid     varchar(64)     default ''                null comment '第三方内部跨平台id',create_time datetime        default CURRENT_TIMESTAMP null comment '创建时间',update_time datetime        default CURRENT_TIMESTAMP null on update CURRENT_TIMESTAMP comment '更新时间',is_delete   tinyint         default 0                 null comment '是否删除 0否 1是',unique `idx_platform_openid` (`platform`, `openid`)
) comment '用户第三方登录表';

三.入库实体类

/*** 用户第三方登录表* @TableName thirdauth_user*/
@TableName(value ="thirdauth_user")
@Data
public class ThirdauthUser implements Serializable {/*** 主键*/@TableIdprivate Long id;/*** 用户id*/@TableField(value = "user_id")private Long userId;/*** 租户id 内部系统哪个平台的用户id*/@TableField(value = "tenant_id")private Long tenantId;/*** 昵称*/@TableField(value = "nickname")private String nickname;/*** 头像地址*/@TableField(value = "avator")private String avator;/*** 第三方平台名称*/@TableField(value = "platform")private String platform;/*** 第三方平台用户id*/@TableField(value = "openid")private String openid;/*** 第三方内部跨平台id*/@TableField(value = "unionid")private String unionid;/*** scope*/@TableField(value = "scope")private String scope;/*** 创建时间*/@TableField(value = "create_time")private LocalDateTime createTime;/*** 更新时间*/@TableField(value = "update_time")private LocalDateTime updateTime;/*** 是否删除 0否 1是*/@TableField(value = "is_delete")@TableLogic(value = "0",delval = "1")private Integer isDelete;@TableField(exist = false)private static final long serialVersionUID = 1L;
}

四. 对接第三方平台

每个平台返回的数据总有差异,我们需要各种vo来协调,最后都归于上述实体类入库。这里仅列出微信开放平台的封装。

4.1 微信开放平台VO对象

/*** @author YuanJie* @date 2024/8/20 下午2:32*/
@Data
@JsonIgnoreProperties(ignoreUnknown = true)
public class WeChatVO {/*** 用户授权唯一标识*/private String openid;/*** 用户授权的access_token*/private String access_token;/*** access_token接口调用凭证超时时间,单位(秒)*/private Long expires_in;/*** 用户昵称*/private String nickname;/*** 用户头像*/private String headimgurl;/*** 用户刷新access_token  30天有效*/private String refresh_token;/*** 用户唯一标识,请注意,在未关注公众号时,用户访问公众号的网页,也会产生一个用户和公众号唯一的OpenID*/private String unionid;/*** 授权资料*/private String scope;
}

4.2 通用方法

/*** @author YuanJie* @date 2024/6/20 下午2:02*/
@RestController
@RequestMapping("/oauth2/wx")
@Slf4j
@ApiOperation(value = "oauth2", tags = "oauth2")
public class WXController extends BaseController {@Value("${oauth2.wx.appid}")private String appid;@Value("${oauth2.wx.appSecret}")private String appSecret;@Resourceprivate ThirdauthUserService thirdauthUserService;@Resourceprivate RestTemplate restTemplate;private final List<String> states = Collections.synchronizedList(new ArrayList<>());private final ObjectMapper objectMapper = new ObjectMapper();private final String WX_PREFIX = "wx";/*** 127.0.0.1:8080/oauth2/wx/code?backendUrl=http://xxxxo.com/oauth2/wx/callback** @param request* @param response* @param backendUrl* @throws IOException*/@ApiOperation("获取微信code")@GetMapping("/code")public void getWxCode(HttpServletRequest request,HttpServletResponse response,@RequestParam("backendUrl") String backendUrl) throws IOException {String state = UUID.randomUUID().toString().replace("-", "");this.states.add(state);// 回调地址直接填 下面的getCallback()方法。让微信直接回调下面的方法,这里回调地址必须加http https 前缀String url = "https://open.weixin.qq.com/connect/qrconnect?" +"appid=" + appid +"&redirect_uri=" + UriEncoder.encode(backendUrl) +"&response_type=code" +"&scope=snsapi_login" +"&state=" + state + "#wechat_redirect";response.sendRedirect(url);}/*** 供微信调用* 获取access_token** @param code*/@ApiOperation("获取access_token")@GetMapping("/callback")public AjaxResult getCallback(@RequestParam("code") String code, @RequestParam("state") String state) throws JsonProcessingException {// 校验stateif (!this.states.contains(state)) {return error();}this.states.remove(state);// 获取access_tokenString url = "https://api.weixin.qq.com/sns/oauth2/access_token?" +"appid=" + appid +"&secret=" + appSecret +"&code=" + code +"&grant_type=authorization_code";ResponseEntity<String> forEntity = restTemplate.getForEntity(url, String.class);WeChatVO weChatVO = objectMapper.readValue(forEntity.getBody(), WeChatVO.class);if (weChatVO == null) {return error("获取微信信息异常");}// 获取用户信息准备入库WeChatVO userInfo = setUserInfo(weChatVO.getAccess_token(), weChatVO.getRefresh_token(), weChatVO.getOpenid());log.info("当前微信用户信息:{}", objectMapper.writeValueAsString(weChatVO));// 返回tokenreturn success(userInfo);}/*** 请求用户信息** @param accessToken* @param refreshToken* @param openid*/private WeChatVO setUserInfo(String accessToken, String refreshToken, String openid) throws JsonProcessingException {// 校验token是否有效 并刷新tokenaccessToken = checkToken(accessToken, refreshToken, openid);// 请求用户信息String userInfo = "https://api.weixin.qq.com/sns/userinfo?" +"access_token=" + accessToken +"&openid=" + openid;ResponseEntity<String> forEntity = restTemplate.getForEntity(userInfo, String.class);WeChatVO weChatVO = objectMapper.readValue(forEntity.getBody(), WeChatVO.class);if (weChatVO == null) {throw new RuntimeException("获取微信信息异常");}weChatVO.setAccess_token(accessToken);weChatVO.setRefresh_token(refreshToken);// 保存到数据库ThirdauthUser thirdauthUser = new ThirdauthUser();thirdauthUser.setPlatform(WX_PREFIX);thirdauthUser.setAvator(weChatVO.getHeadimgurl());BeanUtils.copyProperties(weChatVO, thirdauthUser);thirdauthUserService.saveOrUpdate(thirdauthUser,Wrappers.lambdaQuery(ThirdauthUser.class).eq(ThirdauthUser::getOpenid, weChatVO.getOpenid()).eq(ThirdauthUser::getPlatform, WX_PREFIX));return weChatVO;}/*** 校验token是否有效 并返回刷新的token** @param accessToken* @param refreshToken* @param openid*/private String checkToken(String accessToken, String refreshToken, String openid) throws JsonProcessingException {String checkToken = "https://api.weixin.qq.com/sns/auth?" +"access_token=" + accessToken +"&openid=" + openid;ResponseEntity<String> forEntity = restTemplate.getForEntity(checkToken, String.class);String body = forEntity.getBody();Map map = objectMapper.readValue(body, Map.class);if (map.get("errcode").equals(0)) {return refreshToken(refreshToken);}throw new RuntimeException("token失效,请重新登录");}/*** 刷新token 若refreshToken失效,则重新登录** @param refreshToken* @return*/private String refreshToken(String refreshToken) throws JsonProcessingException {String url = "https://api.weixin.qq.com/sns/oauth2/refresh_token?" +"appid=" + appid +"&grant_type=refresh_token" +"&refresh_token=" + refreshToken;ResponseEntity<String> forEntity = restTemplate.getForEntity(url, String.class);WeChatVO weChatVO = objectMapper.readValue(forEntity.getBody(), WeChatVO.class);if (weChatVO == null) {throw new RuntimeException("刷新token失败,refreshToken已过期,请重新登录");}return weChatVO.getAccess_token();}

在这里插入图片描述

这篇关于封装通用第三方平台用户表(微信开放平台)的文章就介绍到这儿,希望我们推荐的文章对编程师们有所帮助!



http://www.chinasem.cn/article/1094110

相关文章

使用Java实现通用树形结构构建工具类

《使用Java实现通用树形结构构建工具类》这篇文章主要为大家详细介绍了如何使用Java实现通用树形结构构建工具类,文中的示例代码讲解详细,感兴趣的小伙伴可以跟随小编一起学习一下... 目录完整代码一、设计思想与核心功能二、核心实现原理1. 数据结构准备阶段2. 循环依赖检测算法3. 树形结构构建4. 搜索子

mysql删除无用用户的方法实现

《mysql删除无用用户的方法实现》本文主要介绍了mysql删除无用用户的方法实现,文中通过示例代码介绍的非常详细,对大家的学习或者工作具有一定的参考学习价值,需要的朋友们下面随着小编来一起学习学习吧... 1、删除不用的账户(1) 查看当前已存在账户mysql> select user,host,pa

Java导入、导出excel用法步骤保姆级教程(附封装好的工具类)

《Java导入、导出excel用法步骤保姆级教程(附封装好的工具类)》:本文主要介绍Java导入、导出excel的相关资料,讲解了使用Java和ApachePOI库将数据导出为Excel文件,包括... 目录前言一、引入Apache POI依赖二、用法&步骤2.1 创建Excel的元素2.3 样式和字体2.

JAVA封装多线程实现的方式及原理

《JAVA封装多线程实现的方式及原理》:本文主要介绍Java中封装多线程的原理和常见方式,通过封装可以简化多线程的使用,提高安全性,并增强代码的可维护性和可扩展性,需要的朋友可以参考下... 目录前言一、封装的目标二、常见的封装方式及原理总结前言在 Java 中,封装多线程的原理主要围绕着将多线程相关的操

如何用java对接微信小程序下单后的发货接口

《如何用java对接微信小程序下单后的发货接口》:本文主要介绍在微信小程序后台实现发货通知的步骤,包括获取Access_token、使用RestTemplate调用发货接口、处理AccessTok... 目录配置参数 调用代码获取Access_token调用发货的接口类注意点总结配置参数 首先需要获取Ac

Java覆盖第三方jar包中的某一个类的实现方法

《Java覆盖第三方jar包中的某一个类的实现方法》在我们日常的开发中,经常需要使用第三方的jar包,有时候我们会发现第三方的jar包中的某一个类有问题,或者我们需要定制化修改其中的逻辑,那么应该如何... 目录一、需求描述二、示例描述三、操作步骤四、验证结果五、实现原理一、需求描述需求描述如下:需要在

TP-Link PDDNS服将于务6月30日正式停运:用户需转向第三方DDNS服务

《TP-LinkPDDNS服将于务6月30日正式停运:用户需转向第三方DDNS服务》近期,路由器制造巨头普联(TP-Link)在用户群体中引发了一系列重要变动,上个月,公司发出了一则通知,明确要求所... 路由器厂商普联(TP-Link)上个月发布公告要求所有用户必须完成实名认证后才能继续使用普联提供的 D

C++实现封装的顺序表的操作与实践

《C++实现封装的顺序表的操作与实践》在程序设计中,顺序表是一种常见的线性数据结构,通常用于存储具有固定顺序的元素,与链表不同,顺序表中的元素是连续存储的,因此访问速度较快,但插入和删除操作的效率可能... 目录一、顺序表的基本概念二、顺序表类的设计1. 顺序表类的成员变量2. 构造函数和析构函数三、顺序表

Go语言利用泛型封装常见的Map操作

《Go语言利用泛型封装常见的Map操作》Go语言在1.18版本中引入了泛型,这是Go语言发展的一个重要里程碑,它极大地增强了语言的表达能力和灵活性,本文将通过泛型实现封装常见的Map操作,感... 目录什么是泛型泛型解决了什么问题Go泛型基于泛型的常见Map操作代码合集总结什么是泛型泛型是一种编程范式,允

Oracle数据库如何切换登录用户(system和sys)

《Oracle数据库如何切换登录用户(system和sys)》文章介绍了如何使用SQL*Plus工具登录Oracle数据库的system用户,包括打开登录入口、输入用户名和口令、以及切换到sys用户的... 目录打开登录入口登录system用户总结打开登录入口win+R打开运行对话框,输php入:sqlp