【ShareBook】1-后台框架与小程序用户登录接口实战
本博客 猫叔的博客 ，转载请申明出处
阅读本文约 “5分钟”
适读人群：Java后端、Java初级、小程序前端
前后端项目的地址
- ShareBookServer
- ShareBookClient
小程序前端
先看一下本节的学习目录，我们项目的小程序会在首次登录的时候自动获取用户的 OpenId ，并作为系统的注册信息，这里只是获取其OpenId或者SessionId，还 没有获取用户信息 （比如头像、Id、性别等）。
而在获取前，大家可能还要了解一下小程序的 用户注册流程 ，这里我就不具体说了。
我们会在app.js（这个是所有小程序 首次都会执行的js ，我们会对小程序的 缓存区Storage 进行校验，并确定是否存在有效token），做校验，如果没有就进行 首次注册 。
注册流程是从小程序（简称vx，以下vx替代）获取用户的code，给到服务器，服务器会用code还有自己的appId等信息一起去微信服务器请求用户数据，注意每一个vx所对应的用户 openid都是不一样 的。
config.js是存放整个vx的 统一基层API地址 。
就如上图写的，前端在第一节的内容较为简单，大家可以在GitHub看到源码。
针对适读人群的合理学习时间是： 45分钟，并了解vx官网部分简易API 。
Java服务端
本节的服务端是重点，除了搭建整个SpringBoot基本开发框架以外（好像不用很久）还要准备一些基本的 公关类和工具类 ，这个大家学习起来可能有点费劲，不过干货很多。
首先是技术栈，SpringBoot+MySQL+MyBatis，这个我就不具体说怎么搭建了，详情看源码，或者我的 官网 也有搭建教程。
在pom文件中，我引入了Swagger，这会方便我们与前端对接API的信息，你仅需要在启动类加上一个 @EnableSwagger2的注解 即可。
访问： http://localhost:8080/sharebook/swagger-ui.html （注意我的application-dev.yml中给项目起了名字叫sharebook，如果你是 其他名字 ，请修改）
需要介绍的是，大家可以看看resources文件夹我采用application.yml、application-dev.yml，这样可以方便我们快速切换 开发、生产、测试等多种环境的项目配置 ，希望大家可以养成习惯。
在项目的实体类上，我采用Lombok快速生成get/set方法，你仅需要加一个@Data的注解，这里你需要注意还要加 无参和全参的构造函数 ，例如我一开始没有全参的构造，在读取生成User实体类的时候，MyBatis会报 java.lang.NoSuchMethodException 。
同时实体类需要序列号，我这里就采用默认的Serializable，对实体类序列化是因为它可能需要进行 网络通信或者数据持久化 。对于加了Serializable的实体类，最好有一个对应的UID。
因为我是用IDEA（推荐使用），所有如果要 生成UID ，可以在配置勾选以上的 选项 ，然后点击实体类按“Alt+Enter”，然后选择生成UID即可。
common & util
对于AppMessage，大家可能会吐槽，因为其实可以优化，不过我从ssm迁移过来就偷懒了，大家可以fork后自己改为SpringBoot的yml配置形式，它其实就是一些 静态配置 。
HttpService写的不好，大家可以修改优化，是一个普通的 Http请求工具类 。
主要是ResponseCode和ServerCache，对API接口返回层做了 统一处理 ，vx前端程序员可以更好的 调试工作 ，推荐大家模仿优化。
TokenCache使用了Google的guava做了本地缓存， 缓存vx登录的token ，一定要设定有效时间。
其实util包和common包一开始拆分的不好，所以大家可以优化。
MD5Util就是一个MD5的加解密处理。
业务处理
就如上面vx环节说的，我们API获取到code后会进行校验处理。
我在接口实现使用了很古老的方式，代码是很久以前的了，见谅，介绍流程为主。大家可以去修改优化。
我对从微信服务器获取到的结果进行校验和数据获取，得到的 openid先到数据库校验，用户是否存在，存在就生成Token，不存在就注册后生成Token 。流程很简单。
补充以下，vx的API路径我推荐： http://localhost :8080/sharebook/api/v1/
这里采用v1命名。是因为后续升级后v2，这样有时可以 保证老版本API可以继续使用或者停用 。
针对适读人群的合理学习时间是： 115分钟，推荐自己模仿敲一遍 。
实战调试
vx首次登录调用成功。
vx缓存区Storage存储token数据
后端服务器日志打印正常。
SQL数据录入正常，这里sessionId为null是正常的，项目业务没有要求存储sessionId，注意对于在统一公众号下的不同小程序的openid是不同的，但是sessionId是一致的（不知道近期vx官方是否更改规则）。
目录链接
- 没有实战经验？从零敲一个企业级共享项目前后端！
公众号：Java猫说
学习交流群：728698035
现架构设计（码农）兼创业技术顾问，不羁平庸，热爱开源，杂谈程序人生与不定期干货。
正文到此结束
- 本文标签： 时间 src spring 服务端 IDE mybatis 前端程序员 源码 架构设计 sql 代码 client 目录 希望 js 数据 HTML message 测试 token cat GitHub 企业 mysql IO https zab 调试 程序员 博客 服务器 springboot 数据库 Google 开源 cache git 缓存 UI App http java id 创业 API 开发 Service pom session 配置
- 版权声明： 本文为互联网转载文章，出处已在文章中说明(部分除外)。如果侵权，请联系本站长删除，谢谢。
- 本文海报： 生成海报一 生成海报二
热门推荐
相关文章
近期评论
-
5分钟 注册下载 登录 提一个问题，就可以找博主领取5块红包了，很简单
-
-
-
来看看，最近更新了一波，顺着友联过来的，几年过去了，网站越搞越好，厉害
-
哥太牛了
-
是呀，看您的IP显示在美国，还以为您移民了
-
-
-
-
Loading...
![[HBLOG]公众号](https://www.liuhaihua.cn/img/qrcode_gzh.jpg)
