SpringBoot3基础用法

本文涉及的产品
日志服务 SLS,月写入数据量 50GB 1个月
简介: SpringBoot3基础用法SpringBoot3基础案例:环境搭建,入门案例,日志组件,全局异常处理,工程打包,服务启动关闭;

技术和工具「!喜新厌旧」

一、背景

最近在一个轻量级的服务中,尝试了最新的技术和工具选型;

SpringBoot3JDK17IDEA2023Navicat16,虽然新的技术和工具都更加强大和高效,但是适应采坑的过程总是枯燥的;

【环境一览】

1.png

首先框架主体从SpringBoot2升级到SpringBoot3,Java基础环境从JDK8升级到JDK17

技术升级都到这步了,自然连带着工具都升级到最新版本了,涉及到的其他组件,也会选择与当前框架适应的版本;

至于为何使用JDK17,因为是SpringBoot3的最低依赖,也和官方的维护周期有关;

2.png

实际上如果JDK21已经发布的话,个人更倾于这个版本,要是没有合适的尝试机会,继续使用JDK8也问题不大;

另外开发工具IDEA2021.2版本才开始支持JDK17,所以如果版本过低的话也需要升级,至于Navicat16纯属跟风操作;

二、环境搭建

1、工程结构

在工程结构上没有什么变化,通过maven组件构建项目,对于入门案例来说,注意框架依赖,启动类,配置文件即可;

3.png

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依赖追溯即可,核心的依赖和版本都可以找到;

4.png

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 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、全局异常

基于注解RestControllerAdviceExceptionHandler统一异常处理;

@RestControllerAdvice
public 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;

@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.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
相关实践学习
日志服务之使用Nginx模式采集日志
本文介绍如何通过日志服务控制台创建Nginx模式的Logtail配置快速采集Nginx日志并进行多维度分析。
相关文章
|
15天前
|
NoSQL Java MongoDB
SpringBoot中MongoDB的那些骚操作用法
MongoDB作为一种NoSQL数据库,在不需要传统SQL数据库的表格结构的情况下,提供了灵活的数据存储方案。在Spring Boot中可以通过官方SDK、Spring JPA或MongoTemplate等方式集成MongoDB。文章重点介绍了Spring Data MongoDB提供的注解功能,例如`@Id`、`@Document`和`@Field`等,这些注解简化了Java对象到MongoDB文档的映射。此外,文中还讨论了MongoTemplate监听器的使用,包括设置主键值和日志记录等高级特性。
78 0
SpringBoot中MongoDB的那些骚操作用法
|
7天前
|
Java API
SpringBoot Scheduled 常见用法
SpringBoot Scheduled 常见用法
16 0
|
2月前
|
前端开发 Java 开发者
深入理解 Spring Boot 注解:核心功能与高级用法详解
深入理解 Spring Boot 注解:核心功能与高级用法详解
68 1
|
2月前
|
JSON Java 数据格式
Spring Boot 中的 @DateTimeFormat 和 @JsonFormat 的用法及作用
【6月更文挑战第11天】在开发 Spring Boot 应用时,处理日期和时间数据是一个常见的需求。Spring Boot 提供了两个注解 @DateTimeFormat 和 @JsonFormat 来帮助我们处理这些问题。
168 4
|
3月前
|
Java 开发者 Spring
Springboot中的@Bean用法以及常见问题
【5月更文挑战第27天】@Bean 注解是Spring框架中用于声明Spring应用上下文中的bean的一种方式。在Spring Boot中,@Bean注解通常与@Configuration注解一起使用,在配置类(Configuration class)中定义bean。
62 2
|
3月前
|
XML Java API
springboot 常用的注解标签的概念及用法RequiredArgsConstructor 、RestController、RequestMapping
【4月更文挑战第12天】在 Spring Boot 中,@RequiredArgsConstructor, @RestController, 和 @RequestMapping 是常用的注解,每个都有其特定的功能和用法,它们合起来极大地简化了 Spring 应用程序的开发过程。
141 2
|
3月前
|
安全 Java Spring
springboot @Resource、@AutoWaire的用法实战
【4月更文挑战第3天】在Spring Boot中,@Autowired和@Resource注解都用于自动注入依赖,但它们在底层工作方式和使用的场合上存在一些差异。理解这些差异有助于更有效地使用Spring框架。
110 1
|
3月前
|
存储 Java 数据库连接
springboot ConstraintValidator的概念与用法
【4月更文挑战第25天】在 Java 中,ConstraintValidator 是用于自定义注解验证的接口,属于 Bean Validation(JSR 303 和 JSR 349)标准的一部分。这个接口定义了如何实施一个特定的约束注解的验证逻辑。
125 0
|
3月前
|
前端开发 Java Maven
spring boot3参数校验基本用法
spring boot3参数校验基本用法
139 2
|
XML Java 数据格式
SpringBoot入门(五) 之 @ConfigurationProperties和@Value的区分与用法
SpringBoot入门(五) 之 @ConfigurationProperties和@Value的区分与用法
115 0