Spring Boot入门学习

1. Spring Boot概述

1.1.什么是Spring Boot

SpringBoot是一个可使用Java构建微服务的微框架。是Spring框架及其社区对“约定优先于配置”理念的最佳实践。Sping Boot的设计目的是让你尽可能快地启动和运行，而无需预先配置Spring。Spring Boot以以一种固定的方式来构建可用于生产级别的应用程序。
一般把Spring Boot称为搭建程序的脚手架或者说是便捷搭建基于Spring的工程脚手架。其最主要作用就是帮助开发人员快速的构建庞大的spring项目，并且尽可能的减少一切xml配置，做到开箱即用，迅速上手，让开发人员关注业务而非配置。

1.2.为什么要学习Spring Boot

java一直被人诟病的一点就是臃肿、麻烦。当我们还在辛苦的搭建项目时，可能Python程序员已经把功能写好了，究其原因注意时两点：

• 复杂的配置

  项目各种配置其实是开发时的损耗，因为在思考Spring特性配置和解决业务问题之间需要进行思维切换，所以写配置挤占了写应用逻辑的时间。

• 混乱的依赖管理

  项目的依赖管理也是件吃力不讨好的事情。决定项目里要用哪些库就已经够让人头痛的了，你还要知道这些库的哪个版本和其他库不会有冲突，这实在棘手。而且依赖管理也是种耗损，添加依赖不是写应用程序代码。一旦选错了版本，随之而来的不兼容问题毫无疑问会是生产力杀手。

而Spring Boot让这一切成为过去！
Spring Boot简化了基于Spring的应用开发，只需要“run”就能创建一个独立的、生产级别的Spring应用。Spring Boot为Spring平台及第三方库提供了开箱即用的设置（提供默认设置，存放默认配置的包就是启动器starter），这样我们就可以简单的开始。多数Spring Boot应用只需要很少的Spring配置。
我们可以使用Spring Boot创建java应用，并使用java-jar启动它，就可以得到一个生产级别的web工程。

1.3.Spring Boot的特点

• 创建独立的Spring应用，为所有Spring的开发者提供一个非常快速的、广泛接受的入门体验。
• 直接嵌入应用服务器，如tomcat、jetty、undertow等；不需要去部署war包。
• 提供固定的启动器依赖去简化主键配置；实现开箱即用（启动器starter-其实就是Spring Boot提供的一个jar包），通过自己设置参数（.properies或.yml的配置文件），即可快速使用。
• 自动的配置Spring和其它有需要的第三方依赖。
• 提供了一些大型项目中常见的肺功能性特性，如内嵌服务器、安全、指标、健康检测、外部化配置等。
• 绝对没有代码生成，也无需XML配置。

2. Spring Boot入门

目标：能够使用Spring Boot搭建项目

分析：

需求：可以在浏览器中访问http://localhost:8080/hello输出一串字符

实现步骤：

1. 创建工程；

2. 添加依赖（启动器依赖，spring-boot-starter-web）；

3. 创建启动类；

4. 创建处理器Controller；

5. 测试

1、创建工程

2、添加依赖

<?xml version="1.0" encoding="UTF-8"?>
<project xmlns="http://maven.apache.org/POM/4.0.0"
         xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
         xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/xsd/maven-4.0.0.xsd">
    <modelVersion>4.0.0</modelVersion>
    //引入父工程
    <parent>
        <groupId>org.springframework.boot</groupId>
        <artifactId>spring-boot-starter-parent</artifactId>
        <version>2.1.5.RELEASE</version>
    </parent>
    <groupId>org.example</groupId>
    <artifactId>Springboot</artifactId>
    <version>1.0-SNAPSHOT</version>

    //jdk版本号
    <properties>
        <java.version>13</java.version>
    </properties>

    //spring boot启动器
    <dependencies>
    <dependency>
        <groupId>org.springframework.boot</groupId>
        <artifactId>spring-boot-starter-web</artifactId>
    </dependency>
    </dependencies>

</project>

3、创建启动类

