设计一个需要用户量的网站时，用户功能模块是非常重要的，该文章介绍用户登录注册模块的开发。

知识点概况：

  • 用户注册与登录
  • cookie和session
  • 继承swagger2 api
  • 分类设计与实现
  • 首页商品推荐
  • 商品详情与评论渲染
  • 购物车与订单
  • 微信与支付宝支付

1.用户注册登录流程分类

image.png

1.1.邮箱注册登录

image.png

1.2.手机号注册登录

image.png

2.用户注册-判断用户名存在

正常的开发流程是从低至上，顺序为pojo、mapper、service、controller

2.1 mapper

mapper是自动生成得代码，目前业务逻辑相对简单，不需要自定义功能，代码如下：

  1. package mapper;
  3. import com.architects.my.mapper.MyMapper;
  4. import com.architects.pojo.Users;
  6. public interface UsersMapper extends MyMapper<Users> {
  7. }

2.2 service

image.png

  • UserService ```java package com.architects.service;

/**

  • @ClassName UserService
  • @Description:
  • @Author ning.chai@foxmail.com
  • @Date 2021/2/19 0019

  • @Version V1.0 **/ public interface UserService {

    boolean queryUsername(String username);

}

  2. - userServiceImpl
  3. ```java
  4. package com.architects.service.impl;
  6. import com.architects.mapper.UsersMapper;
  7. import com.architects.pojo.Users;
  8. import com.architects.service.UserService;
  9. import org.springframework.beans.factory.annotation.Autowired;
  10. import org.springframework.stereotype.Service;
  11. import tk.mybatis.mapper.entity.Example;
  13. /**
  14.  * @ClassName userServiceImpl
  15.  * @Description:
  16.  * @Author ning.chai@foxmail.com
  17.  * @Date 2021/2/19 0019
  18.  * @Version V1.0
  19.  **/
  20. @Service
  21. public class UserServiceImpl implements UserService {
  23.     @Autowired
  24.     private UsersMapper usersMapper;
  27.     @Override
  28.     public boolean queryUsername(String username) {
  29.         Example example = new Example(Users.class);
  30.         Example.Criteria criteria = example.createCriteria();
  31.         criteria.andEqualTo("username", username);
  33.         Users result = usersMapper.selectOneByExample(example);
  35.         return result == null ? false : true;
  36.     }
  37. }

2.3 controller

  1. package com.architects.service.impl;
  3. import com.architects.mapper.UsersMapper;
  4. import com.architects.pojo.Users;
  5. import com.architects.service.UserService;
  6. import org.springframework.beans.factory.annotation.Autowired;
  7. import org.springframework.stereotype.Service;
  8. import tk.mybatis.mapper.entity.Example;
  10. /**
  11.  * @ClassName userServiceImpl
  12.  * @Description:
  13.  * @Author ning.chai@foxmail.com
  14.  * @Date 2021/2/19 0019
  15.  * @Version V1.0
  16.  **/
  17. @Service
  18. public class UserServiceImpl implements UserService {
  20.     @Autowired
  21.     private UsersMapper usersMapper;
  24.     @Override
  25.     public boolean queryUsername(String username) {
  26.         Example example = new Example(Users.class);
  27.         Example.Criteria criteria = example.createCriteria();
  28.         criteria.andEqualTo("username", username);
  30.         Users result = usersMapper.selectOneByExample(example);
  32.         return result == null ? false : true;
  33.     }
  34. }

3.自定义数据结构

一般页面的数据返回格式，会带有status、msg、data，例如天猫登录接口返回的格式如下：
image.png

此时我们需要一个响应工具类

