零、学习目标
1、掌握application.properties配置文件
2、掌握application.yaml配置文件
3、掌握使用@ConfigurationProperties注入属性
4、掌握使用@Value注入属性
一、全局配置文件概述
全局配置文件能够对一些默认配置值进行修改。Spring Boot使用一个application.properties或者application.yaml的文件作为全局配置文件,该文件存放在src/main/resource目录或者类路径的/config,一般会选择resource目录。

二、Application.properties配置文件

(一)创建Spring Boot的Web项目PropertiesDemo

利用Spring Initializr方式创建项目

设置项目元数据

spring boot 全局共享变量 springboot 全局变量存储_配置文件


添加测试与依赖

spring boot 全局共享变量 springboot 全局变量存储_运行测试_02


设置项目名称及保存位置

spring boot 全局共享变量 springboot 全局变量存储_spring_03


(二)在application.properties里添加相关配置

点开resource目录,查看应用程序属性配置文件

spring boot 全局共享变量 springboot 全局变量存储_运行测试_04


1、配置tomcat端口号和web虚拟路径

#修改tomcat默认端口号
server.port=8888
#修改web虚拟路径
server.servlet.context-path=/lzy

spring boot 全局共享变量 springboot 全局变量存储_配置文件_05


spring boot 全局共享变量 springboot 全局变量存储_配置文件_06

更多配置属性,详见官网https://docs.spring.io/spring-boot/docs/current/reference/html/common-application-properties.html

2、对象类型的配置与使用

(1)创建Pet类

spring boot 全局共享变量 springboot 全局变量存储_配置文件_07

package net.zl.lesson03.bean;
/**
 * 功能:宠物类
 * 作者:周璐
 * 日期:2021年04月28日
 */
public class Pet {
    private String type; //类型
    private String name; //名字

    public String getType() {
        return type;
    }

    public void setType(String type) {
        this.type = type;
    }

    public String getName() {
        return name;
    }

    public void setName(String name) {
        this.name = name;
    }

    @Override
    public String toString() {
        return "Pet{" +
                "type='" + type + '\'' +
                ", name='" + name + '\'' +
                '}';
    }
}

(2)创建Person类

spring boot 全局共享变量 springboot 全局变量存储_运行测试_08

package net.zl.lesson03.bean;

import org.springframework.boot.context.properties.ConfigurationProperties;
import org.springframework.stereotype.Component;

import java.util.List;
import java.util.Map;

/**
 * 功能:人类
 * 作者:周璐
 * 日期:2021年04月28日
 */
public class Person {
    private int id;
    private String name; //姓名
    private List<String> hobby; //爱好
    private Map<String,String> family; //家庭成员
    private Pet pet; //宠物

    public int getId() {
        return id;
    }

    public void setId(int id) {
        this.id = id;
    }

    public String getName() {
        return name;
    }

    public void setName(String name) {
        this.name = name;
    }

    public List<String> getHobby() {
        return hobby;
    }

    public void setHobby(List<String> hobby) {
        this.hobby = hobby;
    }

    public Map<String, String> getFamily() {
        return family;
    }

    public void setFamily(Map<String, String> family) {
        this.family = family;
    }

    public Pet getPet() {
        return pet;
    }

    public void setPet(Pet pet) {
        this.pet = pet;
    }

    @Override
    public String toString() {
        return "Person{" +
                "id=" + id +
                ", name='" + name + '\'' +
                ", hobby=" + hobby +
                ", family=" + family +
                ", pet=" + pet +
                '}';
    }
}

(3)在application.properties里配置对象

#配置对象
person.id=1
person.name=张三丰
person.hobby=旅游,美食,音乐
person.family.father=张云光
person.family.mother=吴文燕
person.family.grandpa=张宏宇
person.famliy.grandma=唐雨欣
person.family.son=张君宝
person.family.daughter=张晓敏
person.pet.type=泰迪犬
person.pet.name=瑞瑞

spring boot 全局共享变量 springboot 全局变量存储_spring_09


(4)给Person类添加注解

spring boot 全局共享变量 springboot 全局变量存储_运行测试_10


注意:采用@ConfigurationProperties注解方式,必须要有set方法,才会自动为Person类所有属性注入相应的值,包括简单类型和复杂类型

(5)给Pet类添加注解

