SpringBoot中各个层级结构详解

提示：文章写完后，目录可以自动生成，如何生成可参考右边的帮助文档

文章目录

前言

在SpringBoot项目中，常常会把代码文件放入不同的包中，例如pojo，dao，service，controller等，但各个层级的代码是如何联系起来的呢，又会在项目中起到怎样的作用呢

提示：以下是本篇文章正文内容，下面案例可供参考

一、各个常用层级简述

1.POJO层

POJO在springboot项目中的定位，类似于mvc项目里的model模型层。
POJO（Plain Ordinary Java Object）简单的Java对象，实际就是普通JavaBeans，其中包含多个的属性，同时具备get/set方法，推荐直接使用@lombok注解。
POJO不会在其中编写逻辑方法，而且
与数据库表一一对应，属性也需与数据库表的字段保持一致。

2.DAO层

DAO层用来存放mapper接口，mapper作用为访问数据库，向数据库发送sql语句，完成数据的增删改查功能，通常将其实现为接口，内部声明的方法将会于mapper层中的对应数据库函数关联

其有两种编写方式
（1）继承 BaseMapper，BaseMapper 接口是 MyBatis Plus 提供的通用 Mapper 接口，用于执行常用的 CRUD 操作，包括插入、更新、删除和查询等操作，继承该接口后，能够自动获得数据库常用操作的方法，而不用在mapper内编写

publicinterfaceUserMapperextendsBaseMapper<User>{}

（2）通过终端调用命令mvn mybatis-generator:generate
需要安装maven和调用mybatis相关依赖，在使用该命令时，会检索generatorConfig.xml文件，并根据其中配置，自动生成DAO层，以及pojo和mapper层的基本文件。
注：需求可通过更改xml配置修改，也可生成后再新编写逻辑方法

<?xml version="1.0" encoding="UTF-8"?><!DOCTYPEgeneratorConfigurationPUBLIC"-//mybatis.org//DTD MyBatis Generator Configuration 1.0//EN""http://mybatis.org/dtd/mybatis-generator-config_1_0.dtd"><generatorConfiguration><classPathEntrylocation="E:\software\IDEA\mysql-connector-java-8.0.27.jar"/><contextid="DB2Tables"targetRuntime="MyBatis3"><plugintype="org.mybatis.generator.plugins.UnmergeableXmlMappersPlugin"/><commentGenerator><propertyname="suppressAllComments"value="true"/></commentGenerator><jdbcConnectiondriverClass="com.mysql.cj.jdbc.Driver"connectionURL="jdbc:mysql://localhost:3306/mall?characterEncoding=utf-8&amp;useSSL=false&amp;serverTimezone=GMT%2b8"userId="root"password="root"><!--MySQL 8.x 需要指定服务器的时区--><propertyname="serverTimezone"value="UTC"/><!--MySQL 不支持 schema 或者 catalog 所以需要添加这个--><!--参考 : http://www.mybatis.org/generator/usage/mysql.html--><propertyname="nullCatalogMeansCurrent"value="true"/><!-- MySQL8默认启用 SSL ,不关闭会有警告--><propertyname="useSSL"value="false"/></jdbcConnection><javaTypeResolver><propertyname="forceBigDecimals"value="false"/></javaTypeResolver><javaModelGeneratortargetPackage="com.imooc.mall.pojo"targetProject="src/main/java"><propertyname="enableSubPackages"value="true"/><propertyname="trimStrings"value="true"/></javaModelGenerator><sqlMapGeneratortargetPackage="mappers"targetProject="src/main/resources"><propertyname="enableSubPackages"value="true"/></sqlMapGenerator><javaClientGeneratortype="XMLMAPPER"targetPackage="com.imooc.mall.dao"targetProject="src/main/java"><propertyname="enableSubPackages"value="true"/></javaClientGenerator><tabletableName="数据库表名"domainObjectName="想要生成的pojo类名"enableSelectByExample="false"enableCountByExample="false"enableDeleteByExample="false"enableUpdateByExample="false"/></context></generatorConfiguration>

3.SERVICE层

业务逻辑层，完成功能的设计 和dao层一样都是先设计接口，再创建要实现的类，然后在配置文件中进行配置其实现的关联。
service的impl是把mapper和service进行整合的文件 封装Service层的业务逻辑有利于业务逻辑的独立性和重复利用性。
基本功能为：

1. 处理业务逻辑：业务逻辑是处理数据、计算等复杂操作的过程，Service层是业务逻辑的核心，负责编写和实现业务逻辑。
2. 组织DAO（Data Access Object）层：数据访问对象是用来访问数据库等数据存储的代码层，Service层通常会调用DAO层的方法来处理数据。
3. 实现事务控制：在Service层中实现事务控制，确保操作数据库的过程中数据的一致性和完整性。
4. 封装业务对象：Service层会封装业务逻辑需要的数据，并将其传递给DAO层进行存储或操作，这样做可以提高代码的可读性和可维护性，以及规范数据的操作。

注意：在service的实现类上要加注解@Service，否则会出现无法扫描识别

4.CONTROLLER层

控制层，控制业务逻辑service，控制请求和响应，负责前后端交互
controller层主要调用Service层里面的接口控制具体的业务流程，不会在其中编写大量逻辑代码，同时也会接受并处理一些HTTP参数，例如session

注意：在CONTROLLER的实现类上也要加注解@RestController

5.mapper层