package com.itheima;

import org.springframework.boot.SpringApplication;
import org.springframework.boot.autoconfigure.SpringBootApplication;

/**
 * @version V1.0
 * @author: wusier
 * @date: 2020/10/26 14:27
 * @Description: Spring
 * @modifiedBy：
 */
//springboot工程都有一个启动引导类，这是工程的入口类并在引导类上添加
@SpringBootApplication
public class Application {
    public static void main(String[] args) {
        SpringApplication.run(Application.class, args);
    }
}

4、创建处理器Controller

@RestController标注它是一个处理器，@RestController是一个组合注解，组合了@ResponseBody，所以这个类的所有方法里面的返回结果都当作一个字符内容输出。

package com.itheima.controller;

import org.springframework.web.bind.annotation.GetMapping;
import org.springframework.web.bind.annotation.RestController;

/**
 * @version V1.0
 * @author: wusier
 * @date: 2020/10/26 14:32
 * @Description: Spring
 * @modifiedBy：
 */
@RestController
public class HelloController {
    @GetMapping("hello")
    public String hello(){
        return "hello,springboot";
    }
}

5、测试

运行启动引导类

小结：

Spring Boot工程可以通过添加启动器依赖和创建启动引导类实现快速创建web工程。

spring-boot-starter-web默认的应用服务器端口是8080

3.java代码方式配置

目标：可以使用@Value获取配置文件配置项并结合@Bean注册组件到Spring

3.1.Spring配置历史

在Spring3.0开始，Spring官方就已经开始推荐使用java配置来代替传统的xml配置了，我们不妨回顾一下Spring的历史：

• Spring1.0时代
  在此时因为jdk1.5刚刚出来，注解开发尚未盛行，因此一切Spring配置都是xml格式。
• Spring2.0时代
  Spring引入了注解开发，但是因为并不完善，因此并未完全替代xml，此时的程序员往往把xml与注解进行结合。
• Spring3.0及以后
  3.0以后Spring的注解已经非常完善了，因此Spring推荐大家使用完全的java配置来替代以前的xml，不过似乎在国内并未推广盛行。然后当Spring Boot来临，人们才慢慢认识到java配置的优雅。

3.2.尝试java配置

java配置主要靠java类和一些注解，比较常用的注解有：

• @Configuration：声明一个类最为配置类，代替xml文件
• @Bean：声明在方法上，将方法的返回值加入Bean容器，代替标签
• @Value：属性注入
• @PropertySouce：指定外部属性文件

目标：可以使用@Value获取配置文件配置项并结合@Bean注册组件到Spring

分析：

需求：使用Java代码配置数据库连接池，并可以在处理器中注入并使用

步骤：

1. 添加依赖；

2. 创建数据库；

3. 创建数据库连接参数的配置文件jdbc.properties；

4. 创建配置类；

5. 改造处理器类注入数据源并使用

1. 在 pom.xml 文件中添加Druid连接池依赖如下

        <dependency>
            <groupId>com.alibaba</groupId>
            <artifactId>druid</artifactId>
            <version>1.1.6</version>
        </dependency>

2. 使用数据操作工具创建数据库 springboot_test

3. 然后在项目中创建 heima-springboot\src\main\resources\jdbc.properties 文件，内容如下

jdbc.driverClassName=com.mysql.Driver
jdbc.url=jdbc:mysql://127.0.0.1/spring_test
jdbc.username=root
jdbc.password=123456

4. 编写 heima-springboot\src\main\java\com\itheima\config\JdbcConfig.java 如下

package com.itheima.config;

import com.alibaba.druid.pool.DruidDataSource;
import org.springframework.beans.factory.annotation.Value;
import org.springframework.context.annotation.Bean;
import org.springframework.context.annotation.Configuration;
import org.springframework.context.annotation.PropertySource;

import javax.sql.DataSource;

/**
 * @version V1.0
 * @author: wusier
 * @date: 2020/10/26 17:00
 * @Description: Spring
 * @modifiedBy：
 */