添加注解@Component,交给Spring去管理

添加注解@ConfigurationProperties(prefix = “person.pet”) - 可以不用添加

spring boot 全局共享变量 springboot 全局变量存储_spring_11


(6)从Spring容器里获取Person类的实例并输出

实现接口ApplicationContextAware,实现其抽象方法setApplicationContext

spring boot 全局共享变量 springboot 全局变量存储_运行测试_12


声明ApplicationContext对象,并在setApplicationContext里初始化

spring boot 全局共享变量 springboot 全局变量存储_spring boot 全局共享变量_13


从Spring容器中获取Person类的实例并输出

spring boot 全局共享变量 springboot 全局变量存储_运行测试_14


运行测试类,查看结果

出现了乱码

spring boot 全局共享变量 springboot 全局变量存储_运行测试_15


(7)解决输出结果的汉字乱码问题

使用JDK工具native2ascii.exe将汉字处理成uncode编码

spring boot 全局共享变量 springboot 全局变量存储_spring boot 全局共享变量_16

Microsoft Windows [版本 10.0.18363.900]
(c) 2019 Microsoft Corporation。保留所有权利。

D:\IdeaProjects\PropertiesDemo>cd src/main/resources

D:\IdeaProjects\PropertiesDemo\src\main\resources>native2ascii -encodi
ng utf8 application.properties
#\u4fee\u6539tomcat\u9ed8\u8ba4\u7aef\u53e3\u53f7
server.port=8888
#\u4fee\u6539web\u865a\u62df\u8def\u5f84
server.servlet.context-path=/lzy

#\u914d\u7f6e\u5bf9\u8c61
person.id=1
person.name=\u5f20\u4e09\u4e30
person.hobby=\u65c5\u6e38,\u7f8e\u98df,\u97f3\u4e50
person.family.father=\u5f20\u4e91\u5149
person.family.mother=\u5434\u6587\u71d5
person.family.grandpa=\u5f20\u5b8f\u5b87
person.famliy.grandma=\u5510\u96e8\u6b23
person.family.son=\u5f20\u541b\u5b9d
person.family.daughter=\u5f20\u6653\u654f
person.pet.type=\u6cf0\u8fea\u72ac
person.pet.name=\u745e\u745e

D:\IdeaProjects\PropertiesDemo\src\main\resources>

注意:你项目的编码也得是utf8或者上面进行编码的时候要与其设置的一样。

修改application.properties文件,汉字采用unicode编码形式

spring boot 全局共享变量 springboot 全局变量存储_spring boot 全局共享变量_17


运行测试类PropertiesDemoApplicationTests,查看结果

spring boot 全局共享变量 springboot 全局变量存储_配置文件_18


(8)从Spring容器里获取Pet类的实例并输出

在测试类里添加测试方法testPet()

spring boot 全局共享变量 springboot 全局变量存储_spring boot 全局共享变量_19


运行测试方法testPet(),查看结果

spring boot 全局共享变量 springboot 全局变量存储_配置文件_20


去掉Pet类的配置属性的注解@ConfigurationProperties(prefix = “person.pet”)

spring boot 全局共享变量 springboot 全局变量存储_spring boot 全局共享变量_21


运行测试方法testPet(),查看结果

宠物的属性值没有被注入

spring boot 全局共享变量 springboot 全局变量存储_配置文件_22


修改application.properties,配置宠物对象

spring boot 全局共享变量 springboot 全局变量存储_配置文件_23


再次运行测试方法testPet(),查看结果

spring boot 全局共享变量 springboot 全局变量存储_配置文件_24


大家可以看到,宠物对象的属性依然没有被注入,下面我们换一种属性注解的方式,采用@Value注解方式。

给Pet类的属性添加值注解@Value

spring boot 全局共享变量 springboot 全局变量存储_spring boot 全局共享变量_25


再次运行测试方法testPet(),查看结果

通过@Value注解给实体类的每个属性注入值

spring boot 全局共享变量 springboot 全局变量存储_配置文件_26


3、两种属性注解方式的对比

采用@ConfigurationProperties注解方式,必须要有set方法,才会自动为所注解的类的全部属性注入相应的值,包括简单类型和复杂类型(List、Map、Pet……)。

