国外营销网站,联通套餐,网站的站点地图设计,sem运营是什么意思本文所涉及的代码以及相关文件均上传至仓库:GitHub - yang66-hash/XDPropertyManagementSystemDemo: This is a demo template based on SpringBoot3 in the background of property management system. Spring Boot 是由 Pivotal 团队开发的一款开源框架#xff0c;它可以帮助… 本文所涉及的代码以及相关文件均上传至仓库:GitHub - yang66-hash/XDPropertyManagementSystemDemo: This is a demo template based on SpringBoot3 in the background of property management system. Spring Boot 是由 Pivotal 团队开发的一款开源框架它可以帮助开发者快速搭建一个基于Spring框架的Java应用程序。
目录
一、为什么要用Spring Boot框架
二、系统需求
2.1 现阶段的Spring Boot各版本官方支持力度
2.2 最新Spring Boot 3.3.4系统要求
2.3 使用Java 8 参考的系统要求
2.4 本文基于的系统基本信息
三、如何IDEA快速搭建一个Spring Boot3 项目
3.1使用搭建网址进行搭建
3.2 使用IDEA直接搭建
3.2.1 project的创建
3.2.2 Maven相关设置
3.2.3 运行项目
3.2.4 切换服务器URL
3.3 通过Maven工程使用Spring Boot框架
3.3.1 创建maven项目
3.3.2 在pom中添加项目的父工程以及相关依赖 3.3.3 编写Spring Boot启动类
3.3.4 编写配置文件application.properties 3.3.5 运行启动类
四、Spring Boot项目结构介绍
4.1 运行日志以及banner的介绍
4.2 Profiles
4.2.1 为什么要有Profiles
4.2.2 配置文件的加载顺序
4.3 Starters
4.3.1 starters基础概念
4.3.2 starter原理
4.4 Spring Boot分层规约
4.5 返回数据的统一封装 4.5.1 构建返回结果的枚举类
4.5.2 构建返回结果的封装类
4.6 日志框架的应用
4.6.1 java常见日志框架的介绍
4.6.2 Spring Boot3 项目日志框架的选取
Logback基础概念
Logback的xml配置
Slf4j简化log代码
使用log4j2日志框架
五、Spring Boot MybatisPlus MYSQL搭建入门管理系统
5.1 用例分析与数据库设计
5.2 创建Spring Boot项目 引入pom依赖
5.3 搭建基础的项目结构
5.4 修改配置文件
5.5 使用MybatisPlus
5.5.1创建数据库对应的实体类
5.5.2 创建mapper层接口
5.5.3 创建service层接口以及具体实现类
5.5.4 controller层创建UserController类
5.5.5 单表分页查询的实现
5.5.6 整合Knife4j 测试编写的API接口
参考文档 一、为什么要用Spring Boot框架
展开来主要可以包括以下几个方面
简化繁琐配置Spring Boot遵守“约定大于配置”原则减少了开发者在使用Spring时需要进行的繁琐配置大量XML的文件配置。同时针对复杂的依赖引入也进行简化解决依赖版本错选导致的一系列版本不兼容问题。提高开发效率Spring Boot内置了多种常用的功能和依赖使得开发者可以快速构建和部署应用如内嵌的Tomcat服务器包含于spring-boot-starter-web依赖包中、热部署spring-boot-devtools依赖等大大提高了开发效率。它还支持各种开发工具和集成开发环境如IntelliJ IDEA、Eclipse等使开发者能够更加便捷地开发、调试和测试应用程序。易于部署Spring Boot 提供了自动配置的打包和部署功能开发者可以直接将应用程序打包成可执行的 JAR 文件而无需手动配置和部署环境。这大大简化了部署过程提高了开发效率。易于集成Spring Boot与其他开源框架和技术无缝集成如Spring MVC、MyBatis、Hibernate等可以快速搭建具有高度可扩展性和灵活性的应用程序。此外Spring Boot还支持各种数据库、消息队列、缓存等技术的集成且集成接入方式轻松无需繁琐配置如使用spring-boot-starter-*。微服务架构支持Spring Boot非常适合构建微服务架构。它提供了强大的特性如自动化的服务注册与发现、配置中心、负载均衡等可以快速构建和部署分布式系统。同时Spring Boot与Spring Cloud等技术栈无缝集成提供了全面的微服务解决方案。 总的来说是为了解决Spring原生框架存在的繁琐配置以及复杂的依赖版本管理简化开发过程提高开发效率。 二、系统需求
2.1 现阶段的Spring Boot各版本官方支持力度
查看文档Spring Boot
2.2 最新Spring Boot 3.3.4系统要求 Java 17(兼容Java 22).Spring Framework6.1.13.Maven 3.6.3
2.3 使用Java 8 参考的系统要求
使用Java 8的用户需要使用2.x版本的Spring Framework框架。
需要主要的是Spring Boot 最后一个 2.x 的版本 2.7.x 已经在2023年停止维护了3.0.x 也停止维护了商业支持的版本现存2.6.x 2.5.x 以下的版本彻底退出历史舞台。
参考2.7.18的官方文档系统需求如下 Java 8(兼容Java 21).Spring Framework5.3.31.Maven 3.6.3
在windows上部署Maven以及相应Java可以参考Windows安装并配置Java JDK 以及Maven的详细教程_安装jdk和maven-CSDN博客不同版本的Maven、JDK安装流程相同关键环境变量别配置错误
2.4 本文基于的系统基本信息
在Windows10上进行开发各类框架、软件工具的版本如下
Spring Boot 3.0.0Java 17Intellij IDEA 2024.2Maven 3.6.3
Intellij IDEA的版本与Java JDK也有其对应关系要支持JDK 17至少需要2021.2版本。
注可参考Intellij IDEA官方文档project configuration - SDKs - Supported Java Versions and featuresSupported Java versions and features | IntelliJ IDEA Documentation
不满足版本要求的IDEA可能会报错如下 三、如何IDEA快速搭建一个Spring Boot3 项目
参考官网Developing Your First Spring Boot Application :: Spring Boot
3.1使用搭建网址进行搭建
利用官方提供的Spring Boot搭建网址进行快速搭建https://start.spring.io/ 若是无法访问或者网络延时较长可以使用阿里云提供的手脚架平台https://start.aliyun.com 在生成项目之前可以选择添加部分依赖如开发Web application那我们就可以添加Spring web依赖。再点击EXPLORE按钮能够进行预览。 最后将压缩包下载下来用本地开发工具打开即可。
3.2 使用IDEA直接搭建
3.2.1 project的创建 这里的各部分介绍和3.1节中的相同。 3.2.2 Maven相关设置
创建之后需要进行部分设置的调整。主要是设置Maven仓库相关的配置保证IDEA使用的Maven是我们安装的Maven 关闭项目打开IDEA初始界面进入全局设置 进行maven相关设置 点击apply或者ok保存设置。
之后打开的project就均进行了自己安装的maven相关设置如果后期开发发现某个project的maven相关问题如IDEA又恢复了默认maven可以File - Settings 进入设置界面搜索Maven进行设置设置过程和上述相同。只不过这是针对该project的单一设置而不是上述的全局设置。也可以选择重新进行全局的设置。
3.2.3 运行项目
加载完成后右键点击运行程序入口类SpringbootdemoApplication。 控制台显示如下 这便是只包含spring-boot-starter-web依赖的Spring Boot初始项目运行结果。
3.2.4 切换服务器URL
若是https://start.spring.io无法连接Spring Boot项目创建时间巨长可以将服务器切换为国内阿里云URL。操作如下 3.3 通过Maven工程使用Spring Boot框架
3.1以及3.2的方式如是不切换阿里云的地址国内访问Spring Boot相关网址是不稳定的导致项目创建失败。我们可以使用Maven手动进行Spring Boot项目搭建。
3.3.1 创建maven项目 3.3.2 在pom中添加项目的父工程以及相关依赖 !--spring-boot-starter-parent是Spring Boot的官方父POM提供了一个基础的项目结构和默认配置。管理 Spring Boot 相关的依赖和插件的版本使得开发者可以更轻松地构建 Spring Boot 应用程序。避免了不同依赖的手动引入版本可能会导致的版本冲突问题--parentgroupIdorg.springframework.boot/groupIdartifactIdspring-boot-starter-parent/artifactIdversion3.3.4/version/parent!-- 引入依赖 web用于开发基础的web application test用于测试--dependenciesdependencygroupIdorg.springframework.boot/groupIdartifactIdspring-boot-starter-web/artifactId/dependencydependencygroupIdorg.springframework.boot/groupIdartifactIdspring-boot-starter-test/artifactIdscopetest/scope/dependency/dependencies!-- 插件 --buildpluginsplugingroupIdorg.springframework.boot/groupIdartifactIdspring-boot-maven-plugin/artifactId/plugin/plugins/build3.3.3 编写Spring Boot启动类 代码
import org.springframework.boot.SpringApplication;
import org.springframework.boot.autoconfigure.SpringBootApplication;SpringBootApplication
public class SpringBootDemoApplication {public static void main(String[] args) {SpringApplication.run(SpringBootDemoApplication.class, args);}
}3.3.4 编写配置文件application.properties 代码
#端口号
server.port8080spring.application.namespringbootmavendemo 3.3.5 运行启动类 程序虽然跑起来了但是入门程序只是到这还是远远不够的。相关的项目结构的基础介绍还有待展开。接下来将展开介绍Spring Boot的各个基础部分以及Spring Boot如何配置MYSQL数据库,Redis数据库以及相关的ORM框架实现真正的Spring Web项目的入门。
四、Spring Boot项目结构介绍
4.1 运行日志以及banner的介绍 ①部分叫做banner支持用户的自定义。可以自己设置开启还是关闭支持自定义图案。
例如要关闭这一部分 ②日志输出相关介绍 各部分输出介绍
日期和时间毫秒精度便于排序日志级别ERROR、WARN、INFO、DEBUG 或 TRACE。进程 ID。--- 分隔符标志实际日志消息的开始。应用程序名称用方括号括起来仅在设置了 spring.application.name 时默认记录线程名称用方括号括起来在控制台输出时可能会截断日志记录器名称通常是源类名通常是缩写日志消息
在6与7之间如果启用了追踪还会有关联 ID在上述示例中未显示。
4.2 Profiles
在Spring Framework中Profile的概念就存在了。Spring Boot对Profiles功能进行了进一步的扩展使其成为了Spring Boot的特性之一。
4.2.1 为什么要有Profiles
在日常开发过程中经常需要根据不同的环境对配置文件进行不同的修改。如在本地进行开发时我们会添加一些适应本地环境的配置以及开发环境下的数据库在测试服务器上测试时需要添加适应此环境的配置以及测试环境下的数据库当项目部署到生产环境下需要设置生产环境下的配置以及数据库。即针对不同环境部署需要调整不同的配置维护过程十分繁琐且容易出错。
为了解决上述的问题Spring Profiles提供了针对特定的环境加载特定的程序配置即一种环境对应一个Profile的解决方案。只有当前Profile处于激活状态才会将该Profile所对应的配置以及Bean加载到程序中。
4.2.2 配置文件的加载顺序
配置文件加载顺序 官方说明Spring Boot项目打成jar包后可以读取jar内部的配置文件也可读取jar外部的配置文件虽然开发用的少。同时官方也建议整个项目中只使用一种形式的文件后缀。
Jar 包内部的 application.properties或者application.yamlJar 包内部的 application-{profile}.properties或者application-{profile}.yamlJar 包外部的 application.properties或者application.yamlJar 包外部的 application--{profile}.properties或者application-{profile}.yaml
profile一般分为dev(开发环境 development)、 test(测试环境)、prod(生产环境 production)即相相应环境的简称。
后面加载的配置文件会覆盖之前加载的配置文件中相同的配置信息。profile文件的激活一般需要在主配置文件即1.加载顺序的配置文件中声明如下属性键值对
spring.profiles.activedev 或者通过系统参数、环境变量的形式加载
#方法一 参数设置 -Dspring.profiles.active
java -jar -Dspring.profiles.activedev xxx.jar
#方法二 或使用系统环境变量(linux) windows也可设置如下系统环境变量
export SPRING_PROFILES_ACTIVEdev
java -jar xxx.jar Spring Boot自动寻找并加载配置文件的位置 启动时Spring Boot会自动寻找并加载以下位置的application.properties 和application.yaml文件: 从classpath ①classpath root - resource ②classpath /config - resource/config 从当前目录项目根目录 ①当前目录 ②当前目录下的/config子目录 ③/config子目录的直接子目录
这也时由上至下先后加载后面的配置信息会覆盖前面加在的相同配置信息。 4.3 Starters
4.3.1 starters基础概念
starter是一组预定义的依赖项集合旨在简化Maven等构建工具的依赖管理。Starter使得Spring Boot在配置上相比spring要简单许多, 其核心在于spring-boot-starter, 在使用spring boot来搭建一个项目时, 只需要引入官方提供的starter, 就可以直接使用, 免去了各种配置。简单来讲就是starter引入了一些相关依赖和一些初始化配置。开发者能够更专注于业务逻辑的实现而无需花费大量时间在繁琐的配置和依赖管理上。
Spring官方提供了很多starter第三方也可以定义starter。为了加以区分starter从名称上进行了如下规范
Spring官方提供的starter名称为spring-boot-starter-xxx 例如Spring官方提供的spring-boot-starter-web第三方提供的starter名称为xxx-spring-boot-starter 例如由mybatis提供的mybatis-spring-boot-starter
一些常用官方Spring Boot Starter包括
spring-boot-starterSpring Boot的核心启动器包含了自动配置、日志和YAML等基础设施spring-boot-starter-web用于构建Web应用程序提供了Spring MVC和嵌入式Tomcat等Web技术spring-boot-starter-data-jpa用于简化Spring Data JPA的配置和使用提供了与关系型数据库交互的能力spring-boot-starter-test用于单元测试和集成测试包含了JUnit、Mockito等测试框架和库spring-boot-starter-security用于提供应用程序的安全性包括身份验证、授权等功能
更多的starter参考 Build Systems :: Spring Boot
4.3.2 starter原理
Spring Boot之所以能够帮我们简化项目的搭建和开发过程主要是基于它提供的起步依赖和自动配置。起步依赖将具备某种功能的坐标打包到一起可以简化依赖导入的过程。例如上面初始程序导入的spring-boot-starter-web这个starter其中web开发相关的jar包都一起导入到项目中了。 自动配置即Spring Boot 无须像Spring一般手动配置xml自动配置并管理bean可以简化开发过程。对具体实现逻辑感兴趣的可以参考知乎文章https://zhuanlan.zhihu.com/p/602453889#:~:textspring%20b
4.4 Spring Boot分层规约 开放接口层可直接封装 Service 方法暴露成 RPC 接口通过 Web 封装成 http 接口等进行网关安全控制、流量控制等。终端显示层各个端的模板渲染并执行显示的层。当前主要是 velocity 渲染JS 渲染JSP 渲染移动端展示等。Web 层主要是对访问控制进行转发各类基本参数校验或者不复用的业务简单处理等。controllerService 层相对具体的业务逻辑服务层。service层 Manager 层通用业务处理层它有如下特征: 1) 对第三方平台封装的层预处理返回结果及转化异常信息。 2) 对 Service 层通用能力的下沉如缓存方案、中间件通用处理。 3) 与 DAO 层交互对多个 DAO 的组合复用。 DAO 层:数据访问层与底层 MySQL、Oracle、Hbase、OB 等进行数据交互。外部接口或第三方平台:包括其它部门 RPC 开放接口基础平台其它公司的 HTTP 接口。
给出一个较为完整的SpringBoot项目的分层结构 .
├── java
│ └── com
│ └── yang
│ ├── MainApplication.java
│ ├── config
│ │ └── xxxConfig.java
│ ├── consts
│ │ └── xxxConstant.java
│ ├── controller
│ │ └── UserController.java
│ ├── manager
│ │ └── UserManager.java
│ ├── mapper
│ │ └── UserMapper.java
│ ├── pojo
│ │ ├── bo
│ │ │ └── xxxBO.java
│ │ ├── dto
│ │ │ └── xxxDTO.java
│ │ └── po
│ │ └── xxxPO.java
│ ├── service
│ │ ├── IUserService.java
│ │ └── impl
│ │ └── UserService.java
│ └── util
│ └── xxxUtil.java
└── resources
-----------------------------------------------├── mapper│ └── xxxMapper.xml
若是使用mybatis相关工具会有此类xml配置文件在MybatisPlus中针对单表的数据库持久层接口的编写不再需要此类xml配置文件
-----------------------------------------------├── static└── templates
-----------------------------------------------├── application.yml├── application-dev.yml├── application-test.yml├── application-prod.yml
配置文件
-----------------------------------------------├── logback.xml
Logback日志配置文件log4j2-spring.xmlLog4j日志框架配置文件
-----------------------------------------------因为项目的复杂性和需求各不相同许多项目可能不会严格遵循这些划分开发者应该根据实际情况进行调整。对于小型项目或原型可能会简化设计将多个角色合并到一个包中。在大型项目中遵循这些划分通常有助于提高代码的可维护性和可读性。
config各种相关的配置类所在。consts常量定义类所在。controller前端控制层 Controller。manager通用业务处理层 Manager。service具体的业务逻辑层接口 Service。service.impl具体业务逻辑实现层 ServiceImpl。util工具类目录。mapperMyBatis相关项目存储数据库持久层映射接口mapper。pojo包含PO/BO/VO/DTO等目录。
POJOPlain Ordinary Java Object是 DO/DTO/BO/VO 的统称POJO专指只有setter/getter/toString的简单类包括DO/DTO/BO/VO等但禁止命名成 xxxPOJO。
PO Persistant Object与数据库表结构一一对应。也有使用 DO Data Object代替的。DTO Data Transfer Object数据传输对象Service或Manager向外传输的对象即也是Controller中Request或Response所封装的对象。BO Business Object业务对象。可以理解成Java开发过程中抽象出来的一些与表结构无关的POJO可能包含一到多个DO。VO View Object展示对象它的作用是把某个指定页面或组件的所有数据封装起来。VO不常见因为和DTO太相似基本都用DTO替代。
本段摘自
https://segmentfault.com/a/1190000041363998
以及《阿里巴巴Java开发手册终极版》
在日常的小型项目开发中实体类的存储一般都放在以 entity | pojo | dao 可以粗略将三者理解为相似的命名的包下未做严格的具体划分。
4.5 返回数据的统一封装 Spring Boot开发返回前端的数据一般会进行统一数据封装其主要目的是提供一致的API响应格式便于前端开发和维护降低前后端交互的成本。 方便前端开发前端根据返回格式进行统一处理而不用关注具体的返回类型和内容。易于扩展可以方便地在统一封装的封装类中添加额外的字段状态码、具体信息等为前端提供更多的上下文信息。提高 API 可读性和可维护性统一结果封装可以使 API 的返回更加规范化使得代码更加易于阅读和维护。易于调试统一的响应格式便于日志记录和错误追踪
一般封装格式包含三部分内容
code状态码一般由后端统一返回结果的状态码message返回信息向前端传递处理结果的相关信息data携带的数据实际业务逻辑处理之后返回的数据 返回的信息至少会包含code、message、data三部分。除了这三部分外我们还可以自定义一些其他字段比如状态信息status请求时间timestamp。这就是返回结果做统一封装的好处——易于扩展。 那么我们前后端约定的状态码与HTTP的状态码有什么区别呢
HTTP 状态码
目的指示 HTTP 请求的处理结果。范围标准定义的三位数字状态码如 200、404、500 等。作用帮助客户端快速了解请求是否成功以及类型。
常见HTTP状态码
1xx信息性状态码表示接收的请求正在处理。2xx成功状态码表示请求正常处理完毕。3xx重定向状态码需要后续操作才能完成这一请求。4xx客户端错误状态码表示请求包含语法错误或无法完成。5xx服务器错误状态码服务器在处理请求的过程中发生了错误。
返回类的状态码
目的提供更具体的业务逻辑状态信息。定义通常是在 API 响应体中定义的状态码格式可以是任意整数如 1000、1001。作用帮助客户端更细致地处理不同的业务场景和错误类型。 总的来说HTTP 状态码指示请求的总体结果而自定义状态码提供更详细的上下文信息应与HTTP状态码错开。 4.5.1 构建返回结果的枚举类
Getter
public enum ResultEnum {SUCCESS(10000, Operation successful.),FAILURE(-1, Operation failed.),/* Parameter errors: 10001-19999 */PARAM_IS_INVALID(10001, Invalid parameter.),PARAM_IS_BLANK(10002, Parameter is empty.),PARAM_TYPE_BIND_ERROR(10003, Parameter format error.),PARAM_NOT_COMPLETE(10004, Missing parameter.),/* User-related errors: 20001-29999 */USER_NOT_LOGGED_IN(20001, User not logged in, please log in first.),USER_LOGIN_ERROR(20002, Account does not exist or password is incorrect.),USER_ACCOUNT_FORBIDDEN(20003, Account has been disabled.),USER_NOT_EXIST(20004, User does not exist.),USER_HAS_EXISTED(20005, User already exists.),/* System errors: 40001-49999 */FILE_MAX_SIZE_OVERFLOW(40003, Uploaded size exceeds the limit.),FILE_ACCEPT_NOT_SUPPORT(40004, Unsupported file format.),/* Data-related errors: 50001-59999 */RESULT_DATA_NONE(50001, Data not found.),DATA_IS_WRONG(50002, Data is incorrect.),DATA_ALREADY_EXISTED(50003, Data already exists.),AUTH_CODE_ERROR(50004, Verification code error.),/* Permission-related errors: 70001-79999 */PERMISSION_UNAUTHENTICATED(70001, This operation requires login.),PERMISSION_UNAUTHORIZED(70002, Insufficient permissions, unauthorized operation.),PERMISSION_EXPIRE(70003, Login status expired.),PERMISSION_TOKEN_EXPIRED(70004, Token has expired.),PERMISSION_LIMIT(70005, Access limit exceeded.),PERMISSION_TOKEN_INVALID(70006, Invalid token.),PERMISSION_SIGNATURE_ERROR(70007, Signature failed.);private final int code;private final String message;ResultEnum(int code, String message) {this.code code;this.message message;}
}以上的Enum类摘自Spring Boot3统一结果封装_springboot响应结果封装-CSDN博客 做了一定修改。
将属性定义为final保证其不可变性避免了运行时的意外修改。同时由于枚举实例的不可变性多个线程在使用这些状态码时不会出现数据竞争或一致性问题。删除 setter 方法简化了API设计减少了外部修改的可能性使得代码更加清晰和易于理解。
4.5.2 构建返回结果的封装类
package com.xingdian.pojo.dto;import com.xingdian.enums.ResponseStatusEnum;
import lombok.Data;import java.io.Serializable;Data
public class ResponseDTOT implements Serializable {private Integer code;private String msg;private T data;public ResponseDTO() {}public ResponseDTO(Integer code, String msg) {this.code code;this.msg msg;}public ResponseDTO(Integer code, T data) {this.code code;this.data data;}public ResponseDTO(Integer code, String msg, T data) {this.code code;this.msg msg;this.data data;}private ResponseDTO(ResponseStatusEnum resultStatus, T data) {this.code resultStatus.getCode();this.msg resultStatus.getMessage();this.data data;}/*** 执行成功返回描述和状态码*/public static ResponseDTOVoid success(){return new ResponseDTO(ResponseStatusEnum.SUCCESS, null);}/*** 执行成功返回描述、状态码、相关数据*/public static T ResponseDTOT success(T data){return new ResponseDTOT(ResponseStatusEnum.SUCCESS, data);}/*** 执行完成返回描述、状态码、相关数据*/public static T ResponseDTOT success(ResponseStatusEnum resultStatus, T data){if (resultStatus null){return success(data);}return new ResponseDTOT(resultStatus, data);}/*** 业务异常返回描述和状态码*/public static T ResponseDTOT failure() {return new ResponseDTOT(ResponseStatusEnum.FAILURE, null);}/*** 业务异常返回描述和状态码*/public static T ResponseDTOT failure(ResponseStatusEnum resultStatus) {return failure(resultStatus, null);}/*** 业务异常返回业务代码,描述和返回的参数*/public static T ResponseDTOT failure(ResponseStatusEnum resultStatus, T data) {if (resultStatus null) {return new ResponseDTOT(ResponseStatusEnum.FAILURE, null);}return new ResponseDTOT(resultStatus, data);}public static T ResponseDTOT failure(Integer code, String msg) {return new ResponseDTOT(code, msg);}}通过Result.success, Result.failure即可进行正常调用。具体示例可见第五节。
4.6 日志框架的应用
4.6.1 java常见日志框架的介绍 日志记录应用程序开发过程中的重要部分它虽然不涉及程序的业务逻辑核心部分但是它是帮助开发人员了解应用程序的运行状态、诊断问题并进行有效的错误跟踪的重要辅助。 在Java领域常见的日志框架有JUL、Log4j、Logback、log4j2。
JUL是java.util.logging包的简称是JDK在1.4版本中引入的Java原生日志框架。Java Logging API提供了七个日志级别用来控制输出。这七个级别分别是SEVERE、WARNING、INFO、CONFIG、FINE、FINER、FINEST。Log4j 是一种非常流行的日志框架由Ceki Gülcü首创之后将其开源贡献给 Apache 软件基金会。Log4j有八种标准日志级别OFF、FATAL、ERROR、WARN、INFO、DEBUG和TRACE、ALL。在log4j被Apache Foundation收入门下之后由于理念不合log4j的作者Ceki离开并开发了slf4j和logback。Logback也是一个很成熟的日志框架也是Spring Boot默认支持的日志框架。其分为六类标准日志级别TRACE、DEBUG、INFO、WARN、ERROR、FATAL。Log4j2 是 Log4j的升级版它比其前身Log4j提供了重要的改进并提供了Logback中可用的许多改进同时修复了Logback体系结构中的一些固有问题。可以认为Log4j2是Logback的加强版。
日志门面——Slf4j
Java简易日志门面Simple Logging Facade for Java缩写SLF4J是一套包装Logging 框架的界面程式以外观模式实现。可以在软件部署的时候决定要使用的 Logging 框架目前主要支持Java Logging API、Log4j及logback等框架。其作者是 Log4j 以及 Logback 的作者 Ceki Gülcü。
其实SLF4J只是一个门面服务而已他并不是真正的日志框架真正的日志的输出相关的实现还是要依赖其背后的日志实现Log4j2、logback等日志框架的。 具体的各类日志框架的信息、日志框架的比对以及日志门面的详细概念等本文不做介绍建议耐心看完以下文章本段介绍也是摘自这篇文章Java日志框架日志门面介绍_1、日志门面-CSDN博客 4.6.2 Spring Boot3 项目日志框架的选取 Spring Boot默认使用Slf4jLogback作为默认的日志门面和实现框架但也支持上述的其他日志框架。默认支持体现在当你创建一个添加了任何 starter 的 Spring Boot 应用程序时它们都依赖于spring-boot-starter而 spring-boot-starter 又依赖于 spring-boot-starter-logging 这就默认引入了Logback。 Logback基础概念
logback 继承自 log4j它建立在有十年工业经验的日志系统之上。它比其它所有的日志系统更快并且更小包含了许多独特并且有用的特性。目前logback 分为三个模块logback-corelogback-classic 和 logback-access。
① Logback 构建在三个主要类上
Logger(记录器可以理解为选日志类别)Appender(输出源可以理解为选日志要输出的地方)Layouts(布局可以理解为选日志以何种形式输出)
这三个不同类型的组件一起作用能够让开发者根据消息的类型以及日志的级别来打印日志。Appender类被看作为输出的目的地。其包括 consolefilesSyslogTCP SocketsJMS 等等其它的日志输出目的地。用户可以根据自己的情况轻松的创建自己的 Appender。如果发生了错误logback 会自动在控制台打印自己内部的状态信息。实际上在大型应用中日志记录不会有太大的区别。日志记录的一般形式不会有改变只是配置方式会有不同开发者可以按需求自行配置logback。
通过如下的三个步骤可以启用 logback 来记录日志
配置 logback 环境。Spring Boot项目中引入 spring-boot-starter-logging 依赖即可实现logback的配置而其又被包含在 spring-boot-starter 依赖中所以导入此依赖的项目就可直接使用logback日志框架。如果你想在每个类中打印日志那么你需要将当前类的全称(含包名)或者当前类(类.class)当作参数调用 org.slf4j.LoggerFactory.getLogger() 方法。使用实例 logger 来调用不同的方法来打印日志。例debug()info()warn()error()。通过这些方法将会在配置好的 appender 中输出日志。
② Logback定义了五个日志级别除去ALLOFF
Logger 能够被分成不同的等级。不同的等级TRACE, DEBUG, INFO, WARN, ERROR定义在 ch.qos.logback.classic.Level 类中。 低到高的层级顺序为TRACE、DEBUG、INFO、WARN、ERROR。比如当前Logger若是INFO级别那么更高顺序的日志也会打印但是DEBUG等顺序更低的日志就会无法打印即debug()会“失效”无法看到日志输出。在实际应用中应根据需要选择适当的日志级别。 对于一个给定的名为 L 的 logger它的有效层级为从自身一直回溯到 root logger直到找到第一个不为空的层级作为自己的层级。为了确保所有的 logger 都有一个层级root logger 会有一个默认层级 --- DEBUG。在Spring Boot中这似乎被spring-boot-3.3.4.jar下org.springframework.boot.logging.logback.base.xml默认设置为INFO。 Logback的xml配置
不引入logback.xml使用默认的Appender效果如下 设置自定义的logback.xml则会应用相应的日志效果。这里举例将日志信息输出到File中。
?xml version1.0 encodingUTF-8?
configuration!-- 引用Spring Boot 默认日志配置 --include resourceorg/springframework/boot/logging/logback/defaults.xml/!-- 日志文件输出位置 --property nameLOG_OUTPUT_PATH value./logs/!-- 日志文件名 --property nameLOG_OUTPUT_FILE value${LOG_OUTPUT_PATH}/xingdian-management-system.log/!-- 日志输出到文件 --appender nameFILE classch.qos.logback.core.rolling.RollingFileAppenderfilter classch.qos.logback.classic.filter.ThresholdFilterlevel${FILE_LOG_THRESHOLD}/level/filterencoderpattern${FILE_LOG_PATTERN}/patterncharset${FILE_LOG_CHARSET}/charset/encoder!-- 注释file属性 系统当天就会将日志内容直接写入 fileNamePattern文件格式的文件中 --!-- 设置file属性 系统会将日志内容全部写入file中设置的文件名的文件中 次日凌晨才会将前一天的日志文件用fileNamePattern中定义的命名当天的将一直是file属性名称--
!-- file${LOG_OUTPUT_FILE}/file--rollingPolicy classch.qos.logback.core.rolling.SizeAndTimeBasedRollingPolicy!--设置文件名称的名命名方式--fileNamePattern${LOGBACK_ROLLINGPOLICY_FILE_NAME_PATTERN:-${LOG_OUTPUT_FILE}.%d{yyyy-MM-dd}.%i.gz}/fileNamePatterncleanHistoryOnStart${LOGBACK_ROLLINGPOLICY_CLEAN_HISTORY_ON_START:-false}/cleanHistoryOnStartmaxFileSize${LOGBACK_ROLLINGPOLICY_MAX_FILE_SIZE:-8MB}/maxFileSizetotalSizeCap${LOGBACK_ROLLINGPOLICY_TOTAL_SIZE_CAP:-0}/totalSizeCapmaxHistory${LOGBACK_ROLLINGPOLICY_MAX_HISTORY:-10}/maxHistory/rollingPolicy/appender!-- 指定日志输出级别以及启动的Appender --root levelINFOappender-ref refFILE//root
/configurationSlf4j简化log代码
lombok库提供了一些注解来简化java代码其中针对默认的日志框架就提供了简化日志代码编写的注解Slf4j为被注解的类提供一个属性名为log的 org.slf4j.Logger 日志对象。
通过该注解Logger对象声明代码即可除去。当然这个注解需要引入lombok依赖 dependencygroupIdorg.projectlombok/groupIdartifactIdlombok/artifactIdversion1.18.30/version/dependency Logback框架的具体介绍以及深入了解Spring BootLogbackSlf4j可以参考中文文档 GitHub - YLongo/logback-chinese-manual: logback 中文手册/文档。 本段的部分代码以及介摘自此文档。
其他推荐文章重学SpringBoot3-日志Logging_springboot3日志配置-CSDN博客 使用log4j2日志框架
只需要在pom.xml依赖中移除 spring-boot-starter-logging依赖即可。 dependenciesdependencygroupIdorg.springframework.boot/groupIdartifactIdspring-boot-starter-web/artifactIdexclusionsexclusiongroupIdorg.springframework.boot/groupIdartifactIdspring-boot-starter-logging/artifactId/exclusion/exclusions/dependencydependencygroupIdorg.springframework.boot/groupIdartifactIdspring-boot-starter-log4j2/artifactId/dependency
前文已经讲过starter依赖的引入均会依赖于 spring-boot-starter而该依赖又依赖于spring-boot-starter-logging所以starter依赖都会默认引入logback相关的依赖。若是不放心spring-boot-starter-logging依赖未能完全移除可以通过依赖分析进行查看。 之后即可通过图中两种方式进行日志框架的使用方式与Logback相同。 也可以自定义配置文件进行使用下面将给出一个将日志同时输出到控制台以及日志文件中的配置文件 log4j2-spring.xml 示例。
?xml version1.0 encodingUTF-8?
Configuration statusWARNProperties
!-- 定义了格式化异常输出 --Property nameLOG_EXCEPTION_CONVERSION_WORD%xwEx/Property
!-- 设置日志级别的显示格式。%5p表示日志级别如 DEBUG、INFO、WARN 等将会占用 5 个字符的位置右对齐。如果级别名称长度小于 5则会用空格填充 --Property nameLOG_LEVEL_PATTERN%5p/Property
!-- 定义日志日期的格式 yyyy: 四位数年份 MM: 两位数月份 dd: 两位数日期 HH: 两位数小时 mm: 两位数分钟00-59SSS: 三位数毫秒000-999XXX: 时区偏移例如东八区08:00 --Property nameLOG_DATEFORMAT_PATTERNyyyy-MM-ddTHH:mm:ss.SSSXXX/Property
!-- 定义控制台输出日志的整体格式%clr{...}: 用于为输出内容添加颜色 如%clr{%d{${sys:LOG_DATEFORMAT_PATTERN}}}{faint} 将日期定义渲染为淡色在视觉上进行弱化与其他更重要的信息区分开来。%d{...}: 用于输出当前日期格式由 LOG_DATEFORMAT_PATTERN 定义%pid: 进程 ID[%15.15t]: %t当前线程名第一个15指定字段的总宽度为15个字符 后面的 .15 表示最多输出15个字符超过的部分会被截断 不足15补空格 默认右对齐想要左对齐使用负号- 如 %-15.15t%c{1.}: c表示日志记录器的类名 {1.}类名仅显示最后一个部分 其他的只取一个字符 如c.x.c.UserController%m: 日志消息%n: 换行符${sys:...}: 读取系统属性。 最后的${sys:LOG_EXCEPTION_CONVERSION_WORD} 表示如果有异常信息则使用 LOG_EXCEPTION_CONVERSION_WORD 定义的格式输出该异常信息 --Property nameCONSOLE_LOG_PATTERN%clr{%d{${sys:LOG_DATEFORMAT_PATTERN}}}{faint} %clr{${sys:LOG_LEVEL_PATTERN}} %clr{%pid}{magenta} %clr{---}{faint} %clr{${sys:LOGGED_APPLICATION_NAME:-}[%15.15t]}{faint} %clr{${sys:LOG_CORRELATION_PATTERN:-}}{faint}%clr{%-40.40c{2.}}{cyan} %clr{:}{faint} %m%n${sys:LOG_EXCEPTION_CONVERSION_WORD}/PropertyProperty nameFILE_LOG_PATTERN%d{${sys:LOG_DATEFORMAT_PATTERN}} ${sys:LOG_LEVEL_PATTERN} %pid --- ${sys:LOGGED_APPLICATION_NAME:-}[%t] ${sys:LOG_CORRELATION_PATTERN:-}%-40.40c{1.} : %m%n${sys:LOG_EXCEPTION_CONVERSION_WORD}/Property!-- 定义日志文件的路径以及名称 --property nameFILE_OUTPUT_PATH valuelogs-log4j/ /property nameFILE_NAME valuexindian-management-system //PropertiesAppenders
!-- 控制台实现和默认配置一样的日志格式输出--Console nameConsole targetSYSTEM_OUT followtruePatternLayout pattern${sys:CONSOLE_LOG_PATTERN} charset${sys:CONSOLE_LOG_CHARSET}/filters
!-- 接受CONSOLE_LOG_THRESHOLD以上级别的日志没找到该环境变量默认DEBUG以上--ThresholdFilter level${sys:CONSOLE_LOG_THRESHOLD:-DEBUG}//filters/Console
!-- 以filename命名当Polices被满足生成新的日志文件之前的将会被打包成filepattern中的.gz--RollingFile nameRollingFile fileName${FILE_OUTPUT_PATH}/${FILE_NAME}-info.log filePattern${FILE_OUTPUT_PATH}/${FILE_NAME}-INFO-%d{yyyy-MM-dd}.%i.gzPatternLayout pattern${FILE_LOG_PATTERN} charsetUTF-8/filtersThresholdFilter levelINFO//filtersPolicies!--interval属性用来指定多久滚动一次默认是1 hour--TimeBasedTriggeringPolicy interval24/!--size指定每个日志文件的最大大小默认值10MB--SizeBasedTriggeringPolicy size8MB//Policies!-- DefaultRolloverStrategy属性如不设置则默认为最多同一文件夹下7个文件开始覆盖--DefaultRolloverStrategy max7//RollingFile!--错误存储--RollingFile nameRollingFileError fileName${FILE_OUTPUT_PATH}/xindian-management-system-error.log filePattern${FILE_OUTPUT_PATH}/${FILE_NAME}-ERROR-%d{yyyy-MM-dd}.%i.gzPatternLayout pattern${FILE_LOG_PATTERN} charsetUTF-8/filtersThresholdFilter levelERROR//filtersPoliciesTimeBasedTriggeringPolicy interval72/SizeBasedTriggeringPolicy size8MB//PoliciesDefaultRolloverStrategy max7//RollingFile/AppendersLoggers
!-- 生产环境建议调整为INFO以避免生成过多的日志信息 测试调试时可设置为DEBUG--Root levelDEBUGAppenderRef refConsole /appender-ref refRollingFile/appender-ref refRollingFileError//Root/Loggers
/Configuration结果如下 log4j2推荐阅读入门文章
SpringBoot3整合日志框架教程附录Log4j2的常用标签大全_springboot3整合log4j2日志-CSDN博客
知乎 https://zhuanlan.zhihu.com/p/355103232 选择 Logback 还是 Log4j2 取决于具体的项目需求、性能要求和个人偏好。两者都具备强大的日志记录功能但在性能、架构和特性上有所不同。因为前者更为高效的异步日志处理机制通常建议在高并发和复杂需求的场景中考虑使用 Log4j2而在简单应用下使用Logback。 五、Spring Boot MybatisPlus MYSQL搭建入门管理系统
通过Spring Boot 3 | MybatisPlus | MYSQL打通后端API接口编写流程实现小区物业管理系统初始模板。
5.1 用例分析与数据库设计 一个基础的小区物业管理系统应该包含
楼宇管理几号楼住房管理几单元几层xxx停车位管理停车位售卖状态物业管理物业收费项目、物业各类收费项目抄表记录以及收费记录业主管理入住的业主信息投诉信息管理业主的投诉报修管理业主各类问题记录物业管理人员信息管理
所以依据上述的用例分析以及功能模块划分大致划分出以下11个表。 其中的连接符号表示外键如car_park表中的owner_user_id字段为user表中主键id的外键。
各个表的字段描述
admin car_park floor_unit_building:记录每号楼有几个单元每一个单元最多多少层 house:每个房屋的信息 property_charge_visit:各房屋使用收费项目的当月使用情况如电费 property_pay_visit物业收费记录表 user用户信息 user_complaint用户投诉信息 user_house_relation:住户和房屋的关系表 user_repair用户报修 接下来本文以user表作为示例进行相关增删改查接口的编程实现。
5.2 创建Spring Boot项目 引入pom依赖
通过Maven创建Spring Boot项目之后引入相应所需的依赖pom文件整体如下
?xml version1.0 encodingUTF-8?
project xmlnshttp://maven.apache.org/POM/4.0.0xmlns:xsihttp://www.w3.org/2001/XMLSchema-instancexsi:schemaLocationhttp://maven.apache.org/POM/4.0.0 http://maven.apache.org/xsd/maven-4.0.0.xsdmodelVersion4.0.0/modelVersiongroupIdcom.xingdian/groupIdartifactIdXDPropertyManagementSystem/artifactIdversion1.0-SNAPSHOT/versionpropertiesmaven.compiler.source17/maven.compiler.sourcemaven.compiler.target17/maven.compiler.targetproject.build.sourceEncodingUTF-8/project.build.sourceEncoding/properties!--spring-boot-starter-parent是Spring Boot的官方父POM提供了一个基础的项目结构和默认配置。管理 Spring Boot 相关的依赖和插件的版本使得开发者可以更轻松地构建 Spring Boot 应用程序。避免了不同依赖的手动引入版本可能会导致的版本冲突问题--parentgroupIdorg.springframework.boot/groupIdartifactIdspring-boot-starter-parent/artifactIdversion3.3.4/version/parent!-- 引入依赖 web用于开发基础的web application test用于测试--dependenciesdependencygroupIdorg.springframework.boot/groupIdartifactIdspring-boot-starter-web/artifactId/dependency!--注意 SpringBoot3的依赖与Spring Boot2的MybatisPlus并不相同 错用会报错--dependencygroupIdcom.baomidou/groupIdartifactIdmybatis-plus-spring-boot3-starter/artifactIdversion3.5.5/version/dependency!--mysql 一定要和数据库版本对应 本机为MYSQL5.7 所以mysql-connector-java选用5.1.x版本--dependencygroupIdmysql/groupIdartifactIdmysql-connector-java/artifactIdversion5.1.48/version/dependency!--lombok 用来简化实体类的编写减少相应类中基础方法的编写--dependencygroupIdorg.projectlombok/groupIdartifactIdlombok/artifactIdversion1.18.30/version/dependencydependencygroupIdorg.springframework.boot/groupIdartifactIdspring-boot-starter-test/artifactIdscopetest/scope/dependency/dependencies!-- 插件 --buildpluginsplugingroupIdorg.springframework.boot/groupIdartifactIdspring-boot-maven-plugin/artifactId/plugin/plugins/build
/project
5.3 搭建基础的项目结构
在启动类MainApplication同一级创建以下四个文件夹 一般Spring Boot开发遵循着此类项目结构不同的开发团队有着不同的开发规范与编程范式依据实际情况不同项目组可能会有出入但是大致的项目结构基本相同。
controller用于创建控制器类entity用于创建实体类对应数据库中的表mapper 用于创建持久层接口即数据库的增删改查操作接口service用于创建业务逻辑实现层实现业务逻辑逻辑代码的主要所在位置
5.4 修改配置文件
配置文件如下 5.5 使用MybatisPlus Spring Boot 以及 Mybatis相关项目编程常用注解可见以下文章 Spring Boot MyBatis 项目中常用注解详解万字长篇解读_1.简述mybatis的常用注解及其作用-CSDN博客 5.5.1创建数据库对应的实体类
以user表为示例进行以下讲解
package com.xingdian.entity;import com.baomidou.mybatisplus.annotation.TableName;
import lombok.Data;/*** lombok* Data 包含get set方法以及toString的默认实现* MybatisPlus* 默认情况下如果数据库表是使用标准的下划线命名且逻辑断点与类名逻辑断点一致那么MybatisPlus就能直接对应* 如 user_info(数据库) 与 UserInfo实体类就能直接对应 更多的表与类名的对应方式设置可以参考MybatisPlus官网* 也可以直接使用TableName注解对应*/
Data
TableName(value user)
public class User {/*** 属性的对应也遵顼下划线命名法与驼峰命名法之间的对应关系如数据库字段user_name 默认对应userName* 也可以直接使用TableId对应主键或者使用TableField实现属性对应* 自增主键*/private Integer id;/*** 姓名*/private String userName;/*** 用户电话*/private String phone;/*** 用户身份证ID*/private String cardId;/*** 性别*/private String sex;/*** 民族*/private String nation;/*** 户籍地址*/private String registerAddress;
}5.5.2 创建mapper层接口
在mapper包下创建操作user表的数据库接口
package com.xingdian.mapper;import com.baomidou.mybatisplus.core.mapper.BaseMapper;
import com.xingdian.entity.User;
import org.apache.ibatis.annotations.Mapper;Mapper
public interface UserMapper extends BaseMapperUser {
}虽然这个接口内部什么具体方法声明都没有但是其继承的BaseMapper的接口中包含了针对user表的增删改查的大量基础接口。
BaseMapper声明的接口方法 若是上述的基础接口无法满足SQL需求可以通过注解SQL的方式实现接口亦可以结合Wrapper等方式进行复杂的SQL构建。可参考文章Mybatis-Plus实现自定义SQL_mybatisplus自定义sql-CSDN博客
5.5.3 创建service层接口以及具体实现类
在service包下创建IUserService接口同时创建impl包在impl包下创建UserService并实现接口IUserService。相对于之前的Mapper层Iservice接口更加关注业务逻辑的实现如数据校验、逻辑处理等而不只是单纯的数据库操作。
在service包下创建IUserService接口
package com.xingdian.service;import com.baomidou.mybatisplus.extension.service.IService;
import com.xingdian.entity.User;import java.util.List;/*** 在其中定义具体要实现的方法的声明*/
public interface IUserService extends IServiceUser {ListUser getAllUsers();User getUserById(int id);}MybatisPlus框架同样提供了IserviceT接口定义了大量业务层基础方法如get 用于查询单行remove 用于删除list 用于查询集合page 用于分页查询能够实现数据的基础增删改查操作使得开发者免于基础CURD接口的无聊、机械的编码操作更加关注具体业务逻辑的处理。
在impl包下创建具体的业务层逻辑处理实现类
package com.xingdian.service.impl;import com.baomidou.mybatisplus.extension.service.impl.ServiceImpl;
import com.xingdian.entity.User;
import com.xingdian.mapper.UserMapper;
import com.xingdian.service.IUserService;
import org.springframework.beans.factory.annotation.Autowired;
import org.springframework.stereotype.Service;import java.util.List;Service
public class UserService extends ServiceImplUserMapper,User implements IUserService {Autowiredprivate UserMapper userMapper;Overridepublic ListUser getAllUsers() {return userMapper.selectList(null);}Overridepublic User getUserById(int id) {return userMapper.selectById(id);}}针对具体业务逻辑的处理MybatisPlus也提供了相关的ServiceImpl实现类能够实现针对一些简单CURD操作最初级的数据逻辑的处理。当然更为复杂的数据处理或者是涉及到具体的逻辑处理就需要开发者自己编程实现了。
5.5.4 controller层创建UserController类
在bean实例的注入方式上Spring Boot官方是推荐通过构造函数去实现注入当然通过注解AutoWired等注入也是可以的。
package com.xingdian.controller;import com.xingdian.entity.User;
import com.xingdian.service.impl.UserService;
import org.springframework.beans.factory.annotation.Autowired;
import org.springframework.web.bind.annotation.PostMapping;
import org.springframework.web.bind.annotation.RequestMapping;
import org.springframework.web.bind.annotation.RequestParam;
import org.springframework.web.bind.annotation.RestController;RestController
RequestMapping(user)
public class UserController {private final UserService userService;public UserController(UserService userService) {this.userService userService;}PostMapping(getUserById)public User getUserById(RequestParam int id) {return userService.getUserById(id);}
}这样针对user表相关数据进行接口编程的流程就算是走通了具体增删改查的处理就可以依据实际的情况依葫芦画瓢展开操作了。再次声明若是数据的处理涉及到大量的逻辑编程推荐是在Service层业务逻辑层即在impl包下的xxxService类中进行。
5.5.5 单表分页查询的实现
MybatisConfig配置文件添加MybatisPlusInterceptor代理对象并添加分页插件到该代理对象。
package com.xingdian.config;import com.baomidou.mybatisplus.extension.plugins.MybatisPlusInterceptor;
import com.baomidou.mybatisplus.extension.plugins.inner.PaginationInnerInterceptor;
import org.springframework.context.annotation.Bean;
import org.springframework.context.annotation.Configuration;Configuration
public class MybatisConfig {/*** 为MyBatis Plus插件创建一个MybatisPlusInterceptor代理对象* 并添加了分页插件PaginationInnerInterceptor到该代理对象中。这样在应用中* 只需要将MybatisPlusInterceptor对象注入到需要的地方就可以轻松地启用MyBatis Plus插件的分页功能。*/Beanpublic MybatisPlusInterceptor paginationInterceptor(){//新建MybatisPlus拦截器MybatisPlusInterceptor mybatisPlusInterceptor new MybatisPlusInterceptor();//新建分页拦截器paginationInnerInterceptorPaginationInnerInterceptor paginationInnerInterceptor new PaginationInnerInterceptor();//设置分页拦截器的一些属性paginationInnerInterceptor.setOverflow(true);paginationInnerInterceptor.setMaxLimit(100L);//把分页拦截器添加到MybatisPlus拦截器中mybatisPlusInterceptor.addInnerInterceptor(paginationInnerInterceptor);//添加组件大功告成return mybatisPlusInterceptor;}
} service.impl下实现分页逻辑 Service
public class HouseService extends ServiceImplHouseMapper, House implements IHouseService {Autowiredprivate HouseMapper houseMapper;public IPageHouse getDataByPage(int current,int size, House house){IPageHouse page new Page(current,size);QueryWrapperHouse queryWrapper new QueryWrapper();// 动态构建查询条件queryWrapper.lambda().eq(house.getParentBuilding()!null, House::getParentBuilding,house.getParentBuilding()).eq(house.getParentUnit()!null,House::getParentUnit,house.getParentUnit()).eq(house.getParentFloor()!null,House::getParentFloor,house.getParentFloor()).eq(house.getHouseNum()!null,House::getHouseNum,house.getHouseNum()).eq(house.getHouseSize()!null,House::getHouseSize,house.getHouseSize()).eq(house.getHouseType()!null,House::getHouseType,house.getHouseType()).eq(house.getIsSold()!null,House::getIsSold,house.getIsSold());return houseMapper.selectPage(page,queryWrapper);}
}
controller层应用实现
package com.xingdian.controller;import com.baomidou.mybatisplus.core.metadata.IPage;
import com.xingdian.enums.ResponseStatusEnum;
import com.xingdian.pojo.House;
import com.xingdian.pojo.User;
import com.xingdian.pojo.dto.ResponseDTO;
import com.xingdian.service.impl.HouseService;
import com.xingdian.service.impl.UserService;
import lombok.extern.log4j.Log4j2;
import org.slf4j.Logger;
import org.slf4j.LoggerFactory;
import org.springframework.web.bind.annotation.*;Log4j2
RestController
RequestMapping(user)
public class HouseController {private final HouseService houseService;public HouseController(HouseService houseService) {this.houseService houseService;}/*** param house 分页查询条件* param page 当前页* param rows 当前页的数据条数* return*/GetMapping(getDataByPage)public ResponseDTOIPage getDataByPage(House house, int page, int rows) {if (house null || page0 || rows0)return ResponseDTO.failure(ResponseStatusEnum.PARAM_IS_INVALID);//支支持其他属性的条件分页查询house.setId(null);house.setOwnerId(null);house.setUserId(null);return ResponseDTO.success(houseService.getDataByPage(page,rows,house));}}其他与上述的User表的套路实现别无二致。
5.5.6 整合Knife4j 测试编写的API接口
后端的测试可以通过不同的测试工具如Postman可以直接官网下载Postman API Platform进行也可以通过Spring Boot支持的依赖测试工具如Swagger、knife4j进行。
本文通过整合Kinfe4j进行相应的接口测试。
Swagger可以用于生成、描述、调用和可视化Restful风格的web服务。简单说来就是⼀个用于生成服务器接口的规范性文档、并对接⼝进行测试的工具。而Knife4j 是对 Swagger 的一个增强和优化主要用于 Java 项目中的 API 文档生成和展示。它在 Swagger 的基础上进行了许多改进例如更好的用户界面、增强的功能和更好的性能等。 引入依赖
dependencygroupIdcom.github.xiaoymin/groupIdartifactIdknife4j-openapi3-jakarta-spring-boot-starter/artifactIdversion4.4.0/version
/dependency在配置文件中添加配置信息
knife4j:# 开启增强模式对knife4j的接口测试以及文档编写进行一定个性化设置enable: truesetting:language: zh_cnenable-open-api: truebasic:enable: false # 是否设置BasicHttp功能 开启则需设置进入Knife4j的账号密码
若是只是进行简单的接口测试引入依赖设置最基础的Knife4j配置信息就能直接通过http://localhost:9090/doc.html路径访问Knife4j的UI界面进行测试了。若是想要更加完善的接口测试功能体验以及接口规范性文档编写请参考Knife4j官网或者其他相关文章如Knife4j系列--使用-教程-实例-配置 详细讲解-CSDN博客。在规范的Java后端开发中会涉及到大量相关的注解式的程序相关说明辅助完成API接口文档这一部分是开发人员在团队合作开发中必须要学习的。 上述分页查询的接口测试 到此 Spring Boot3 整合MybatisPlus MYSQL开发Java后端接口就能新手上路了。 再次声明本文的所有代码均已上传代码仓库https://github.com/yang66-hash/XDPropertyManagementSystemDemo.git 可以免费获取 具体参看官方文档SpringApplication :: Spring Boot
参考文档
1. Spring Boot官方文档Spring Boot :: Spring Boot
2. 深入理解Spring Boot Starter-腾讯云开发者社区-腾讯云
3. https://zhuanlan.zhihu.com/p/602453889#:~:textspring%20b
4. 快速开始 | Knife4j 5. Knife4j系列--使用-教程-实例-配置 详细讲解-CSDN博客
6. 《阿里巴巴Java开发手册终极版》
7. Java日志框架日志门面介绍_1、日志门面-CSDN博客
8. https://plus.mybatis.ac.cn/guides/data-interface/#page
9. Spring Boot MyBatis 项目中常用注解详解万字长篇解读-CSDN
10. https://github.com/yang66-hash/logback-chinese-manual.git
