一、项目结构

0、前言

阿昌之前的文章《阿昌手摸手教你如何在服务器部署若依前后端分离版项目》中，我们部署了若依的项目在线上；

这次我们先使用本地去学习若依项目，阿昌也在学习这个开源项目，想做自己学习的文章分享，一方面记录督促自己学习，另一方分享知识给广大编程好友们！！！

1、项目的结构

我们拿到一个开源项目要如何入手去去学习呢？

总不能直接对着源码猛读！！！

观察项目结构，会发现若依的项目是多模块开发，就是ruoyi-admin为主入门，引入别的模块的坐标
- 好处：
  - 便于项目的管理
  - 降低代码耦合
  - 有利于多人协同开发
  - 项目每个模块功能明确
  - …………

我们观察最主要的ruoyi-admin模块，会发现里面只有controller。没有别的代码层。那他们去哪里了呢？

不断摸索看了看发现，若依把别的层都写在了ruoyi-system模块里面
- domain
- mapper
- service

观察ruoyi-common模块
发现里面如模块名一样，都是一些公共的
- 配置类【config】
- 注解【annotation】
- 实体类【constant】
- 核心基类【core】
  - 公共基类
  - redis工具
  - 文本工具
  - 分页工具
  - …..等
- 枚举类【enums】
- 异常【exception】
- 过滤器【filter】
- 工具包【utils】

在看ruoyi-framework模块，里面有一些
- 切面【数据过滤处理、多数据源、日志记录】
- 配置类【各种组件的配置类，如：redis、MyBatis、线程池等..】
- 数据源【动态数据源、数据源切换】
- 拦截器
- 管理【异步工厂、异步任务器、关闭管理等…提升用户体验】
- 安全【这里阿昌下的是springsecurity的整合版本】
- web

再往下看，ruoyi-generator代码生成模块
- 主要的一些对应的模板类

ruoyi-quartz定时任务模块

阿昌发现了一个好的方法，就是看主模块的xml文件，若依作者写的很详细里面引入的坐标模块，也就知道对应这个模块的作用是什么了

二、登录功能实现

今天就记录一下若依的登录功能实现的学习

首先启动前端npm run dev

再启动页面按F12，打开调试面板，再到Network网络请求部分，再刷新页面，看他发了什么网络请求

我们看到了他发了三个请求，右侧可看详细请求地址，于是我们先看login这个请求

发现他请求了/login请求接口，于是我们就去后台去寻找/login这个接口的controller
阿昌这里分享一个快速找这个接口的方法，右击模块-Find inPath，再输入/login，就能快速找到对应的接口位置

接口的详细

我们先看看他接受前端发来的登录实体类里面的属性是什么

public class LoginBody
{
    /**
     * 用户名
     */
    private String username;

    /**
     * 用户密码
     */
    private String password;

    /**
     * 验证码
     */
    private String code;

    /**
     * 唯一标识
     */
    private String uuid = "";
	
    .............//省略get/set()方法
}

发现他有用到验证码和uuid
然后我们打断点，输入账号密码验证码发个请求看看

阿昌发现一个问题，在实体类中没有定义uuid，为什么他就生成了uuid的值，看样子是随机生成的

想到之前有验证码的请求，于是我们去看看验证码的请求

通过上面同样的方法快速定位到/captchaImage 接口的位置

@RestController
public class CaptchaController
{
    @Resource(name = "captchaProducer")
    private Producer captchaProducer;

    @Resource(name = "captchaProducerMath")
    private Producer captchaProducerMath;

    @Autowired
    private RedisCache redisCache;
    
    // 验证码类型
    @Value("${ruoyi.captchaType}")
    private String captchaType;

    /**
     * 生成验证码
     */
    @GetMapping("/captchaImage")
    public AjaxResult getCode(HttpServletResponse response) throws IOException
    {
        // 保存验证码信息
        String uuid = IdUtils.simpleUUID();
        String verifyKey = Constants.CAPTCHA_CODE_KEY + uuid;

        String capStr = null, code = null;
        BufferedImage image = null;

        // 生成验证码
        if ("math".equals(captchaType))
        {
            String capText = captchaProducerMath.createText();
            capStr = capText.substring(0, capText.lastIndexOf("@"));
            code = capText.substring(capText.lastIndexOf("@") + 1);
            image = captchaProducerMath.createImage(capStr);
        }
        else if ("char".equals(captchaType))
        {
            capStr = code = captchaProducer.createText();
            image = captchaProducer.createImage(capStr);
        }

        redisCache.setCacheObject(verifyKey, code, Constants.CAPTCHA_EXPIRATION, TimeUnit.MINUTES);
        // 转换流信息写出
        FastByteArrayOutputStream os = new FastByteArrayOutputStream();
        try
        {
            ImageIO.write(image, "jpg", os);
        }
        catch (IOException e)
        {
            return AjaxResult.error(e.getMessage());
        }

        AjaxResult ajax = AjaxResult.success();
        ajax.put("uuid", uuid);
        ajax.put("img", Base64.encode(os.toByteArray()));
        return ajax;
    }
}