采用@Value注解方式,优点在于可以不要set方法,但是有两点不足:其一、需要一个一个地注入,显得麻烦;其二、对于复杂类型不能注入,比如Map、List、Pet等。

三、Application.yaml配置文件

1、备份application.properties文件

文件更名为application.back,即让此文件不起作用

spring boot 全局共享变量 springboot 全局变量存储_配置文件_27

2、在resoures目录里创建application.yaml文件

创建application.yaml文件

spring boot 全局共享变量 springboot 全局变量存储_配置文件_28


配置服务器属性

spring boot 全局共享变量 springboot 全局变量存储_运行测试_29


配置person对象属性

spring boot 全局共享变量 springboot 全局变量存储_运行测试_30


配置pet对象属性

spring boot 全局共享变量 springboot 全局变量存储_配置文件_31


查看application.yaml文件内容

#配置服务器
server:
  port: 8888
  servlet:
    context-path: /lzy

#配置person对象
person:
  id: 1
  name: 张三丰
  hobby:
    旅游
    美食
    音乐
  family: {
    father: 张云光,
    mother: 吴文燕,
    grandpa: 张宏宇,
    grandma: 唐雨欣,
    son: 张君宝,
    daughter: 张晓敏
  }
  pet:
    type: 泰迪犬
    name: 瑞瑞

#配置pet对象
pet:
  type: 泰迪犬
  name: 瑞瑞

3、运行测试方法testPerson(),查看结果

spring boot 全局共享变量 springboot 全局变量存储_spring boot 全局共享变量_32


4、运行测试方法testPet(),查看结果

spring boot 全局共享变量 springboot 全局变量存储_spring boot 全局共享变量_33


四、两种配置文件的比较

1、application.properties配置文件

采用XML语法,键值对:键=值,没有层次结构

如果值里有汉字,必须得转成unicode,否则会出现乱码问题

2、application.yaml配置文件

采用YAML语法,键值对:键: 值(冒号与值之间有空格),具有层次结构

允许值里有汉字,不必转成unicode,也不会出现乱码问题

五、课后作业

任务:修改StudentInfo项目输出学生信息

创建学生实体类Student

spring boot 全局共享变量 springboot 全局变量存储_配置文件_34


添加属性

添加getter和setter

添加toString()方法

添加注解@Component

添加注解@ConfigureProperties

package net.zl.lesson01.bean;

import org.springframework.boot.context.properties.ConfigurationProperties;
import org.springframework.stereotype.Component;
/**
 * 功能:学生类
 * 作者:周璐
 * 日期:2021年04月28日
 */

@Component
@ConfigurationProperties(prefix = "student")
public class Student {
    private String id;
    private String name;
    private String gender;
    private int age;
    private String major;
    private String telephone;
    private String email;
    private String hobby;

    public String getId() {
        return id;
    }

    public void setId(String id) {
        this.id = id;
    }

    public String getName() {
        return name;
    }

    public void setName(String name) {
        this.name = name;
    }

    public String getGender() {
        return gender;
    }

    public void setGender(String gender) {
        this.gender = gender;
    }

    public int getAge() {
        return age;
    }

    public void setAge(int age) {
        this.age = age;
    }

    public String getMajor() {
        return major;
    }

    public void setMajor(String major) {
        this.major = major;
    }

    public String getTelephone() {
        return telephone;
    }

    public void setTelephone(String telephone) {
        this.telephone = telephone;
    }

    public String getEmail() {
        return email;
    }

    public void setEmail(String email) {
        this.email = email;
    }

    public String getHobby() {
        return hobby;
    }

    public void setHobby(String hobby) {
        this.hobby = hobby;
    }

    @Override
    public String toString() {
        return "Student{" +
                "id='" + id + '\'' +
                ", name='" + name + '\'' +
                ", gender='" + gender + '\'' +
                ", age=" + age +
                ", major='" + major + '\'' +
                ", telephone='" + telephone + '\'' +
                ", email='" + email + '\'' +
                ", hobby='" + hobby + '\'' +
                '}';
    }
}

将application.properties更名为application.yaml

spring boot 全局共享变量 springboot 全局变量存储_配置文件_35


配置student对象属性

spring boot 全局共享变量 springboot 全局变量存储_spring_36


修改控制器StudentInfoController,student()方法里返回student的值

运行启动类

在浏览器里访问http://localhost:8080/student