存放数据库函数，与DAO层中的方法映射，可通过终端命令生成，也可自行编写（工作量较大），在调用DAO方法则会实际执行mapper层对应的数据库方法，是对数据库curd的接口桥梁，同时也需要增加mapper扫描以完成识别

二、其余包/层级

1.ENUM 枚举包

在真正项目编写中，通常会遇到根据不同情况设定不同返回值，而直接大量设置int不仅会存在安全漏洞，也会出现阅读及理解上的困难，所以通过枚举可以很好的解决这些问题

@GetterpublicenumProductStatusEnum{ON_SALE(1),OFF_SALE(2),DELETE(3),;Integer code;ProductStatusEnum(Integer code){this.code = code;}}

其中@Getter注解不可缺少，因为需要取枚举值，也就是取code时，需要调用其提供的getCode()方法

2.VO 返回对象包

由于springboot项目一般采用前后端分离，不同层不同方法返回给前端的数据的格式有时会与POJO中的属性不完全一致，可能增多也可能缺少，于是直接构建一个用于构造返回对象的包，根据需求出发，与前端所需数据类型保持完全一致。
VO类的结构完全类似于POJO类，同样存放一定量的属性+lombok注解(@Data)即可

3.EXCEPTION 报错包

由于项目中的一些报错并不是逻辑性报错，在正常运行项目中可能会存在不危险的报错，并需要对其按报错类型做不同处理
通过@ExceptionHandler(RuntimeException.class)注解，更改括号内的报错类名，捕捉不同的报错，并编写对应的报错处理方法。

4.FORM 表单包

有时在项目中对传入的数据对象的参数进行校验，通过对其添加 注解 即可
注解包为javax.validation.constraints，需要引入依赖
@Null 被注解的元素必须为null
@NotNull 被注解的元素必须不为null
@AssertTrue 被注解的元素必须为true
@AssertFalse 被注解的元素必须为false
@Min(value) 被注解的元素必须为数字，其值必须大于等于最小值
@Max(value) 被注解的元素必须为数字，其值必须小于等于最小值
@Size(max,min) 被注解的元素的大小必须在指定范围内
@Past 被注解的元素必须为过去的一个时间
@Future 被注解的元素必须为未来的一个时间
@Pattern 被注解的元素必须符合指定的正则表达式

5.拦截器

拦截器的主要是基于Java的反射机制，属于面向切面编程(AOP)的一种运用，就是在Service或者一个方法前调用一个方法，或者在方法后调用一个方法，甚至在抛出异常的时候做业务逻辑的操作。

拦截器的作用类似于Servlet 中的Filter，都可以用于对处理器进行预处理和后处理。在Spring MVC 与Spring Boot 中使用拦截器一般是实现HandlerInterceptor 接口

该接口有三个方法
（1）preHandle()：这个方法可以实现处理器的预处理，也就是它会在handler 方法执行之前就开始执行。当返回值是true 时表示继续执行，返回false 时则不会执行后续的拦截器或处理器。作用：身份验证，身份授权等。
（2）postHandle()：这个方法是后处理回调方法，也就是在控制器完成后(试图渲染之前)执行。作用：将公用的模型数据传到视图，也可以在这里统一指定视图(菜单导航等)。
（3）afterCompletion()：这个方法是请求处理完毕后的回调方法，即在视图渲染完毕时调用。作用：进行统一的异常处理，日志处理等。

实现接口后对需要的方法进行重写，编写项目所对应的拦截器逻辑代码。但有时候部分链接需要对外部开放，而不能被拦截器所拦截，例如登录接口，注册接口等，需要另外编写一个类 实现 WebMvcConfigurer接口

@ConfigurationpublicclassIntercepterConfigimplementsWebMvcConfigurer{@OverridepublicvoidaddInterceptors(InterceptorRegistry registry){
        registry.addInterceptor(newUserLoginIntercepter()).addPathPatterns("/**").excludePathPatterns("/error","/user/login","/user/register");}}

addInterceptor：需要一个实现HandlerInterceptor接口的拦截器实例
addPathPatterns：用于设置拦截器的过滤路径规则；addPathPatterns(“/**”)对所有请求都拦截
excludePathPatterns：用于设置不需要拦截的过滤规则（白名单）
注意 @Configuration注解不可省略，不然拦截器可能配置无效

此处只讲解 WebMvcConfigurer接口在拦截器的运用，它还有很多其他的功能，想了解的可以看看这篇博客
https://blog.csdn.net/weixin_45433031/article/details/121846207

三、各个层级之间的联系与作用

三层架构

从基础的三层架构开始说起吧，三层架构由 Dao 层，Service层，Controller层组成,在这个三层架构之中,Dao层负责与mybatis和数据库打交道,实现对持久化数据的访问，隔离业务逻辑代码和数据访问代码，隔离不同数据库的实现。

而Service则是负责编写业务逻辑的一个层,一般Service层由接口和实现类构成,存在大量业务方法，以供Controller层的调用。在SpringBoot项目中，编写业务逻辑时，常常会声明一个由@Autowired 注释的XXXmapper对象，该对象为Dao层接口的实现类，以供其调用。

Controller，控制器层，controller层的功能为请求和响应控制。
Controller层负责前后端交互，接受前端请求，调用service层，接收service层返回的数据，最后返回具体的页面和数据到客户端。请注意:部分返回数据队格式和数量都有所要求,要注意前端需求并构建响应的Vo对象返回为佳

数据持久化：将数据存入数据库中，将数据库中的数据读取出来的过程，称之为持久，持久化是将程序中的数据在瞬时状态和持久状态间转换的机制