SpringBoot 3 入门实战：从环境搭建到打包部署

一、背景与选型最近在一个轻量级的服务中尝试了最新的技术和工具选型即SpringBoot3JDK17IDEA2023Navicat16虽然新的技术和工具都更加强大和高效但是适应采坑的过程总是枯燥的【环境一览】首先框架主体从SpringBoot2升级到SpringBoot3Java基础环境从JDK8升级到JDK17技术升级都到这步了自然连带着工具都升级到最新版本了涉及到的其他组件也会选择与当前框架适应的版本至于为何使用JDK17因为是SpringBoot3的最低依赖也和官方的维护周期有关实际上如果JDK21已经发布的话个人更倾于这个版本要是没有合适的尝试机会继续使用JDK8也问题不大另外开发工具IDEA2021.2版本才开始支持JDK17所以如果版本过低的话也需要升级至于Navicat16纯属跟风操作二、环境搭建与配置1. 工程结构在工程结构上没有什么变化通过maven组件构建项目对于入门案例来说注意框架依赖启动类配置文件即可2. 框架依赖在该工程中只是SpringBoot3框架的简单测试所以只引入web依赖就足够dependencies dependency groupIdorg.springframework.boot/groupId artifactIdspring-boot-starter-web/artifactId version${spring-boot.version}/version /dependency /dependencies至于Spring框架和其他组件的依赖顺着web依赖追溯即可核心的依赖和版本都可以找到3. 环境配置入门案例在这里只简单的配置服务器和应用名称server: port: 8082 # 端口号 tomcat: # Tomcat组件 uri-encoding: UTF-8 # URI编码 spring: application: name: boot-base三、入门案例1、测试接口提供一个简单的Get请求接口使用了部分JDK新版的语法如果抛出异常会统一处理RestController public class BootBaseWeb { GetMapping(/boot/base/{id}) public MapString,String getInfo (PathVariable String id){ if (id.isBlank() || 0.equals(id)){ throw new RuntimeException(参数ID错误); } var dataMap new HashMapString,String(); dataMap.put(id,id); dataMap.put(boot,base); return dataMap ; } }2、全局异常基于注解RestControllerAdvice和ExceptionHandler统一异常处理RestControllerAdvice public class HandlerExe { ExceptionHandler(value Exception.class) public MapString,String handler02 (HttpServletRequest request, Exception e){ var errorMap new HashMapString,String() ; errorMap.put(code,500); errorMap.put(url,request.getRequestURL().toString()); errorMap.put(msg,e.getMessage()); return errorMap ; } }3、日志打印3.1 日志配置在application.yml文件中简单的添加日志配置内容然后从日志文件或者控制台输出查看相关信息logging: level: root: info # 设置根日志级别为info可选值trace/debug/info/warn/error file: path: ./ # 日志文件存储目录默认为当前目录 name: logs/${spring.application.name}.log # 日志文件名可使用应用名变量 pattern: console: %d{yyyy-MM-dd HH:mm:ss} %contextName [%thread] %-5level %logger- %msg%n # 控制台输出格式 file: %d{yyyy-MM-dd HH:mm:ss} %contextName [%thread] %-5level %logger- %msg%n # 文件输出格式 logback: rolling-policy: max-history: 7 # 保留最近7天的历史日志文件 max-file-size: 10MB # 单个日志文件最大10MB超过则滚动创建新文件 total-size-cap: 50MB # 所有日志文件总大小上限为50MB超过则删除最旧文件以上配置在application.properties文件中等效的写法为logging.logback.rolling-policy.max-history7、logging.logback.rolling-policy.max-file-size10MB、logging.logback.rolling-policy.total-size-cap50MB。3.2 日志打印虽然采用的是logback组件但是使用slf4j的API即可import org.slf4j.Logger; import org.slf4j.LoggerFactory; RestController public class BootLogWeb { private static final Logger LOGGER LoggerFactory.getLogger(BootBaseWeb.class); GetMapping(/boot/print/log) public String printLog (HttpServletRequest request){ LOGGER.info(remote-host:{},request.getRemoteHost()); LOGGER.info(request-uri:{},request.getRequestURI()); return request.getServerName() ; } }四、打包运行打包代码工程中的m1-01-boot-base子模块以及其相关的依赖mvn clean -pl m1-01-boot-base -am -Dmaven.test.skiptrue package运行m1-01-boot-base.jar服务并指定相应的端口号为8080然后测试其中相关接口查看日志即可java -jar m1-01-boot-base.jar --server.port8080五、参考源码文档仓库 https://gitee.com/cicadasmile/butte-java-note 源码仓库 https://gitee.com/cicadasmile/butte-spring-parent