当前位置：首页>后端>正文

在若依微服务里构建自己的项目若依项目讲解

后端2024-04-28 23:04:49

若依开源项目

若依地址
若依官方网址

一、项目结构

0、前言

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

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

1、项目的结构

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

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

观察项目结构，会发现若依的项目是多模块开发，就是ruoyi-admin为主入门，引入别的模块的坐标

好处：

便于项目的管理
降低代码耦合
有利于多人协同开发
项目每个模块功能明确
…

在若依微服务里构建自己的项目若依项目讲解,在若依微服务里构建自己的项目若依项目讲解_token,第1张

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

在若依微服务里构建自己的项目若依项目讲解,在若依微服务里构建自己的项目若依项目讲解_token_02,第2张

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

domain
mapper
service

在若依微服务里构建自己的项目若依项目讲解,在若依微服务里构建自己的项目若依项目讲解_若依_03,第3张

观察ruoyi-common模块
发现里面如模块名一样，都是一些公共的

配置类【config】
注解【annotation】
实体类【constant】
核心基类【core】

公共基类
redis工具
文本工具
分页工具
…等

枚举类【enums】
异常【exception】
过滤器【filter】
工具包【utils】

在若依微服务里构建自己的项目若依项目讲解,在若依微服务里构建自己的项目若依项目讲解_若依_04,第4张

在看ruoyi-framework模块，里面有一些

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

在若依微服务里构建自己的项目若依项目讲解,在若依微服务里构建自己的项目若依项目讲解_token_05,第5张

再往下看，ruoyi-generator代码生成模块

主要的一些对应的模板类

在若依微服务里构建自己的项目若依项目讲解,在若依微服务里构建自己的项目若依项目讲解_登录实现_06,第6张

ruoyi-quartz定时任务模块

在若依微服务里构建自己的项目若依项目讲解,在若依微服务里构建自己的项目若依项目讲解_若依_07,第7张

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

在若依微服务里构建自己的项目若依项目讲解,在若依微服务里构建自己的项目若依项目讲解_登录实现_08,第8张

二、登录功能实现

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

首先启动前端npm run dev

在若依微服务里构建自己的项目若依项目讲解,在若依微服务里构建自己的项目若依项目讲解_若依_09,第9张

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

在若依微服务里构建自己的项目若依项目讲解,在若依微服务里构建自己的项目若依项目讲解_java_10,第10张

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

在若依微服务里构建自己的项目若依项目讲解,在若依微服务里构建自己的项目若依项目讲解_在若依微服务里构建自己的项目_11,第11张

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

在若依微服务里构建自己的项目若依项目讲解,在若依微服务里构建自己的项目若依项目讲解_token_12,第12张

在若依微服务里构建自己的项目若依项目讲解,在若依微服务里构建自己的项目若依项目讲解_java_13,第13张

接口的详细

在若依微服务里构建自己的项目若依项目讲解,在若依微服务里构建自己的项目若依项目讲解_登录实现_14,第14张

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

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

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

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

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

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

在若依微服务里构建自己的项目若依项目讲解,在若依微服务里构建自己的项目若依项目讲解_登录实现_15,第15张

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

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

在若依微服务里构建自己的项目若依项目讲解,在若依微服务里构建自己的项目若依项目讲解_java_16,第16张

通过上面同样的方法快速定位到/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;
    }
}