SpringBoot笔记01

第1章 Spring Boot概要

1.1 SpringBoot介绍

随着动态语言的流行（Ruby、Scala、Node.js）, Java的开发显得格外的笨重；繁多的配置、低下的开发效率、复杂的部署流程以及第三方技术整合难度大。在上述环境下，Spring Boot由此诞生，它的设计是为了使您能够尽可能快地启动和运行。它使用 “习惯优于配置” （项目中存在大量的配置，而 Spring Boot 内置一个习惯性的配置，让你无须手动进行配置）的理念让你的项目快速运行起来。使用 Spring Boot 很容易创建一个独立运行（运行jar，内嵌 Servlet 容器）、准生产强力的基于 Spring 框架的项目，使用 Spring Boot你可以不用或者只需要很少的 Spring 配置。提供了 J2EE 开发的一站式解决方案。

2014 年 4 月，Spring Boot 1.0.0 发布。Spring的顶级项目之一(https://spring.io)。

1.2 SpringBoot优点

Create stand-alone Spring applications
- 创建独立Spring应用
Embed Tomcat, Jetty or Undertow directly (no need to deploy WAR files)
- 内嵌web服务器
Provide opinionated 'starter' dependencies to simplify your build configuration
- 自动starter依赖，简化构建配置
- 起步依赖，起步依赖本质上是一个Maven项目对象模型（Project Object Model，POM），定义了对其他库的传递依赖，这些东西加在一起即支持某项功能。简单的说，起步依赖就是将具备某种功能的坐标打包到一起，并提供一些默认的功能
Automatically configure Spring and 3rd party libraries whenever possible
- 自动配置Spring以及第三方功能
Provide production-ready features such as metrics, health checks, and externalized configuration
- 提供生产级别的监控、健康检查及外部化配置
Absolutely no code generation and no requirement for XML configuration
- 无代码生成、无需编写XML

SpringBoot是整合Spring技术栈的一站式框架

SpringBoot是简化Spring技术栈的快速开发脚手架

SpringBoot并不是对Spring功能上的增强，而是提供了一种快速使用Spring的方法

1.3 SpringBoot缺点

人称版本帝，迭代快，需要时刻关注变化
封装太深，内部原理复杂，不容易精通

1.4 时代背景-微服务

微服务是一种架构风格

一个应用拆分为一组小型服务
每个服务运行在自己的进程内，也就是可独立部署和升级
服务之间使用轻量级HTTP交互
服务围绕业务功能拆分
可以由全自动部署机制独立部署
去中心化，服务自治。服务可以使用不同的语言、不同的存储技术

第2章SpringBoot入门开发

技术点要求

熟练 Spring 框架的使用

熟练 Maven 依赖管理与项目构建熟练使用 Eclipse 或 IDEA

2.1 环境要求

环境准备：

java version "1.8.0_181"
Maven-3.6.1
SpringBoot 2.x 最新版

2.2 快速构建SpringBoot项目

项目创建方式一：使用Spring Initializr 的 Web页面创建项目

项目创建方式二：使用 IDEA 直接创建项目

创建一个新项目
选择spring initalizr ，可以看到默认就是去官网的快速构建工具那里实现
填写项目信息
选择初始化的组件（初学勾选 Web 即可）
填写项目路径
等待项目构建成功

项目创建方式三：使用 IDEA 直接创建项目

与方式2相同，但是参考路径为：https://start.aliyun.com

项目创建方式四：使用 IDEA 创建Maven项目并改造为springBoot

项目结构分析：

程序的主启动类
一个 application.properties 配置文件
一个测试类
一个 pom.xml

2.2.1 实现处理请求案例

在主程序的同级目录下，新建一个controller包，一定要在同级目录下，否则识别不到
在包中新建一个HelloController类
编写完毕后，从主程序启动项目，浏览器发起请求，看页面返回；控制台输出了 Tomcat 访问的端口号！

2.2.2 项目打jar包

2.2.3 banner修改

项目下的 resources 目录下新建一个banner.txt 即可。
图案可以到：https://www.bootschool.net/ascii 这个网站生成，然后拷贝到文件中即可！
设置图片作为banner

2.3 运行原理初步探究

1.spring-boot-starter-parent

springBoot项目都要继承
spring-boot-starter-parent spring-boot-starter-parent中定义了若干个依赖管理
继承parent模块可以避免多个依赖使用相同技术时出现依赖冲突
继承parent的形式也可以采用引入依赖的形式实现效果例如alibaba

2. start

导入套餐形式的坐标从而简化配置，坐标实现依赖传递

3. 引导类

程序主入口，初始化spring容器，扫描所有类
可以通过run方法返回值获取bean检验

4. 内嵌tomcat

注解

@RequestMapping(path = "url")

作用：处理用户请求

url:未来所处理的请求的请求路径

@ResponseBody

作用：将方法返回值转化为json并响应给方法的请求者

第3章 Spring Boot 核心配置

3.1 Spring Boot配置文件分类

SpringBoot是基于约定的，所以很多配置都有默认值，但如果想使用自己的配置替换默认配置的话，就可以使用

application.properties或者application.yml（application.yaml）进行配置

application.properties

语法结构：key=value
server.port=8081

application.yml

语法结构：key：空格 value （冒号后面必须要有空格）

server:

port: 8081

小结

SpringBoot提供了2种配置文件类型：properteis和yml/yaml
默认配置文件名称：application
在同一级目录入如果三类文件共存，优先级为：properties > yml > yaml

3.2 YAML概述

YAML全称是 YAML Ain't Markup Language 。

YAML是一种直观的能够被电脑识别的的数据数据序列化格式，

并且容易被人类阅读，容易和脚本语言交互的，可以被支持YAML库的不同的编程语言程序导入，比如： C/C++, Ruby, Python, Java, Perl, C#, PHP等。YML文件是以数据为核心的，比传统的xml方式更加简洁。

YAML文件的扩展名可以使用.yml或者.yaml。

properties:

server.port=8080
server.address=127.0.0.1

xml:

<server><port>8080</port><address>127.0.0.1</address>
</server>

yml:

server:port: 8080address: 127.0.0.1

简洁，以数据为核心

3.3 YAML基础语法

大小写敏感
数据值前边必须有空格，作为分隔符
使用缩进表示层级关系
缩进时不允许使用Tab键，只允许使用空格（各个系统 Tab对应的空格数目可能不同，导致层次混乱）。
缩进的空格数目不重要，只要相同层级的元素左侧对齐即可
"#"表示注释，从这个字符一直到行尾，都会被解析器忽略。

YAML：数据格式

字面量：普通的值[数字，布尔值，字符串]

boolean: TRUE    #TRUE,true,True,FALSE,false，False均可
float: 3.14    #6.8523015e+5 #支持科学计数法
int: 123    #0b1010_0111_0100_1010_1110 #支持二进制、八进制、十六进制
string: HelloWorld    #字符串可以直接书写

对象、Map（键值对）

person:name: wangzhuo
# 行内写法
person: {name: wangzhuo}#对象数组格式一
users:- name: Tomage: 4- name: Jerryage: 5#对象数组格式二
users:-name: Tomage: 4-name: Jerryage: 5#对象数组缩略格式
users2: [ { name:Tom,age:4 },{ name:Jerry,age:5 } ]

YAML：参数引用

name: zhangsanperson:name: lisipet: ${name}    #引用上边定义的name值name: wangwu${random.uuid}    #配置文件占位符，随机uuidname: ${person.name}_真帅

YAML：小结

1）配置文件类型

properties：和以前一样 (设置文件的语言编码UTF-8)
yml/yaml：注意空格

2） yaml：简洁，以数据为核心

基本语法
- 大小写敏感
- 数据值前边必须有空格，作为分隔符
- 使用空格缩进表示层级关系，相同缩进表示同一级
数据格式
- 对象
- 数组: 使用 " - "表示数组每个元素
- 纯量
参数引用
- ${key}

3.4 读取配置内容

yaml文件更强大的地方在于，他可以给我们的实体类直接注入匹配值！

支持方式：

逐个注入：@Value

批量注入：

1.@ConfigurationProperties

2.Environment类

逐个注入演示

@Component //注册bean
public class Dog {@Value("阿黄")private String name;@Value("18")private Integer age;
}

加载指定的配置文件@PropertySource ：加载指定的配置文件；

我们去在resources目录下新建一个dog.yml文件

name: 阿黄
age: 18

@PropertySource(value = "classpath:dog.yml")
@Component //注册bean
public class Dog{@Value("${name}")private String name;@Value("${age}")private Integer age;
}

批量注入方式1

编写一个复杂一点的实体类：Person 类

@Component //注册bean到容器中
public class Person {private String name;private integer age;private boolean marry;private Date birth;private Map<String,Object> maps;private List<Object> lists;private Dog dog;//有参无参构造、get、set方法、toString()方法
}

编写yaml文件内容

person1:name: wanglsage: 18marry: truebirth: 1990/10/19maps: {k1: v1,k2: v2}lists:- code- bodybuilding- musicdog:name: summerage: 1

将数据注入到我们的类中

/*
@ConfigurationProperties作用：
将配置文件中配置的每一个属性的值，映射到这个组件中；
告诉SpringBoot将本类中的所有属性和配置文件中相关的配置进行绑定
参数 prefix = “person” : 将配置文件中的person下面的所有属性一一对应
*/
@Component //注册bean
@ConfigurationProperties(prefix = "person1")
public class Person {private String name;private Integer age;private Boolean happy;private Date birth;private Map<String,Object> maps;private List<Object> lists;private Dog dog;
}

如果编写完配置文件有红色提示，则可以添加坐标隐藏

<dependency><groupId>org.springframework.boot</groupId><artifactId>spring-boot-configuration-processor</artifactId><optional>true</optional>
</dependency>

测试类中测试一下

@SpringBootTest
class DemoApplicationTests {@AutowiredPerson person; //将person自动注入进来@Testpublic void contextLoads() {System.out.println(person); //打印person信息}
}

批量注入方式2

直接在测试类中装配开发模式类辅助获取key对应value数据

@Autowired
private Environment env;
@Test
public void test(){System.out.println(env.getProperty("person1.name"));System.out.println(env.getProperty("person1.age"));System.out.println(env.getProperty("person1.dog.name"));System.out.println(env.getProperty("person1.lists[0]"));
}

对比小结

@Value这个使用起来并不友好！我们需要为每个属性单独注解赋值，比较麻烦；我们来看个功能对比图

对比	@ConfigurationProperties	@Value
功能	批量注入配置文件中的属性	一个个指定
松散语法	支持	不支持
SpEL	不支持	支持
JSR303数据校验	支持	不支持
复杂类型封装	支持	不支持

@ConfigurationProperties只需要写一次即可， @Value则需要每个字段都添加
松散绑定：这个什么意思呢? 比如我的yml中写的last-name，这个和lastName是一样的， - 后面跟着的字母默认是大写的。这就是松散绑定。可以测试一下
JSR303数据校验，这个就是我们可以在字段是增加一层过滤器验证，可以保证数据的合法性
复杂类型封装，yml中可以封装对象，使用value就不支持

结论

配置yml和配置properties都可以获取到值，强烈推荐yml

如果在我们某个业务中，只需要获取配置文件中的某一个值，可以使用一下@value

如果说，我们专门编写了一个JavaBean来配置文件进行——映射，就只直接@configurationProperties，不要犹豫！

3.5 JSR303数据校验

对于 web 服务来说，为防止非法参数对业务造成影响，在 Controller 层一定要做参数校验的！大部分情况下，请求参数分为如下两种形式：

POST 、 PUT 请求，使用 requestBody 传递参数；
GET 请求，使用 requestParam/PathVariable 传递参数。

什么是 JSR303 标准？

JSR的全称是Java Specification Requests（Java 规范提案），是指向JCP ( Java Community Process )提出

新增一个标准化技术规范的正式请求。

Java API 规范( JSR303 )定义了 Bean 校验的标准 validation-api ，但没有提供实现。 hibernate validation 是对这个规范的实现，并增加了校验注解如 @Email 、 @Length 等。 Spring Validation 是对 hibernate validation 的二次封装，用于支持 spring mvc 参数自动校验。接下来，我们以 spring-boot 项目为例，介绍 Spring Validation 的使用

JSR303校验注解的使用步骤

1.添加依赖，导入spring-boot-starter-validation启动器

<dependency><groupId>org.springframework.boot</groupId><artifactId>spring-boot-starter-validation</artifactId>
</dependency>

2.在实体类需要校验的成员字段（Field）上，添加校验注解

@Component //注册bean到容器中
//@ConfigurationProperties(prefix = "dog")
//@Validated
public class Dog {@NotNull(message = "狗名不能为空")private String name;@NotNull(message = "狗命不能为空")@Max(value = 15,message = "狗命拿来")private Integer age;@Min(value = -1,message = "狗还是个细胞")private Integer length;@Email(message = "邮箱必须合法")private String email;
}

3.在Controller控制器的校验参数前，使用@Valid注解开启校验，使用BindingResult 绑定校验结果

@RequestMapping("/validationDemo")public String validationDemo(@Valid Dog dog, BindingResult result){//得到所有错误信息计数int errorCount = result.getErrorCount();//错误数大于0if (errorCount>0){//得到所有错误List<FieldError> fieldErrors = result.getFieldErrors();//迭代错误for (FieldError fieldError:fieldErrors) {//错误信息System.out.println( "属性：{},"+fieldError.getField()+"传来的值是：
{}"+fieldError.getRejectedValue()+",出错的提示消息：
{}"+fieldError.getDefaultMessage());}return "数据不合法";}else{return "数据合法";}
}

JSR303校验注解的分类

值校验

// 被注解的元素必须为null
@Null(message = "必须为null")
// 被注解的元素必须不为null
@NotNull(message = "必须不为null")
// 校验注解的元素值不为空（不为null、去除首位空格后长度为0）,类型为String
@NotBlank(message = "必须不为空")
// 校验注解的元素值不为null且不为空（字符串长度不为0、集合大小不为0）,类型为CharSequence、
Collection、Map、Array
@NotEmpty(message = "必须不为null且不为空")
// 被注解的元素必须为true，并且类型为boolean
@AssertTrue(message = "必须为true")
// 被注解的元素必须为false，并且类型为boolean
@AssertFalse(message = "必须为false")

范围校验

// 被注解的元素其值必须大于等于最小值，并且类型为int，long，float，double
@Min(value = 18, message = "必须大于等于18")
// 被注解的元素其值必须小于等于最小值，并且类型为int，long，float，double
@Max(value = 18, message = "必须小于等于18")
// 校验注解的元素值大于等于@DecimalMin指定的value值，并且类型为BigDecimal
@DecimalMin(value = "150", message = "必须大于等于150")
// 校验注解的元素值小于等于@DecimalMax指定的value值 ，并且类型为BigDecimal
@DecimalMax(value = "300", message = "必须大于等于300")
// 校验注解的元素值在最小值和最大值之间，并且类型为BigDecimal，BigInteger，CharSequence，
byte，short，int，long。
@Range(max = 80, min = 18, message = "必须大于等于18或小于等于80")
// 被注解的元素必须为过去的一个时间，并且类型为java.util.Date
@DateTimeFormat(pattern = "yyyy-MM-dd HH:mm:ss") @Past(message = "必须为过去的时
间")
// 被注解的元素必须为未来的一个时间，并且类型为java.util.Date
@DateTimeFormat(pattern = "yyyy-MM-dd HH:mm:ss") @Future(message = "必须为未来的时
间")

长度校验

// 被注解的元素的长度必须在指定范围内，并且类型为String，Array，List，Map
@Size(max = 11, min = 7, message = "长度必须大于等于7或小于等于11")// 校验注解的元素值长度在min和max区间内 ，并且类型为String
@Length(max = 11, min = 7, message = "长度必须大于等于7或小于等于11")

格式校验

// 校验注解的元素值的整数位数和小数位数上限 ，并且类型为float，double，BigDecimal。
@Digits(integer=3,fraction = 2,message = "整数位上限为3位，小数位上限为2位")// 被注解的元素必须符合指定的正则表达式，并且类型为String
@Pattern(regexp = "\\d{11}",message = "必须为数字，并且长度为11")// 校验注解的元素值是Email，也可以通过regexp和flag指定自定义的email格式，类型为String
@Email(message = "必须是邮箱")

Controller统一异常处理

@ControllerAdvice：统一为Controller进行"增强"

@ExceptionHandler : 异常处理

import org.springframework.validation.BindException;
import org.springframework.web.bind.annotation.*;@ControllerAdvice
public class BindExceptionUtilAdvice {// 验证参数未使用@RequestBody注解@ExceptionHandler(BindException.class)@ResponseBody//选择添加public String handlerBindException(BindException ex, HttpServletRequest
request){return "全局异常处理器成功"; // 跳转至统一提示错误信息的视图}
}