SpringBoot入门知识

我是南城余！阿里云开发者平台专家博士证书获得者！

欢迎关注我的博客！一同成长！

一名从事运维开发的worker，记录分享学习。

专注于AI，运维开发，windows Linux 系统领域的分享！

本章节对应知识库

SpringBoot (yuque.com)

本内容来自尚硅谷课程，此处在知识库做了个人理解
————————————————
?

1. 什么是SpringBoot

SpringBoot 帮我们简单、快速地创建一个独立的、生产级别的 Spring 应用（说明：SpringBoot底层是Spring）

特性：

• 快速创建独立 Spring 应用

• • SSM：导包、写配置、启动运行

• 直接嵌入Tomcat、Jetty or Undertow（无需部署 war 包）【Servlet容器】

• • linux java tomcat mysql： war 放到 tomcat 的 webapps下
  • jar： java环境； java -jar

• 重点：提供可选的starter，简化应用整合

• • 场景启动器（starter）：web、json、邮件、oss（对象存储）、异步、定时任务、缓存...
  • 导包一堆，控制好版本。
  • 为每一种场景准备了一个依赖； web-starter。mybatis-starter

• 重点：按需自动配置 Spring 以及 第三方库

• • 如果这些场景我要使用（生效）。这个场景的所有配置都会自动配置好。
  • 约定大于配置：每个场景都有很多默认配置。
  • 自定义：配置文件中修改几项就可以

• 提供生产级特性：如 监控指标、健康检查、外部化配置等

• • 监控指标、健康检查（k8s）、外部化配置

• 无代码生成、无xml

总结：简化开发，简化配置，简化整合，简化部署，简化监控，简化运维。

2. 快速体验

场景：浏览器发送/hello请求，返回"Hello,Spring Boot 3!"

1. 创建项目

maven 项目

<!--    所有springboot项目都必须继承自 spring-boot-starter-parent -->
    <parent>
        <groupId>org.springframework.boot</groupId>
        <artifactId>spring-boot-starter-parent</artifactId>
        <version>3.0.5</version>
    </parent>

2. 导入场景

场景启动器

    <dependencies>
<!--        web开发的场景启动器 -->
        <dependency>
            <groupId>org.springframework.boot</groupId>
            <artifactId>spring-boot-starter-web</artifactId>
        </dependency>
    </dependencies>

3. 主程序

@SpringBootApplication //这是一个SpringBoot应用
public class MainApplication {

    public static void main(String[] args) {
        SpringApplication.run(MainApplication.class,args);
    }
}

4. 业务

@RestController
public class HelloController {

    @GetMapping("/hello")
    public String hello(){

        return "Hello,Spring Boot 3!";
    }

}

5. 测试

默认启动访问： localhost:8080

6. 打包

<!--    SpringBoot应用打包插件-->
    <build>
        <plugins>
            <plugin>
                <groupId>org.springframework.boot</groupId>
                <artifactId>spring-boot-maven-plugin</artifactId>
            </plugin>
        </plugins>
    </build>

mvn clean package把项目打成可执行的jar包

java -jar demo.jar启动项目

3. 简化操作

一个配置文件，无需更改代码，高效简化运维

application.properties：

• 集中式管理配置。只需要修改这个文件就行 。
• 配置基本都有默认值
• 能写的所有配置都在： Common Application Properties

4. 应用分析

4.1. 默认包扫描规则

Spring Boot只会扫描主程序所在的包及其下面的子包

自定义扫描路径

@SpringBootApplication(scanBasePackages="cn.nanchengyu")(后面为指定扫描路径)

5. 理解springBoot

导入starter-->生效xxxAutoConfiguration-->组件-->xxxProperties-->配置文件

a. 配置文件

在Java中存在两种配置文件，一种是application.properties,另一种YAML,后者一般以.yaml或 .yml作为文件后缀

示例代码

@Component
@ConfigurationProperties(prefix = "person") //和配置文件person前缀的所有配置进行绑定
@Data //自动生成JavaBean属性的getter/setter
//@NoArgsConstructor //自动生成无参构造器
//@AllArgsConstructor //自动生成全参构造器
public class Person {
    private String name;
    private Integer age;
    private Date birthDay;
    private Boolean like;
    private Child child; //嵌套对象
    private List<Dog> dogs; //数组（里面是对象）
    private Map<String,Cat> cats; //表示Map
}

@Data
public class Dog {
    private String name;
    private Integer age;
}

@Data
public class Child {
    private String name;
    private Integer age;
    private Date birthDay;
    private List<String> text; //数组
}

@Data
public class Cat {
    private String name;
    private Integer age;
}

