【ShareBook】1-后台框架与小程序用户登录接口实战
【ShareBook】1-后台框架与小程序用户登录接口实战
前后端项目的地址
小程序前端
先看一下本节的学习目录，我们项目的小程序会在首次登录的时候自动获取用户的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官方是否更改规则）。