@Configuration
@PropertySource("classpath:jdbc.properties")
public class JdbcConfig {
    @Value("${jdbc.url}")
    String url;
    @Value("${jdbc.driverClassName}")
    String driverClassname;
    @Value("${jdbc.username}")
    String username;
    @Value("${jdbc.password")
    String password;

    @Bean
    public DataSource dataSource(){
        DruidDataSource dataSource=new DruidDataSource();
        dataSource.setDriverClassName(driverClassname);
        dataSource.setUrl(url);
        dataSource.setUsername(username);
        dataSource.setPassword(password);
        return dataSource;
    }
}

解读：
@Configuration ：声明我们 JdbcConfig 是一个配置类

@PropertySource ：指定属性文件的路径是: classpath:jdbc.properties

通过 @Value 为属性注入值

通过 @Bean将 dataSource() 方法声明为一个注册Bean的方法，Spring会自动调用该方法，将方法的返回值 加入Spring容器中。
然后我们就可以在任意位置通过 @Autowired 注入DataSource了！
 
5. 在 HelloController 中注入DataSource进行测试，改造代码如下：

package com.itheima.controller;

import org.springframework.beans.factory.annotation.Autowired;
import org.springframework.web.bind.annotation.GetMapping;
import org.springframework.web.bind.annotation.RestController;

import javax.sql.DataSource;

/**
 * @version V1.0
 * @author: wusier
 * @date: 2020/10/26 14:32
 * @Description: Spring
 * @modifiedBy：
 */
@RestController
public class HelloController {
    @Autowired
    private DataSource dataSource;

    @GetMapping("hello")
    public String hello(){
        System.out.println("dataSource="+dataSource);
        return "hello,springboot";
    }
}

属性注入成功了！

4. Spring Boot属性注入方式

目标：能够使用@ConfigurationProperties实现Spring Boot配置文件配置项读取和应用

需求：将配置文件中的配置项读取到一个对象中；

实现：可以使用Spring Boot提供的注解@ConfigurationProperties，该注解可以将Spring Boot的配置文件（默认必须为application.properties或application.yml）中的配置项读取到一个对象中。

实现步骤：

1. 创建配置项类JdbcProperties类，在该类名上面添加@ConfigurationProperties；

2. 将jdbc.properties修改名称为application.properties；

3. 将JdbcProperties对象注入到JdbcConfig；

4. 测试

小结：

• 使用@ConfigurationProperties编写配置项类将配置文件中的配置项设置到对象中

• 使用@ConfigurationProperties在方法上面使用

1）新建 heima-springboot\src\main\java\com\itheima\config\JdbcProperties.java ，用于进行属性注入：

package com.itheima.config;

/**
 * ConfigurationProperties 从application配置文件中读取配置项
 * prefix 表示 配置项的前缀
 * 配置项类中的类变量名必须要与 前缀之后的配置项名称保持 松散绑定（相同）
 */
@ConfigurationProperties(prefix = "jdbc")
public class JdbcProperties {

    private String url;
    private String driverClassName;
    private String username;
    private String password;

    public String getUrl() {
        return url;
    }

    public void setUrl(String url) {
        this.url = url;
    }

    public String getDriverClassName() {
        return driverClassName;
    }

    public void setDriverClassName(String driverClassName) {
        this.driverClassName = driverClassName;
    }

    public String getUsername() {
        return username;
    }

    public void setUsername(String username) {
        this.username = username;
    }

    public String getPassword() {
        return password;
    }

    public void setPassword(String password) {
        this.password = password;
    }
}

• 在类上通过@ConfigurationProperties注解声明当前类为属性读取类
• prefix="jdbc" 读取属性文件中，前缀为jdbc的值。
• 在类上定义各个属性，名称必须与属性文件中 jdbc. 后面部分一致
• 需要注意的是，这里我们并没有指定属性文件的地址，所以我们需要把jdbc.properties名称改为 application.properties，这是Spring Boot默认读取的属性文件名：

【注意】如果出现如下提示，项目也可以运行；