person.name=张三
person.age=18
person.birthDay=2010/10/12 12:12:12
person.like=true
person.child.name=李四
person.child.age=12
person.child.birthDay=2018/10/12
person.child.text[0]=abc
person.child.text[1]=def
person.dogs[0].name=小黑
person.dogs[0].age=3
person.dogs[1].name=小白
person.dogs[1].age=2
person.cats.c1.name=小蓝
person.cats.c1.age=3
person.cats.c2.name=小灰
person.cats.c2.age=2

person:
  name: 张三
  age: 18
  birthDay: 2010/10/10 12:12:12
  like: true
  child:
    name: 李四
    age: 20
    birthDay: 2018/10/10
    text: ["abc","def"]
  dogs:
    - name: 小黑
      age: 3
    - name: 小白
      age: 2
  cats:
    c1:
      name: 小蓝
      age: 3
    c2: {name: 小绿,age: 2} #对象也可用{}表示

b. 日志

日志是为了解决频繁的println，以后所有的println都应该使用日志输出出来。

idea快速创建springBoot项目操作步骤

springBoot日志配置

1、每个starter场景，都会导入一个核心场景spring-boot-starter

2、核心场景引入了日志的所有功能spring-boot-starter-logging

3、默认使用了logback+slf4j组合作为默认底层日志

4、日志是系统一启动就要使用的，xxxAutoConfiguaration是系统启动好了以后要放好的组件，后来要使用的

5、日志是利用监听器机制配置好的。ApplicationListener

6、日志所有的配置都可以通过修改配置文件实现，以logging开始的所有配置

记录日志

Logger logger = LoggerFactory.getLogger(getClass());

//或者使用Lombok的@Slf4j注解

日志级别

• 由低到高：ALL,TRACE, DEBUG, INFO, WARN, ERROR,FATAL,OFF；

• • 只会打印指定级别及以上级别的日志
  • ALL：打印所有日志
  • TRACE：追踪框架详细流程日志，一般不使用
  • DEBUG：开发调试细节日志
  • INFO：关键、感兴趣信息日志
  • WARN：警告但不是错误的信息日志，比如：版本过时
  • ERROR：业务错误日志，比如出现各种异常
  • FATAL：致命错误日志，比如jvm系统崩溃
  • OFF：关闭所有日志记录

• 不指定级别的所有类，都使用root指定的级别作为默认级别
• SpringBoot日志默认级别是 INFO

1. 在application.properties/yaml中配置logging.level.<logger-name>=<level>指定日志级别
2. level可取值范围：TRACE, DEBUG, INFO, WARN, ERROR, FATAL, or OFF，定义在 LogLevel类中
3. root 的logger-name叫root，可以配置logging.level.root=warn，代表所有未指定日志级别都使用 root 的 warn 级别

日志输出至文件

一般在配置文件中使用的是logging.file.name，因为他既可以输出日志到文件时，可以指定文件名字，也可以指定文件所保存的路径

#指定日志文件的路径，日志文件默认名为 spring.log

#logging.file.path=D:\\
#指定日志文件的名： filename和path的配置同时存在只看filename
#1.只有名字，就会生成到当前项目同位置的demo.log
#2.写名字+路径：生成到指定位置的指定文件
logging.file.name=D:\\nanchengyu.log

#日志归档、切割
#规定输出日志格式
logging.logback.rollingpolicy.file-name-pattern=${LOG_FILE}.%d{yyyy-MM-dd}.%i.gz
#规定日志文件最大值
logging.logback.rollingpolicy.max-size=1MB

c. 导入第三方日志步骤

1. 导入任何第三方框架，先排除它的日志包，因为Boot底层控制好了日志
2. 修改 application.properties 配置文件，就可以调整日志的所有行为。如果不够，可以编写日志框架自己的配置文件放在类路径下就行，比如logback-spring.xml，log4j2-spring.xml
3. 如需对接专业日志系统，也只需要把 logback 记录的日志灌倒 kafka之类的中间件，这和SpringBoot没关系，都是日志框架自己的配置，修改配置文件即可
4. 业务中使用slf4j-api记录日志。不要再 sout 了

<dependency>
    <groupId>org.springframework.boot</groupId>
    <artifactId>spring-boot-starter-web</artifactId>
</dependency>
<dependency>
    <groupId>org.springframework.boot</groupId>
    <artifactId>spring-boot-starter</artifactId>
    <exclusions>
        <exclusion>
            <groupId>org.springframework.boot</groupId>
            <artifactId>spring-boot-starter-logging</artifactId>
        </exclusion>
    </exclusions>
</dependency>
<dependency>
    <groupId>org.springframework.boot</groupId>
    <artifactId>spring-boot-starter-log4j2</artifactId>
</dependency>