【项目技术介绍篇】若依项目代码文件结构介绍

作者介绍：本人笔名姑苏老陈，从事JAVA开发工作十多年了，带过大学刚毕业的实习生，也带过技术团队。最近有个朋友的表弟，马上要大学毕业了，想从事JAVA开发工作，但不知道从何处入手。于是，产生了写一个博客专栏想法，介绍当前互联网企业JAVA项目开发如何快速入门。

本文收录于《30天企业JAVA项目开发实战入门》专栏，该专栏内容以当前互联网软件企业中的项目实战为线索，介绍企业JAVA项目开发中涉及到的开发流程、技术、工具、规范要求等等。帮助想从事JAVA开发的大学生或新人，更快的、更好的入门JAVA后端开发工作。

一、前言

由于本专栏项目实战学习，是以若依开源项目RuoYi-Cloud为示例。所以，本文介绍一下若依开源项目RuoYi-Cloud中若依管理后台系统的代码文件结构，以管理后台系统中的岗位管理模块为示例。

• 若依项目RuoYi-Cloud简介
  若依项目RuoYi-Cloud 是一个 Java EE 企业级的开源免费的快速开发平台，是一个基于Spring Boot、Spring Cloud & Alibaba的微服务的权限管理系统。如果想快速的开发一个Java EE 企业级项目，可以在若依项目的基础上，开发定制自己的项目。尤其是如果要开发一个后台管理系统，由于若依开源项目中已经内置完整的权限管理模块，所以能够更加快速的完成项目的开发工作；

• 若依项目RuoYi-Cloud技术选型
  采用前后端分离的模式，微服务版本前端基于 Vue/Element UI ；
  ​ 后端采用Spring Boot、Spring Cloud & Alibaba微服务架构；
  ​ 注册中心、配置中心选型Nacos，权限认证使用Redis；
  ​ 流量控制框架选型Sentinel，分布式事务选型Seata；

• 若依项目官方网站和文档地址
  若依官网地址：https://www.ruoyi.vip/
  若依演示地址：https://vue.ruoyi.vip/login
  技术文档地址：https://doc.ruoyi.vip/ruoyi-cloud/
  代码下载地址：https://gitee.com/y_project/RuoYi-Cloud

二、代码文件结构介绍

• 在若依项目RuoYi-Cloud中，编写一个简单的功能模块，需要编写哪些代码文件呢？

百度网盘代码下载地址：https://pan.baidu.com/s/10FyzBDDB1HHng7LUW3Rkkw?pwd=n8ci
提取码：n8ci

这里以岗位管理模块开发为示例，编写一个完整的岗位管理模块，大概包括前端页面部分、后端接口部分、数据库表结构部分以及菜单配置部分等四个部分的内容。

如下图所示：

（1）前端页面部分

• index.vue：岗位管理模块view文件，用于控制页面布局展示等等，比如页面上输入框、按钮、列表、文本框等等组件，如何排列展示；各种组件点击后如何交互等等；

• post.js：岗位管理模块请求文件，用于跟后端服务器发送数据请求等等，比如页面上点击搜索按钮后，给后端服务器发送请求，获取数据等等；

（2）后端接口部分

• SysPostController.java：岗位管理模块controller控制层文件；

• ISysPostService.java：岗位管理模块service业务层接口定义文件；

• SysPostServiceImpl.java：岗位管理模块service业务层接口实现文件；

• SysPostMapper.java：岗位管理模块dao数据持久层接口定义文件；

• SysPostMapper.xml：岗位管理模块dao数据持久层接口实现文件；

• SysPost.java：岗位管理模块pojo实体类文件；

后端包括哪三层架构，调用关系是什么样的？

后端接口主要是包括controller层、service层和dao层，是应用程序中常见的三层架构；它们之间的调用关系如下：

controller层，作为控制层，负责接收用户请求并将请求传递给service层，之后将处理完成的结果返回给客户端。

service层，作为业务层，位于controller层和dao层之间，负责业务处理。它根据业务需求调用dao层进行数据操作，并封装了一系列的操作以及对外提供业务功能的调用接口。service层的设计旨在封装业务逻辑，提高代码的复用性和可维护性。

dao层。作为数据持久层，位于最底层，负责与数据库进行交互，提供对数据的持久化操作。dao层定义了用于数据访问的接口或类，通常使用的数据访问技术MyBatis等来简化数据库操作。

总的来说，这三层之间的关系和调用顺序反映了应用程序的设计原则，即保持代码的清晰、可维护和可扩展。通过依赖注入和配置的方式，这三层在框架中形成了一个清晰的层次结构，实现了数据访问、业务逻辑处理和请求响应的协同工作。

除了三层架构之后，另外，还包括pojo（Plain Ordinary Java Object）实体类文件，可以理解为简单的实体类，主要用于定义与数据库对象应的属性，方便操作数据库中的数据表；

（3）数据库表结构部分

• sys_post.sql：岗位管理模块建表脚本，用于在数据库中，创建对应的数据表，存储和管理用户界面上收集的数据；

（4）菜单配置部分

• postMenu.sql：岗位管理模块配置菜单脚本，用于生成若依管理后台系统中左侧的菜单信息。配置完成后，我们可以在若依管理后台系统中左侧的菜单栏中，找到岗位管理菜单。

三、总结

以上，介绍了若依开源项目RuoYi-Cloud中若依管理后台系统的代码文件结构。另外，对三层架构以及它们之间的调用关系，也做了简单的介绍。

如果您对文章中内容有疑问，欢迎在评论区进行留言，我会尽量抽时间给您回复。如果文章对您有帮助，欢迎点赞、收藏。您的点赞，是对我最大的支持和鼓励，谢谢 :-）