SpringBoot基础

一、Spring Boot项目的创建

1、创建Maven工程(需指定父工程坐标)

 Spring Boot提供了一个名为spring-boot-starter-parent
的工程，里面已经对各种常用依赖（并非全部）的版本进行了管理，我们的项目需要以这个项目为父工程，这样我们
就不用操心依赖的版本问题了，需要什么依赖，直接引入坐标即可！

<!--父工程坐标-->
<parent>
    <groupId>org.springframework.boot</groupId>
    <artifactId>spring-boot-starter-parent</artifactId>
    <version>2.1.5.RELEASE</version>
</parent>

2、添加依赖（spring-boot-starter-web）

 让Spring Boot帮我们完成各种自动配置，我们必须引入Spring Boot提供的自动配置依赖，我们称为 启动器（starter） 。因为是web项目，所以引入web启动器。

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

  需要注意的是，并没有在这里指定版本信息。因为Spring Boot的父工程已经对版本进行了管理了。

  这个时候，项目中多出了大量的依赖。

  那些依赖都是Spring Boot根据 spring-boot-starter-web 这个依赖自动引入的，而且所有的版本都已经管理好，不会出现冲突。

3、管理jdk版本

<properties>
    <java.version>1.8</java.version>
</properties>

4、启动类Application

//Springboot项目启动器
@SpringBootApplication
//通用mapper扫描组件,必须导tk.mybatis.spring.annotation.MapperScan这个包
@MapperScan("cn.rewind.mapper")
public class Application {
    public static void main(String[] args) {

        SpringApplication.run(Application.class,args);
    }
}

@SpringBootApplication：Spring Boot项目的核心注解，主要目的是开启自动配置。

5、编写controller

@RestController
public class HelloController {
    @GetMapping("hello")
    public String hello(){
        return "hello, spring boot!";
    }
}

@RestController是组合注解，相当于@ResponseBody ＋ @Controller合在一起的作用

1. 如果只是使用@RestController注解Controller，则Controller中的方法无法返回jsp页面，配置的视图解析器InternalResourceViewResolver不起作用，返回的内容就是Return 里的内容。

例如：本来应该到success.jsp页面的，则其显示success.

2. 如果需要返回到指定页面，则需要用 @Controller配合视图解析器InternalResourceViewResolver才行。
3. 如果需要返回JSON，XML或自定义mediaType内容到页面，则需要在对应的方法上加上@ResponseBody注解。

6、测试

1. 监听的端口是8080
2. SpringMVC的项目路径是：空
3. /hello 路径已经映射到了 HelloController 中的 hello() 方法

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

二、java配置

1、常用的java配置注解

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

2、配置连接池

导入依赖

<!--添加数据库连接池-->
<dependency>
    <groupId>com.alibaba</groupId>
    <artifactId>druid</artifactId>
    <version>1.1.6</version>
</dependency>

方法一（了解）：java代码方式配置

(1)创建src\main\resources\jdbc.properties配置文件

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

(2)编写配置类src\main\java\com\rewind\config\JdbcConfig.java

@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了！

(3)编写Controller

@RestController
public class HelloController {
    @Autowired
    private DataSource dataSource;
    @GetMapping("hello")
    public String hello() {
        //此处打断点，输出dataSource则注入成功
        System.out.println("dataSource = " + dataSource);
        return "hello, spring boot!";
    }
}

方法二（了解）：SpringBoot属性注入方式配置

属性文件的名称有变化，默认的文件名必须是：application.properties或application.yml

在上面的案例中，我们实验了java配置方式。不过属性注入使用的是@Value注解。这种方式虽然可行，但是不够强大，因为它只能注入基本类型值。

在Spring Boot中，提供了一种新的属性注入方式，支持各种java基本数据类型及复杂类型的注入。

(1)新建main\java\com\rewind\config\JdbcProperties.java配置文件

@ConfigurationProperties(prefix = "jdbc")
public class JdbcProperties {

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

    //省略getter和setter
}

在类上通过@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

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

通过 @EnableConfigurationProperties(JdbcProperties.class) 来声明要使用 JdbcProperties 这个类的对象。
然后要使用配置的话；可以通过以下方式注入JdbcProperties：

第三种方式，也是Spring Boot推荐的注入方式，相比于@Value

优势：
Relaxed binding：松散绑定
不严格要求属性文件中的属性名与成员变量名一致。支持驼峰，中划线，下划线等等转换，甚至支持对象引导。

比如：user.friend.name：代表的是user对象中的friend属性中的name属性，显然friend也是对象。@value注解就难以完成这样的注入方式。

meta-data support：元数据支持，帮助IDE生成属性提示（写开源框架会用到）。

改进代码

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

@Configuration
public class JdbcConfig {
    @Bean
    // 声明要注入的属性前缀，Spring Boot会自动把相关属性通过set方法注入到    DataSource中
    @ConfigurationProperties(prefix = "jdbc")
    public DataSource dataSource() {
        return new DruidDataSource();
}
}

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

(3)测试

方法三（重要）：yml或yaml配置文件

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

yml配置文件：为树状结构，冒号后加个空格才能接属性值
二级属性前必须加2个空格

jdbc:
  driverClassName: com.mysql.jdbc.Driver
  url: jdbc:mysql://localhost:3306/test
  username: root
  password: 211964

把application.properties修改为application.yml进行测试。

如果两个配置文件都有，会把两个文件的配置合并，如果有重复属性，以properties中的为准。
如果是配置数组、list、set等结构的内容，那么在yml文件中格式为：
key:
- value1
- value2

多个yml配置文件

