青海网站设计,微信公众号服务平台,郑州网站seo哪家公司好,衡阳市建设工程质量监督站网站目录
一、环境准备
二、新建项目
三、整合依赖
1、MyBatis Plus 数据库操作
2、Hutool 工具库
3、Knife4j 接口文档
4、其他依赖
四、通用基础代码
1、自定义异常
2、响应包装类
3、全局异常处理器
4、请求包装类
5、全局跨域配置
补充#xff1a;设置新建类/接…目录
一、环境准备
二、新建项目
三、整合依赖
1、MyBatis Plus 数据库操作
2、Hutool 工具库
3、Knife4j 接口文档
4、其他依赖
四、通用基础代码
1、自定义异常
2、响应包装类
3、全局异常处理器
4、请求包装类
5、全局跨域配置
补充设置新建类/接口文件的类/接口注释模版 一、环境准备
1) 安装的 JDK 版本可以是 8、11 或 17一般情况下使用 8 也可以了 不过具体情况需要根据使用到的中间件的适配性决定最终使用 JDK 多少的版本如若后续要用到缓存库 Caffeine 则要求使用 11 版本 JDK
2) MySQL数据库最好安装 8.x版本或者 5.7/ 5.6 版本。MySQL 可以是5.X 数据库连接的 xml 配置可以是8 版本的
3) Maven 仓库 3.6.X 版本即可
二、新建项目 在 IDEA 中新建项目选择 Spring Initializr 模板考虑到稳定性此处选择创建 Java8 版本项目注意需要替换 阿里云的链接 Server URL为 : Cloud Native App Initializerhttps://start.aliyun.com/因为官方的 Server URL 不支持选择 Java 8.配置如图 : 选择 Spring Boot 2.7.6 版本可以根据自己的需要添加一些依赖比如 Spring Web、MyBatis、MySQL、Lombok: 当然后续通过修改 Maven 配置添加依赖也是可以的。点击创建就得到了一个 Spring Boot 项目需要等待 Maven 为我们安装依赖。安装完依赖后先尝试启动一下项目结果会报错 因为我们在 Maven 中引入了 MySQL 依赖但是项目配置文件中并没有填写 MySQL 的配置。修改资源日录下的配置文件为 application.yml (默认的是 application.properties 且.properties优先级会比.yml后缀的优先级要高但.yml 的格式会更方便不用写更多重复的代码且树形结构更清晰建议使用 application.yml文件格式 )指定项目启动的端口号和访问地址前缀、项目名称、数据库配置等。 代码如下 :
server:port: 8123servlet:context-path: /api
spring:application:name: backend# 数据库配置datasource:driver-class-name: com.mysql.cj.jdbc.Driverurl: jdbc:mysql://localhost:3306/ss_pictureusername: rootpassword: 123456更改之后发现可以正常运行了 三、整合依赖
接下来我们要整合一些开发项目常用的依赖。
1、MyBatis Plus 数据库操作 MyBatis Plus 是 MyBatis 增强工具旨在简化开发流程。它提供了开箱即用的 CRUD 方法、动态查询构造器、分页插件和代码生成器等功能大幅减少重复代码同时保持与 MyBatis 原生功能的兼容性。例如通过调用 baseMapper.selectById(id)可以直接查询数据库中的记录而无需手动编写 SQL。参考官方文档引入:教程有时效性一切以官方文档为主 https://baomidou.com/getting-started/#spring-boot2 在pom文件中引入
dependencygroupIdcom.baomidou/groupIdartifactIdmybatis-plus-boot-starter/artifactIdversion3.5.9/version
/dependency注意添加该依赖后记得移除 MyBatis 相关的依赖!否则很容易导致版本冲突!!! 在项目中新建 mapper包)后续用于存放操作数据库的 Mapper类然后在项目启动类中添加扫描 Mapper 的 MapperScan 注解 :
SpringBootApplication
MapperScan(com.ss.picturebackend.mapper)
public class PictureBackendApplication {public static void main(String[] args) {SpringApplication.run(YuPictureBackendApplication.class, args);}
}在 application.yml 中追加配置开启日志和逻辑删除功能 :
mybatis-plus:configuration:map-underscore-to-camel-case: false# 仅在开发环境开启日志log-impl: org.apache.ibatis.logging.stdout.StdOutImplglobal-config:db-config:logic-delete-field: isDelete # 全局逻辑删除的实体字段名logic-delete-value: 1 # 逻辑已删除值默认为 1logic-not-delete-value: 0 # 逻辑未删除值默认为 02、Hutool 工具库 Hutool是主流的 java 工具类库集合了丰富的工具类涵盖字符串处理、日期操作、文件处理、加解密、反射、正则匹配等常见功能。它的轻量化和无侵入性让开发者能够专注于业务逻辑而不必编写重复的工具代码。例如 Dateuti1.formatDate(new Date())可以快速将当前日期格式化为字符串。 参考官方文档引入: https://doc.hutool.cn/pages/index/#%F0%9F%8D%8Amaven 在 Maven 的 pom.xm| 中添加依赖:
dependencygroupIdcn.hutool/groupIdartifactIdhutool-all/artifactIdversion5.8.26/version
/dependency3、Knife4j 接口文档
Knife4j 是基于 swagger 接口文档的增强工具提供了更加友好的 AP! 文档界面和功能扩展例如动态参数调试、分组文档等。它适合用于 Spring Boot 项目中能够通过简单的配置自动生成接口文档让开发者和前端快速了解和调试接口提高写作效率。 参考官方文档引入: https://doc.xiaominfo.com/docs/quick-start#spring-boot-2 由于使用的是 Spring Boot 2.x注意要选择 OpenAPI 2 的版本。 在 Maven 的 pom.xml 中添加依赖:
dependencygroupIdcom.github.xiaoymin/groupIdartifactIdknife4j-openapi2-spring-boot-starter/artifactIdversion4.4.0/version
/dependency在 application.ym| 中追加接口文档配置扫描 Controller 包:
# 接口文档配置
knife4j:enable: trueopenapi:title: 接口文档version: 1.0group:default:api-rule: packageapi-rule-resources:- com.ss.picturebackend.controller重启项目访问 http://localhost:8123/api/doc.html 能够看到接口文档可以测试调用 4、其他依赖
可以按需引入其他依赖比如 AOP 切面编程:
dependencygroupIdorg.springframework.boot/groupIdartifactIdspring-boot-starter-aop/artifactId
/dependency给启动类添加注解(可选):
EnableAspectJAutoProxy(exposeProxy true)exposeProxy true的作用: 通过 Spring AOP 提供对当前代理对象的访问使得可以在业务逻辑中访问到当前的代理对象。你可以在方法执行时通过 AopContext.currentProxy() 获取当前的代理对象。 当然随着业务具体的需求还有更多的依赖后续随用随装即可。
四、通用基础代码
通用基础代码是指:无论在任何后端项目中都可以复用的代码。这种代码一般只用写一次”了解作用之后复制粘贴即可无需记忆。
1、自定义异常
自定义错误码对错误进行收敛便于前端统一处理。 这里有 2 个小技巧: ① .自定义错误码时建议跟主流的错误码 (比如 HTTP 错误码) 的含义保持一致比如“未登录”定义为 40100和 HTTP 401 错误 (用户需要进行身份认证) 保持一致会更容易理解。
② .错误码不要完全连续预留一些间隔便于后续扩展。 在 exception 包下新建错误码枚举类
Getter
public enum ErrorCode {SUCCESS(0, ok),PARAMS_ERROR(40000, 请求参数错误),NOT_LOGIN_ERROR(40100, 未登录),NO_AUTH_ERROR(40101, 无权限),NOT_FOUND_ERROR(40400, 请求数据不存在),FORBIDDEN_ERROR(40300, 禁止访问),SYSTEM_ERROR(50000, 系统内部异常),OPERATION_ERROR(50001, 操作失败);/*** 状态码*/private final int code;/*** 信息*/private final String message;ErrorCode(int code, String message) {this.code code;this.message message;}}一般不建议直接抛出 Java 内置的 RuntimeException而是自定义一个业务异常和内置的异常类区分开便于定制化输出错误信息 :
Getter
public class BusinessException extends RuntimeException {/*** 错误码*/private final int code;public BusinessException(int code, String message) {super(message);this.code code;}public BusinessException(ErrorCode errorCode) {super(errorCode.getMessage());this.code errorCode.getCode();}public BusinessException(ErrorCode errorCode, String message) {super(message);this.code errorCode.getCode();}}为了更方便地根据情况抛出异常可以封装一个 ThrowUtils类似断言类简化抛异常的代码:
public class ThrowUtils {/*** 条件成立则抛异常** param condition 条件* param runtimeException 异常*/public static void throwIf(boolean condition, RuntimeException runtimeException) {if (condition) {throw runtimeException;}}/*** 条件成立则抛异常** param condition 条件* param errorCode 错误码*/public static void throwIf(boolean condition, ErrorCode errorCode) {throwIf(condition, new BusinessException(errorCode));}/*** 条件成立则抛异常** param condition 条件* param errorCode 错误码* param message 错误信息*/public static void throwIf(boolean condition, ErrorCode errorCode, String message) {throwIf(condition, new BusinessException(errorCode, message));}
}2、响应包装类
一般情况下每个后端接口都要返回调用码、数据、调用信息等前端可以根据这些信息进行相应的处理我们可以封装统一的响应结果类便于前端统一获取这些信息通用响应类:
Data
public class BaseResponseT implements Serializable {private int code;private T data;private String message;public BaseResponse(int code, T data, String message) {this.code code;this.data data;this.message message;}public BaseResponse(int code, T data) {this(code, data, );}public BaseResponse(ErrorCode errorCode) {this(errorCode.getCode(), null, errorCode.getMessage());}
} 但之后每次接口返回值时都要手动 new 一个 BaseResponse 对象并传入参数比较麻烦我们可以新建一个工具类提供成功调用和失败调用的方法支持灵活地传参简化调用。
public class ResultUtils {/*** 成功** param data 数据* param T 数据类型* return 响应*/public static T BaseResponseT success(T data) {return new BaseResponse(0, data, ok);}/*** 失败** param errorCode 错误码* return 响应*/public static BaseResponse? error(ErrorCode errorCode) {return new BaseResponse(errorCode);}/*** 失败** param code 错误码* param message 错误信息* return 响应*/public static BaseResponse? error(int code, String message) {return new BaseResponse(code, null, message);}/*** 失败** param errorCode 错误码* return 响应*/public static BaseResponse? error(ErrorCode errorCode, String message) {return new BaseResponse(errorCode.getCode(), null, message);}
}3、全局异常处理器
为了防止意料之外的异常利用 AOP 切面全局对业务异常和 RuntimeException 进行捕获:
RestControllerAdvice
Slf4j
public class GlobalExceptionHandler {ExceptionHandler(BusinessException.class)public BaseResponse? businessExceptionHandler(BusinessException e) {log.error(BusinessException, e);return ResultUtils.error(e.getCode(), e.getMessage());}ExceptionHandler(RuntimeException.class)public BaseResponse? runtimeExceptionHandler(RuntimeException e) {log.error(RuntimeException, e);return ResultUtils.error(ErrorCode.SYSTEM_ERROR, 系统错误);}
}
4、请求包装类
对于“分页”、“删除某条数据”这类通用的请求可以封装统一的请求包装类用于接受前端传来的参数之后相同参数的请求就不用专门再新建一个类了。 分页请求包装类接受页号、页面大小、排序字段、排序顺序参数:
Data
public class PageRequest {/*** 当前页号*/private int current 1;/*** 页面大小*/private int pageSize 10;/*** 排序字段*/private String sortField;/*** 排序顺序默认降序*/private String sortOrder descend;
}删除请求包装类接受要删除数据的id 作为参数
Data
public class DeleteRequest implements Serializable {/*** id*/private Long id;private static final long serialVersionUID 1L;
}5、全局跨域配置
跨域是指浏览器访问的 URL(前端地址)和后端接口地址的域名(或端口号)不一致导致的浏览器为了安全默认禁上跨域请求访问 。 为了开发调试方便我们可以通过全局跨域配置让整个项目所有的接口支持跨域解决跨域报错。新建 config 包用于存放所有的配置相关代码。全局跨域配置代码如下 :
Configuration
public class CorsConfig implements WebMvcConfigurer {Overridepublic void addCorsMappings(CorsRegistry registry) {// 覆盖所有请求registry.addMapping(/**)// 允许发送 Cookie.allowCredentials(true)// 放行哪些域名必须用 patterns否则 * 会和 allowCredentials 冲突.allowedOriginPatterns(*).allowedMethods(GET, POST, PUT, DELETE, OPTIONS).allowedHeaders(*).exposedHeaders(*);}
}编写示例接口移除 controller 包下的其他代码让项目干净一些然后编写一个纯净的 /health 接口用于健康检查:
RestController
RequestMapping(/)
public class MainController {/*** 健康检查*/GetMapping(/health)public BaseResponseString health() {return ResultUtils.success(ok);}
}访问 http://localhost:8123/api/health看到输出结果表示后端初始化完成: 补充设置新建类/接口文件的类/接口注释模版
在设置中输入“File and Code Templates” 或者 “文件和代码模板” 可增加自定义注释 参考SpringBoot IDEA 开发必备使用小技巧
