技术和工具「!喜新厌旧」
一、背景
最近在一个轻量级的服务中，尝试了最新的技术和工具选型；
即SpringBoot3，JDK17，IDEA2023，Navicat16，虽然新的技术和工具都更加强大和高效，但是适应采坑的过程总是枯燥的；
【环境一览】
首先框架主体从SpringBoot2升级到SpringBoot3，Java 基础环境从JDK8升级到JDK17；
技术升级都到这步了，自然连带着工具都升级到最新版本了，涉及到的其他组件，也会选择与当前框架适应的版本；
至于为何使用JDK17，因为是SpringBoot3的最低依赖，也和官方的维护周期有关；
实际上如果JDK21已经发布的话，个人更倾于这个版本，要是没有合适的尝试机会，继续使用JDK8也问题不大；
另外开发工具IDEA2021.2版本才开始支持JDK17，所以如果版本过低的话也需要升级，至于Navicat16纯属跟风操作；
二、环境搭建
1、工程结构
在工程结构上没有什么变化，通过 maven 组件构建项目，对于入门案例来说，注意框架依赖，启动类，配置文件即可；
2、框架依赖
在该工程中只是SpringBoot3框架的简单测试，所以只引入web依赖就足够；
<dependencies> <dependency> <groupId>org.springframework.boot</groupId> <artifactId>spring-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 新版的语法，如果抛出异常会统一处理；
@RestControllerpublic class BootBaseWeb {
@GetMapping("/boot/base/{id}") public Map<String,String> getInfo (@PathVariable String id){ if (id.isBlank() || "0".equals(id)){ throw new RuntimeException("参数ID错误"); } var dataMap = new HashMap<String,String>(); dataMap.put("id",id); dataMap.put("boot","base"); return dataMap ; }}
复制代码
2、全局异常
基于注解RestControllerAdvice和ExceptionHandler统一异常处理；
@RestControllerAdvicepublic class HandlerExe {
@ExceptionHandler(value = Exception.class) public Map<String,String> handler02 (HttpServletRequest request, Exception e){ var errorMap = new HashMap<String,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 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 max-file-size: 10MB total-size-cap: 50MB
复制代码
3.2 日志打印
虽然采用的是logback组件，但是使用slf4j的 API 即可；
import org.slf4j.Logger;import org.slf4j.LoggerFactory;
@RestControllerpublic 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.skip=true package
复制代码
运行m1-01-boot-base.jar服务，并指定相应的端口号为8080，然后测试其中相关接口查看日志即可；
java -jar m1-01-boot-base.jar --server.port=8080
复制代码
五、参考源码
文档仓库：https://gitee.com/cicadasmile/butte-java-note
源码仓库：https://gitee.com/cicadasmile/butte-spring-parent
复制代码
评论