如果要去掉上述的提示，则可以在 pom.xml 文件中添加如下依赖

        <dependency>
            <groupId>org.springframework.boot</groupId>
            <artifactId>spring-boot-configuration-processor</artifactId>
            <!--不传递依赖-->
            <optional>true</optional>
        </dependency>

2）将 JdbcConfig 类原来全部注释掉或删除，修改为如下内容：

package com.itheima.config;

@Configuration
//@PropertySource("classpath:jdbc.properties")
@EnableConfigurationProperties(JdbcProperties.class)
public class JdbcConfig {
    @Bean
    public DataSource dataSource(JdbcProperties jdbcProperties) {
        DruidDataSource dataSource = new DruidDataSource();
        dataSource.setDriverClassName(jdbcProperties.getDriverClassName());
        dataSource.setUrl(jdbcProperties.getUrl());
        dataSource.setUsername(jdbcProperties.getUsername());
        dataSource.setPassword(jdbcProperties.getPassword());
        return dataSource;
    }
}

通过 @EnableConfigurationProperties(JdbcProperties.class) 来声明要使用 JdbcProperties 这个类的对象

然后要使用配置的话；可以通过以下方式注入JdbcProperties：

优势：
Relaxed binding：松散绑定

• 不严格要求属性文件中的属性名与成员变量名一致。支持驼峰，中划线，下划线等等转换，甚至支持对象引导。比如：user.friend.name：代表的是user对象中的friend属性中的name属性，显然friend也是对 象。@value注解就难以完成这样的注入方式。
• meta-data support：元数据支持，帮助IDE生成属性提示（写开源框架会用到）。

4.1更优雅的注入

事实上，如果一段属性只有一个Bean需要使用，我们无需将其注入到一个类（JdbcProperties，将该类上的所有注解去掉）中。而是直接在需要的地方声明即可；再次修改 JdbcConfig 类为如下代码：

我们直接把 @ConfigurationProperties(prefix = "jdbc") 声明在需要使用的 @Bean 的方法上，然后Spring Boot就会自动调用这个Bean（此处是DataSource）的set方法，然后完成注入。使用的前提是：该类必须有对应属性的set方法！

5. 多个yml文件配置

配置文件除了可以使用application.properties类型，还可以使用后缀名为：.yml或者.yaml的类型，也就是： application.yml或者application.yaml

基本格式：

jdbc:
  driverClassName: com.mysql.jdbc.Driver
  url: jdbc:mysql://127.0.0.1:3306/springboot_test
  username: root
  password: root

分析：

yaml与properties配置文件除了展示形式不相同以外，其它功能和作用都是一样的；在项目中原路的读取方式不需要改变。

1）yml配置文件的特征：

1. 树状层级结构展示配置项；

2. 配置项之间如果有关系的话需要分行空两格；

3. 配置项如果有值的话，那么需要在 :之后空一格再写配置项值；

将application.properties配置文件修改为application.yml的话：

jdbc:
  driverClassName: com.mysql.jdbc.Driver
  url: jdbc:mysql://127.0.0.1:3306/heima
  username: root
  password: root

key:
  abc: cba
  def:
    - g
    - h
    - j

2）多个yml配置文件；在spring boot中是被允许的。这些配置文件的名称必须为application-***.yml，并且这些配置文件必须要在application.yml配置文件中激活之后才可以使用。

3）如果properties和yml配置文件同时存在在spring boot项目中；那么这两类配置文件都有效。在两个配置文件中如果存在同名的配置项的话会以properties文件的为主。

jdbc:
  driverClassName: com.mysql.jdbc.Driver
  url: jdbc:mysql://127.0.0.1:3306/springboot_test
  username: root
  password: root

#激活配置文件；需要指定其他的配置文件名称
spring:
  profiles:
    active: abc,def

小结：

在多个配置文件时，需要将这些文件在application.yml文件中进行激活：

#激活配置文件;需要指定其它的配置文件名称
spring:
  profiles:
    active: abc,def