JSONVO

  1. package com.architects.utils;
  3. import com.fasterxml.jackson.annotation.JsonIgnore;
  5. /**
  6.  * 本类可提供给H5/ios/安卓/公众号/小程序使用
  7.  * 前端接受此类数据（json object）后，可自行根据业务去实现相关功能
  8.  *
  9.  * 200：表示成功
  10.  * 500：表示错误，错误信息在msg字段中
  11.  * 501：bean验证错误，不管多少个错误都以map形式返回
  12.  * 502：拦截器拦截到用户token出错
  13.  * 555：异常抛出信息
  14.  * 556：用户qq校验异常
  15.  */
  16. public final class JSONVO {
  18.     // 定义jackson对象
  19. //    private static final ObjectMapper MAPPER = new ObjectMapper();
  21.     // 响应业务状态
  22.     private Integer status;
  24.     // 响应消息
  25.     private String msg;
  27.     // 响应中的数据
  28.     private Object data;
  30.     @JsonIgnore
  31.     private String ok;    // 不使用
  33.     public static JSONVO build(Integer status, String msg, Object data) {
  34.         return new JSONVO(status, msg, data);
  35.     }
  37.     public static JSONVO build(Integer status, String msg, Object data, String ok) {
  38.         return new JSONVO(status, msg, data, ok);
  39.     }
  41.     public static JSONVO ok(Object data) {
  42.         return new JSONVO(data);
  43.     }
  45.     public static JSONVO ok() {
  46.         return new JSONVO(null);
  47.     }
  49.     public static JSONVO errorMsg(String msg) {
  50.         return new JSONVO(500, msg, null);
  51.     }
  53.     public static JSONVO errorMap(Object data) {
  54.         return new JSONVO(501, "error", data);
  55.     }
  57.     public static JSONVO errorTokenMsg(String msg) {
  58.         return new JSONVO(502, msg, null);
  59.     }
  61.     public static JSONVO errorException(String msg) {
  62.         return new JSONVO(555, msg, null);
  63.     }
  65.     public static JSONVO errorUserQQ(String msg) {
  66.         return new JSONVO(556, msg, null);
  67.     }
  69.     public JSONVO() {
  71.     }
  73.     private JSONVO(Integer status, String msg, Object data) {
  74.         this.status = status;
  75.         this.msg = msg;
  76.         this.data = data;
  77.     }
  79.     private JSONVO(Integer status, String msg, Object data, String ok) {
  80.         this.status = status;
  81.         this.msg = msg;
  82.         this.data = data;
  83.         this.ok = ok;
  84.     }
  86.     private JSONVO(Object data) {
  87.         this.status = 200;
  88.         this.msg = "OK";
  89.         this.data = data;
  90.     }
  92.     public Boolean isOK() {
  93.         return this.status == 200;
  94.     }
  96.     public Integer getStatus() {
  97.         return status;
  98.     }
  100.     public void setStatus(Integer status) {
  101.         this.status = status;
  102.     }
  104.     public String getMsg() {
  105.         return msg;
  106.     }
  108.     public void setMsg(String msg) {
  109.         this.msg = msg;
  110.     }
  112.     public Object getData() {
  113.         return data;
  114.     }
  116.     public void setData(Object data) {
  117.         this.data = data;
  118.     }
  120.     public String getOk() {
  121.         return ok;
  122.     }
  124.     public void setOk(String ok) {
  125.         this.ok = ok;
  126.     }
  127. }

改造原有的controller代码

  1. package com.architects.controller;
  3. import com.architects.service.UserService;
  4. import com.architects.utils.JSONVO;
  5. import org.apache.commons.lang3.StringUtils;
  6. import org.springframework.beans.factory.annotation.Autowired;
  7. import org.springframework.web.bind.annotation.GetMapping;
  8. import org.springframework.web.bind.annotation.RequestMapping;
  9. import org.springframework.web.bind.annotation.RequestParam;
  10. import org.springframework.web.bind.annotation.RestController;
  12. /**
  13.  * @ClassName PassportController
  14.  * @Description:
  15.  * @Author ning.chai@foxmail.com
  16.  * @Date 2021/2/19 0019
  17.  * @Version V1.0
  18.  **/
  19. @RestController
  20. @RequestMapping("passport")
  21. public class PassportController {
  23.     @Autowired
  24.     private UserService userService;
  27.     @GetMapping("/usernameIsExist")
  28.     public JSONVO usernameIsExist(@RequestParam String username){
  30.         if (StringUtils.isBlank(username)) {
  31.             return JSONVO.errorMsg("用户名不能为空");
  32.         }
  36.         boolean isExist = userService.queryUsername(username);
  38.         if (isExist) {
  39.             return JSONVO.errorMsg("用户名已存在");
  40.         }
  42.         return JSONVO.ok();
  43.     }
  44. }

请求结果

image.png

4. 用户注册-创建service