Spring Boot入门学习
阅读原文时间:2023年07月09日阅读:1

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

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

  • 复杂的配置

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

  • 混乱的依赖管理

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

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

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

目标:能够使用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

在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配置的优雅。

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";
    }
}

属性注入成功了!

目标:能够使用@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方法!

配置文件除了可以使用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