当一个项目中有多个yml配置文件的时候，可以以application-**.yml命名；在application.yml中配置项目使用激活这些配置文件即可。

创建 application-abc.yml
创建 application-def.yml

rewind:
  name: lalalala

在 application.yml 文件中添加如下配置：

#加载其它配置文件
spring:
  profiles:
    active: abc,def

多个文件名只需要写application-之后的名称，在多个文件之间使用,隔开。

测试

@RestController
public class HelloController {

    @Value("${rewind.name}")
    private String rewindName;
    System.out.println(rewindName);
}

三、自动配置

1）启动器
所以，我们如果不想配置，只需要引入依赖即可，而依赖版本我们也不用操心，因为只要引入了SpringBoot提供的stater（启动器），就会自动管理依赖及版本了。

因此，玩SpringBoot的第一件事情，就是找启动器，SpringBoot提供了大量的默认启动器

2）全局配置
另外，SpringBoot的默认配置，都会读取默认属性，而这些属性可以通过自定义 application.properties 文件来进行覆盖。这样虽然使用的还是默认配置，但是配置中的值改成了我们自定义的。

因此，玩SpringBoot的第二件事情，就是通过 application.properties 来覆盖默认属性值，形成自定义配置。我们需要知道SpringBoot的默认属性key，非常多，可以再idea中自动提示属性文件支持两种格式，application.properties和application.yml

如果properties和yml文件都存在，如果有重叠属性，默认以Properties优先。

修改的组件的配置项流程为：

在 META-INF\spring.fatories文件中定义了很多自动配置类；可以根据在pom.xml文件中添加的 启动器依赖自动配置组件

四、YML语法

1、基本语法

• key: value；kv之间有空格

• 大小写敏感

• 使用缩进表示层级关系

• 缩进不允许使用tab，只允许空格

• 缩进的空格数不重要，只要相同层级的元素左对齐即可

• ‘#’表示注释

• 字符串无需加引号，如果要加，’’与””表示字符串内容 会被 转义/不转义

2、数据类型

• 字面量：单个的、不可再分的值。date、boolean、string、number、null

k: v

• 对象：键值对的集合。map、hash、set、object

#行内写法：  
k: {k1:v1,k2:v2,k3:v3}
#或
k: 
  k1: v1
  k2: v2
  k3: v3

• 数组：一组按次序排列的值。array、list、queue

#行内写法：  
k: [v1,v2,v3]
#或者
k:
 - v1
 - v2
 - v3

案例

# yaml表示以上对象
person:
  userName: zhangsan
  boss: false
  birth: 2019/12/12 20:12:33
  age: 18
  pet: 
    name: tomcat
    weight: 23.4
  interests: [篮球,游泳]
  animal: 
    - jerry
    - mario
  score:
    english: 
      first: 30
      second: 40
      third: 50
    math: [131,140,148]
    chinese: {first: 128,second: 136}
  salarys: [3999,4999.98,5999.99]
  allPets:
    sick:
      - {name: tom}
      - {name: jerry,weight: 47}
    health: [{name: mario,weight: 47}]

五、Spring Boot项目访问jsp

需导入依赖

<!-- 添加servlet依赖模块 -->
        <dependency>
            <groupId>javax.servlet</groupId>
            <artifactId>javax.servlet-api</artifactId>
            <scope>provided</scope>
        </dependency>
        <!-- 添加jstl标签库依赖模块 -->
        <dependency>
            <groupId>javax.servlet</groupId>
            <artifactId>jstl</artifactId>
        </dependency>
        <!-- springboot内置tomcat没有此依赖 -->
        <dependency>
            <groupId>org.apache.tomcat.embed</groupId>
            <artifactId>tomcat-embed-jasper</artifactId>
            <scope>provided</scope>
        </dependency>

六、访问静态资源

1、静态资源目录

只要静态资源放在类路径下： called /static (or /public or /resources or /META-INF/resources

访问 ： 当前项目根路径/ + 静态资源名

原理： 静态映射/**。

请求进来，先去找Controller看能不能处理。不能处理的所有请求又都交给静态资源处理器。静态资源也找不到则响应404页面

改变默认的静态资源路径

spring:
  mvc:
    static-path-pattern: /res/**

  resources:
    static-locations: [classpath:/haha/]

2、静态资源访问前缀

默认无前缀

spring:
  mvc:
    static-path-pattern: /res/**

3、欢迎页支持

• 静态资源路径下 index.html

• • 可以配置静态资源路径
  • 但是不可以配置静态资源的访问前缀。否则导致 index.html不能被默认访问

spring:
#  mvc:
#    static-path-pattern: /res/**   这个会导致welcome page功能失效

  resources:
    static-locations: [classpath:/haha/]

controller能处理/index

4、自定义 Favicon

favicon.ico 放在静态资源目录下即可。

spring:
#  mvc:
#    static-path-pattern: /res/**   这个会导致 Favicon 功能失效

5、静态资源配置原理

• SpringBoot启动默认加载 xxxAutoConfiguration 类（自动配置类）
• SpringMVC功能的自动配置类 WebMvcAutoConfiguration，生效

@Configuration(proxyBeanMethods = false)
@ConditionalOnWebApplication(type = Type.SERVLET)
@ConditionalOnClass({ Servlet.class, DispatcherServlet.class, WebMvcConfigurer.class })
@ConditionalOnMissingBean(WebMvcConfigurationSupport.class)
@AutoConfigureOrder(Ordered.HIGHEST_PRECEDENCE + 10)
@AutoConfigureAfter({ DispatcherServletAutoConfiguration.class, TaskExecutionAutoConfiguration.class,
        ValidationAutoConfiguration.class })
public class WebMvcAutoConfiguration {}