1、springboot简介

1.1、spring能做什么

springboot笔记 - 图1

1.2、spring的生态

  1. https://spring.io/projects/spring-boot
  2. 覆盖了:
  3. web开发
  4. 数据访问
  5. 安全控制
  6. 分布式
  7. 消息服务
  8. 移动开发
  9. 批处理
  10. ......

1.3、Spring5重大升级响应式编程

默认接口实现
springboot笔记 - 图2

1.4.、SpringBoot优缺点

1、优点

  1. ● Create stand-alone Spring applications
  2. ○ 创建独立Spring应用
  3. ● Embed Tomcat, Jetty or Undertow directly (no need to deploy WAR files)
  4. ○ 内嵌web服务器
  5. ● Provide opinionated 'starter' dependencies to simplify your build configuration
  6. ○ 自动starter依赖,简化构建配置
  7. ● Automatically configure Spring and 3rd party libraries whenever possible
  8. ○ 自动配置Spring以及第三方功能
  9. ● Provide production-ready features such as metrics, health checks, and externalized configuration
  10. ○ 提供生产级别的监控、健康检查及外部化配置
  11. ● Absolutely no code generation and no requirement for XML configuration
  12. ○ 无代码生成、无需编写XML
  13. SpringBoot是整合Spring技术栈的一站式框架
  14. SpringBoot是简化Spring技术栈的快速开发脚手架

2、缺点

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

1.5、时代背景

1、微服务

  1. ● 微服务是一种架构风格
  2. ● 一个应用拆分为一组小型服务
  3. ● 每个服务运行在自己的进程内,也就是可独立部署和升级
  4. ● 服务之间使用轻量级HTTP交互
  5. ● 服务围绕业务功能拆分
  6. ● 可以由全自动部署机制独立部署
  7. ● 去中心化,服务自治。服务可以使用不同的语言、不同的存储技术

2、分布式

  1. (1)分布式的困难
  2. ● 远程调用
  3. ● 服务发现
  4. ● 负载均衡
  5. ● 服务容错
  6. ● 配置管理
  7. ● 服务监控
  8. ● 链路追踪
  9. ● 日志管理
  10. ● 任务调度
  11. ● ......
  12. (2)分布式的解决
  13. ● SpringBoot + SpringCloud

springboot笔记 - 图3
3、云原生

  1. 原生应用如何上云。 Cloud Native
  2. 上云的困难
  3. ● 服务自愈
  4. ● 弹性伸缩
  5. ● 服务隔离
  6. ● 自动化部署
  7. ● 灰度发布
  8. ● 流量治理
  9. ● ......

2、maven构建springboot项目

  • Java 8 & 兼容java14 .
  • Maven 3.3+
  • idea 2019.1.2

1、maven设置

  1. <mirrors>
  2. <mirror>
  3. <id>nexus-aliyun</id>
  4. <mirrorOf>central</mirrorOf>
  5. <name>Nexus aliyun</name>
  6. <url>http://maven.aliyun.com/nexus/content/groups/public</url>
  7. </mirror>
  8. </mirrors>
  9. <profiles>
  10. <profile>
  11. <id>jdk-1.8</id>
  12. <activation>
  13. <activeByDefault>true</activeByDefault>
  14. <jdk>1.8</jdk>
  15. </activation>
  16. <properties>
  17. <maven.compiler.source>1.8</maven.compiler.source>
  18. <maven.compiler.target>1.8</maven.compiler.target>
  19. <maven.compiler.compilerVersion>1.8</maven.compiler.compilerVersion>
  20. </properties>
  21. </profile>
  22. </profiles>

2、创建maven项目导入依赖

  1. <parent>
  2. <groupId>org.springframework.boot</groupId>
  3. <artifactId>spring-boot-starter-parent</artifactId>
  4. <version>2.6.1</version>
  5. </parent>
  6. <dependencies>
  7. <dependency>
  8. <groupId>org.springframework.boot</groupId>
  9. <artifactId>spring-boot-starter-web</artifactId>
  10. </dependency>
  11. </dependencies>

3、创建主程序类

  1. @SpringBootApplication
  2. public class Application {
  3. public static void main(String[] args) {
  4. SpringApplication.run(Application.class,args);
  5. }
  6. }

4、编写业务代码

  1. @RestController
  2. public class HelloController {
  3. @RequestMapping("/hello")
  4. public String handle01(){
  5. return "Hello, Spring Boot 2!";
  6. }
  7. }

5、简化部署打包jar

  1. 1、导入打包插件插件
  2. <build>
  3. <plugins>
  4. <plugin>
  5. <groupId>org.springframework.boot</groupId>
  6. <artifactId>spring-boot-maven-plugin</artifactId>
  7. </plugin>
  8. </plugins>
  9. </build>
  10. 2、将应用打包
  1. 3package打包后,在target目录下的找到本地的jar包并在cmd命令行运行
  2. java -jar [jar包的名字]

3、了解自动化配置原理

3.1、依赖管理及版本修改

  1. (1)依赖管理
  2. <parent>
  3. <groupId>org.springframework.boot</groupId>
  4. <artifactId>spring-boot-starter-parent</artifactId>
  5. <version>2.3.4.RELEASE</version>
  6. </parent>
  7. 他的父项目
  8. <parent>
  9. <groupId>org.springframework.boot</groupId>
  10. <artifactId>spring-boot-dependencies</artifactId>
  11. <version>2.3.4.RELEASE</version>
  12. </parent>
  13. 几乎声明了所有开发中常用的依赖的版本号,自动版本仲裁机制
  14. (2)无需关注版本号,自动版本仲裁
  15. 1、引入依赖默认都可以不写版本
  16. 2、引入非版本仲裁的jar,要写版本号。
  1. (3)可以修改默认版本号
  2. 1、查看spring-boot-dependencies里面规定当前依赖的版本 用的 key。
  3. 2、在当前项目里面重写配置
  4. <properties>
  5. <mysql.version>5.1.43</mysql.version>
  6. </properties>

3.2、自动配置

  1. (1)自动配好Tomcat
  2. ○ 引入Tomcat依赖。
  3. ○ 配置Tomcat
  4. <dependency>
  5. <groupId>org.springframework.boot</groupId>
  6. <artifactId>spring-boot-starter-tomcat</artifactId>
  7. <version>2.3.4.RELEASE</version>
  8. <scope>compile</scope>
  9. </dependency>
  10. (2)● 自动配好SpringMVC
  11. ○ 引入SpringMVC全套组件
  12. ○ 自动配好SpringMVC常用组件(功能)
  13. (3)自动配好Web常见功能,如:字符编码问题
  14. ○ SpringBoot帮我们配置好了所有web开发的常见场景
  15. (4)默认的包结构
  16. ○ 主程序所在包及其下面的所有子包里面的组件都会被默认扫描进来
  17. ○ 无需以前的包扫描配置
  18. ○ 想要改变扫描路径,@SpringBootApplication(scanBasePackages="com.guang")
  19. ■ 或者在配置类中添加@ComponentScan 指定扫描路径
  20. @SpringBootApplication
  21. 等同于
  22. @SpringBootConfiguration
  23. @EnableAutoConfiguration
  24. @ComponentScan("com.guang.boot")
  25. (5)各种配置拥有默认值
  26. ○ 默认配置最终都是映射到某个类上,如:MultipartProperties
  27. ○ 配置文件的值最终会绑定每个类上,这个类会在容器中创建对象
  28. (6)按需加载所有自动配置项
  29. ○ 非常多的starter
  30. ○ 引入了哪些场景这个场景的自动配置才会开启
  31. ○ SpringBoot所有的自动配置功能都在 spring-boot-autoconfigure 包里面

3.3、容器功能

3.3.1、组件添加

1、@Configuration配置类

  1. 基本使用
  2. Full模式与Lite模式
  3. 示例
  4. 最佳实战
  5. 配置 类组件之间无依赖关系用Lite模式加速容器启动过程,减少判断
  6. 配置类组件之间有依赖关系,方法会被调用得到之前单实例组件,用Full模式
  7. /**
  8. * 1、配置类里面使用@Bean标注在方法上给容器注册组件,默认也是单实例的
  9. * 2、配置类本身也是组件
  10. * 3、proxyBeanMethods:代理bean的方法
  11. * Full(proxyBeanMethods = true)、【保证每个@Bean方法被调用多少次返回的组件都是单实例的】
  12. * Lite(proxyBeanMethods = false)【每个@Bean方法被调用多少次返回的组件都是新创建的】
  13. * 组件依赖默认使用Full模式。其他默认是否Lite模式
  14. */
  15. @Configuration(proxyBeanMethods = false)
  16. //告诉SpringBoot这是一个配置类 == 配置文件
  17. //配置文件本身也是一个组件
  18. public class MyConfig {
  19. /**
  20. * Full:外部无论对配置类中的这个组件注册方法调用多少次获取的都是之前注册容器中的单实例对象
  21. */
  22. @Bean //给容器中添加组件。以方法名作为组件的id。返回类型就是组件类型。返回的值,
  23. //就是组件在容器中的实例
  24. public User user01(){
  25. User zhangsan = new User("zhangsan", 18);
  26. //user组件依赖了Pet组件
  27. zhangsan.setPet(tomcatPet());//默认获取容器中的组件,false获取的不是单例的
  28. return zhangsan;
  29. }
  30. @Bean("tom")
  31. public Pet tomcatPet(){
  32. return new Pet("tomcat");
  33. }
  34. }

2、@Bean、@Component、@Controller、@Service、@Repository
3、@ComponentScan包扫描、@Import 导入组件

  1. /* @Import({User.class, DBHelper.class})
  2. *给容器中自动创建出这两个类型的组件、默认组件的名字就是全类名
  3. */
  4. @Import({User.class, DBHelper.class})
  5. @Configuration(proxyBeanMethods = false)//返回的不是单例
  6. //告诉SpringBoot这是一个配置类 == 配置文件
  7. public class MyConfig {
  8. }

4、@Conditional 条件装配:满足Conditional指定的条件,则进行组件注入

  1. //@ConditionalOnBean(name = "tom")
  2. @ConditionalOnMissingBean(name = "tom")
  3. //该条件满足时,该配置类下的组件才会被放进容器
  4. @Configuration
  5. public class MyConfig {
  6. @Bean
  7. //@ConditionalOnBean(name = "tom")
  8. //该条件满足时,该组件才会被放进容器
  9. public User user01(){
  10. User zhangsan = new User("zhangsan", 18);
  11. //user组件依赖了Pet组件
  12. zhangsan.setPet(tomcatPet());
  13. return zhangsan;
  14. }
  15. @Bean("tom22")
  16. public Pet tomcatPet(){
  17. return new Pet("tomcat");
  18. }
  19. }

3.2.2、导入xml组件

1、@ImportResource

  1. <bean id="haha" class="com.guang.boot.bean.User">
  2. <property name="name" value="zhangsan"></property>
  3. <property name="age" value="18"></property>
  4. </bean>
  5. //在配置类或者其他被扫描的类上
  6. @ImportResource("classpath:beans.xml")
  7. public class MyConfig {}
  8. ======================测试=================
  9. boolean haha = run.containsBean("haha");
  10. boolean hehe = run.containsBean("hehe");
  11. System.out.println("haha:"+haha);//true
  12. System.out.println("hehe:"+hehe);//true

3.2.3、配置文件与组件绑定

application.properties

  1. mycar.brand=BYD
  2. mycar.price=100000

方式1:@ConfigurationProperties(组件)

  1. /**
  2. * 只有在容器中的组件,才会拥有SpringBoot提供的强大功能
  3. */
  4. @Component
  5. @ConfigurationProperties(prefix = "mycar")
  6. public class Car {
  7. private String brand;
  8. private Integer price;
  9. //getter、setter、toString
  10. }

方式2:@EnableConfigurationProperties+ConfigurationProperties (配置类)

  1. @EnableConfigurationProperties(Car.class)
  2. //1、开启Car配置绑定功能
  3. //2、把这个Car这个组件自动注册到容器中
  4. @Configuration
  5. public class MyConfig {
  6. }
  1. //@Component
  2. @ConfigurationProperties(prefix = "mycar")
  3. public class Car {
  4. private String brand;
  5. private Integer price;
  6. //getter、setter、toString
  7. }

3.2.4、自动配置报告

application.properties

  1. debug=true

4、spring initailizr

创建springboot项目并且导入相关的依赖
1、lombok
简化实体类的开发,安装插件并导入依赖,@Slf4j日志方便进行开发
2、dev-tools
方便进行测试,导入依赖后Ctrl+F9项目便会重新编译

4、配置文件

4.1、application.properties

假设两个配置文件设定了同样的配置,会优先加载properties中的配置,

4.2、application.yml

4.2.1、简介

YAML 是 “YAML Ain’t Markup Language”(YAML 不是一种标记语言)的递归缩写。在开发的这种语言时,YAML 的意思其实是:”Yet Another Markup Language”(仍是一种标记语言)。

非常适合用来做以数据为中心的配置文件

4.2.2、基本语法

● key: value;kv之间有空格
● 大小写敏感
● 使用缩进表示层级关系
● 缩进不允许使用tab,只允许空格
● 缩进的空格数不重要,只要相同层级的元素左对齐即可
● ‘#’表示注释
● 字符串无需加引号,如果要加,’’与””表示字符串内容 会被 转义/不转义
即单引号\n作为作为字符串输出,双引号作为换行

4.2.3、数据类型

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

  1. k: v

2、对象:键值对的集合。map、hash、set、object

  1. 行内写法: k: {k1:v1,k2:v2,k3:v3}
  2. #或
  3. k:
  4. k1: v1
  5. k2: v2
  6. k3: v3

3、数组:一组按次序排列的值。array、list、queue

  1. 行内写法: k: [v1,v2,v3]
  2. #或者
  3. k:
  4. - v1
  5. - v2
  6. - v3

4.2.4、示例

  1. @Data
  2. public class Person {
  3. private String userName;
  4. private Boolean boss;
  5. private Date birth;
  6. private Integer age;
  7. private Pet pet;
  8. private String[] interests;
  9. private List<String> animal;
  10. private Map<String, Object> score;
  11. private Set<Double> salarys;
  12. private Map<String, List<Pet>> allPets;
  13. }
  14. @Data
  15. public class Pet {
  16. private String name;
  17. private Double weight;
  18. }
  1. # yaml表示以上对象
  2. person:
  3. userName: zhangsan
  4. boss: false
  5. birth: 2019/12/12 20:12:33
  6. age: 18
  7. pet:
  8. name: tomcat
  9. weight: 23.4
  10. interests: [篮球,游泳]
  11. animal:
  12. - jerry
  13. - mario
  14. score:
  15. english:
  16. first: 30
  17. second: 40
  18. third: 50
  19. math: [131,140,148]
  20. chinese: {first: 128,second: 136}
  21. salarys: [3999,4999.98,5999.99]
  22. allPets:
  23. sick:
  24. - {name: tom}
  25. - {name: jerry,weight: 47}
  26. - name: tomcat
  27. weight: 88
  28. health: [{name: mario,weight: 47}]

4.3、application.yml使用提示

1、导入依赖

  1. <dependency>
  2. <groupId>org.springframework.boot</groupId>
  3. <artifactId>spring-boot-configuration-processor</artifactId>
  4. <optional>true</optional>
  5. </dependency>

2、在打包插件中添加
打包时过滤掉processor

  1. <build>
  2. <plugins>
  3. <plugin>
  4. <groupId>org.springframework.boot</groupId>
  5. <artifactId>spring-boot-maven-plugin</artifactId>
  6. <configuration>
  7. <excludes>
  8. <exclude>
  9. <groupId>org.springframework.boot</groupId>
  10. <artifactId>spring-boot-configuration-processor</artifactId>
  11. </exclude>
  12. </excludes>
  13. </configuration>
  14. </plugin>
  15. </plugins>
  16. </build>

3、重启动项目后编写yml文件即会有提示

5、web开发-静态资源访问及修改

5.1、静态资源目录

● 只要静态资源放在类路径下: /static /public /resources /META-INF/resources
● 访问 :当前项目根路径/ + 静态资源名 localhost:8080/bug.jpg
● 原理: 静态映射/**。
● 请求进来,先去找Controller看能不能处理。不能处理的所有请求又都交给静态资源处理器。静态资源也找不到则响应404页面

5.2、改变静态资源访问路径

1、添加静态资源访问前缀

  1. spring:
  2. mvc:
  3. static-path-pattern: /res/**

2、改变静态资源路径

  1. spring:
  2. resources:
  3. static-locations:[classpath:/haha/]

5.3、webjar

1、导依赖

  1. 自动映射 /webjars/**
  2. https://www.webjars.org/
  3. <dependency>
  4. <groupId>org.webjars</groupId>
  5. <artifactId>jquery</artifactId>
  6. <version>3.5.1</version>
  7. </dependency>

2、访问地址:http://localhost:8080/webjars/jquery/3.5.1/jquery.js 后面地址要按照依赖里面的包路径

6、欢迎页设置

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

  1. spring:
  2. # mvc:
  3. # static-path-pattern: /res/** 这个会导致welcome page功能失效,底层配置/**
  4. resources:
  5. static-locations: [classpath:/haha/]
  6. controller能处理/index

7、自定义favicon

  1. favicon.ico 放在静态资源目录下即可。
  2. 设置静态资源访问的前缀路径会导致favicon失效
  3. spring:
  4. # mvc:
  5. # static-path-pattern: /res/** 这个会导致 Favicon 功能失效

8、请求参数Restful风格

1、表单提交开启Rest风格

  1. spring:
  2. mvc:
  3. hiddenmethod:
  4. filter:
  5. enabled: true #开启页面表单的Rest功能

@GetMapping
@DeleteMapping
@PutMapping
@PostMapping

9、普通参数与注解

@PathVariable、@RequestHeader、@RequestAttribute、@RequestParam、@MatrixVariable、@CookieValue、@RequestBody

9.1、@PathVariable

路径变量
localhost:8080/user/{id}

  1. @GetMapping("/user/{id})
  2. public string getUserByid(@PathVariable("id")Integer id){
  3. }

9.2、@RequestHeader

获取请求头

  1. @RequestHeader("User-Agent") String userAgent//获取名称为User-Agent的请求头
  2. @RequestHeader Map<String,String> header//获取所有的请求头

9.3、@RequestParam

获取请求参数

  1. @RequestParam("age") Integer age //获取名为age的请求参数
  2. @RequestParam("inters") List<String> inters//获取请求参数的数组名为inters的数组
  3. @RequestParam Map<String,String> params//获取所有的请求参数

9.4、@CookieValue

获取Cookie的值

  1. @CookieValue("_ga") String _ga//获取名为_ga的Cookie
  2. @CookieValue("_ga") Cookie cookie)

9.5、@RequestAttribute

  1. @Controller
  2. public class RequestController {
  3. @GetMapping("/goto")
  4. public String goToPage(HttpServletRequest request){
  5. request.setAttribute("msg","成功了...");
  6. request.setAttribute("code",200);
  7. return "forward:/success"; //转发到 /success请求
  8. }
  9. @GetMapping("/params")
  10. public String testParam(Map<String,Object> map,
  11. Model model,
  12. HttpServletRequest request,
  13. HttpServletResponse response){
  14. map.put("hello","world666");
  15. model.addAttribute("world","hello666");
  16. request.setAttribute("message","HelloWorld");
  17. Cookie cookie = new Cookie("c1","v1");
  18. response.addCookie(cookie);
  19. return "forward:/success";
  20. }

9.6、@MatrixVariable

矩阵变量:SpringBoot默认是禁用了矩阵变量的功能

1、手动开启:原理。对于路径的处理。UrlPathHelper进行解析。
removeSemicolonContent(移除分号内容)支持矩阵变量的
方式1:

  1. @Configration
  2. public class WebConfig implements WebMvcConfigurer{
  3. @Override
  4. public void configurePathMatch(PathMatchConfigurer configurer) {
  5. UrlPathHelper urlPathHelper = new UrlPathHelper();
  6. // 不移除;后面的内容。矩阵变量功能就可以生效
  7. urlPathHelper.setRemoveSemicolonContent(false);
  8. configurer.setUrlPathHelper(urlPathHelper);
  9. }
  10. }

方式2:

  1. @Configration
  2. public class WebConfig {
  3. @Bean
  4. public WebMvcConfigurer webMvcConfigurer(){
  5. return new webMvcConfigurer(){
  6. @Override
  7. public void configurePathMatch(PathMatchConfigure configurer){
  8. UrlPathHelper urlPathHelper = new UrlPathHelper();
  9. // 不移除;后面的内容。矩阵变量功能就可以生效
  10. urlPathHelper.setRemoveSemicolonContent(false);
  11. configurer.setUrlPathHelper(urlPathHelper);
  12. }
  13. }
  14. }
  15. }

2、

  1. @Controller
  2. public class RequestController {
  3. //1、语法: 请求路径:/cars/sell;low=34;brand=byd,audi,yd
  4. //2、SpringBoot默认是禁用了矩阵变量的功能
  5. // 手动开启:原理。对于路径的处理。UrlPathHelper进行解析。
  6. // removeSemicolonContent(移除分号内容)支持矩阵变量的
  7. //3、矩阵变量必须有url路径变量才能被解析
  8. @GetMapping("/cars/{path}")
  9. public Map carsSell(@MatrixVariable("low") Integer low,
  10. @MatrixVariable("brand") List<String> brand,
  11. @PathVariable("path") String path){
  12. Map<String,Object> map = new HashMap<>();
  13. map.put("low",low);
  14. map.put("brand",brand);
  15. map.put("path",path);
  16. return map;
  17. }
  18. // /boss/1;age=20/2;age=10
  19. //两个相同名字的矩阵变量
  20. @GetMapping("/boss/{bossId}/{empId}")
  21. public Map boss(@MatrixVariable(value = "age",pathVar = "bossId") Integer bossAge,
  22. @MatrixVariable(value = "age",pathVar = "empId") Integer empAge){
  23. Map<String,Object> map = new HashMap<>();
  24. map.put("bossAge",bossAge);
  25. map.put("empAge",empAge);
  26. return map;
  27. }
  28. }

image.png

10、复杂参数

MapModel(map、model里面的数据会被放在request的请求域 request.setAttribute)、Errors/BindingResult、RedirectAttributes( 重定向携带数据)ServletResponse(response)、SessionStatus、UriComponentsBuilder、ServletUriComponentsBuilder

10.1、Map、Model

  1. @GetMapping("/params")
  2. public String testParam(Map<String,Object> map,
  3. Model model,
  4. HttpServletRequest request,
  5. HttpServletResponse response){
  6. map.put("hello","world666");
  7. model.addAttribute("world","hello666");
  8. request.setAttribute("message","HelloWorld");
  9. Cookie cookie = new Cookie("c1","v1");
  10. response.addCookie(cookie);
  11. return "forward:/success";
  12. }
  13. @ResponseBody
  14. @GetMapping("/success")
  15. public Map success(HttpServletRequest request){
  16. Map<String,Object> map = new HashMap<>();
  17. Object hello = request.getAttribute("hello");
  18. Object world = request.getAttribute("world");
  19. Object message = request.getAttribute("message");
  20. map.put("reqMethod_msg",msg1);
  21. map.put("annotation_msg",msg);
  22. map.put("hello",hello);
  23. map.put("world",world);
  24. map.put("message",message);
  25. return map;
  26. }

11、数据绑定(POJO)

前端的参数名与后端实体类的参数名一致会自动封装到实体类中。
1、实体类

  1. /**
  2. * 姓名: <input name="userName"/> <br/>
  3. * 年龄: <input name="age"/> <br/>
  4. * 生日: <input name="birth"/> <br/>
  5. * 宠物姓名:<input name="pet.name"/><br/>
  6. * 宠物年龄:<input name="pet.age"/>
  7. */
  8. @Data
  9. public class Person {
  10. private String userName;
  11. private Integer age;
  12. private Date birth;
  13. private Pet pet;
  14. }
  15. @Data
  16. public class Pet {
  17. private String name;
  18. private String age;
  19. }

2、处理请求接口

  1. ' /**
  2. * 数据绑定:页面提交的请求数据(GET、POST)都可以和对象属性进行绑定
  3. * @param person
  4. * @return
  5. */
  6. @PostMapping("/saveuser")
  7. public Person saveuser(Person person){
  8. return person;
  9. }

12、自定义Converter(改变数据绑定规则)

  1. 姓名: <input name="userName"/> <br/>
  2. 年龄: <input name="age"/> <br/>
  3. 生日: <input name="birth"/> <br/>
  4. 转变成这种模式去绑定时,需要自定义Converter
  5. 宠物<input name=pet value="啊猫,3"/>

自定义Converter

  1. @Configration
  2. public class WebConfig {
  3. @Bean
  4. public WebMvcConfigurer webMvcConfigurer(){
  5. return new webMvcConfigurer(){
  6. @Override
  7. public void addFormatters(FormatterRegistry registry) {
  8. registry.addConverter(new Converter<String, Pet>() {
  9. @Override
  10. public Pet convert(String source) {
  11. // 啊猫,3
  12. if(!StringUtils.isEmpty(source)){
  13. Pet pet = new Pet();
  14. String[] split = source.split(",");
  15. pet.setName(split[0]);
  16. pet.setAge(Integer.parseInt(split[1]));
  17. return pet;
  18. }
  19. return null;
  20. }
  21. });
  22. }
  23. }
  24. }
  25. }

13、数据响应与内容协商

image.png

13.1、响应JSON

1、导入依赖

  1. <dependency>
  2. <groupId>org.springframework.boot</groupId>
  3. <artifactId>spring-boot-starter-web</artifactId>
  4. </dependency>
  5. web场景自动引入了json场景
  6. <dependency>
  7. <groupId>org.springframework.boot</groupId>
  8. <artifactId>spring-boot-starter-json</artifactId>
  9. <version>2.3.4.RELEASE</version>
  10. <scope>compile</scope>
  11. </dependency>

2、接口

  1. @ResponseBody //利用返回值处理器里面的消息转换器进行处理
  2. @GetMapping(value = "/test/person")
  3. public Person getPerson(){
  4. Person person = new Person();
  5. person.setAge(28);
  6. person.setBirth(new Date());
  7. person.setUserName("zhangsan");
  8. return person;
  9. }

13.2、SpringMVC支持哪些返回值

  1. ModelAndView
  2. Model
  3. View
  4. ResponseEntity
  5. ResponseBodyEmitter
  6. StreamingResponseBody
  7. HttpEntity
  8. HttpHeaders
  9. Callable
  10. DeferredResult
  11. ListenableFuture
  12. CompletionStage
  13. WebAsyncTask
  14. @ModelAttribute 且为对象类型的
  15. @ResponseBody 注解 ---> RequestResponseBodyMethodProcessor

13.3、内容协商(改变响应数据的模式)

1、导入xml依赖

  1. <dependency>
  2. <groupId>com.fasterxml.jackson.dataformat</groupId>
  3. <artifactId>jackson-dataformat-xml</artifactId>
  4. </dependency>

2、接口不变

  1. @ResponseBody //利用返回值处理器里面的消息转换器进行处理
  2. @GetMapping(value = "/test/person")
  3. public Person getPerson(){
  4. Person person = new Person();
  5. person.setAge(28);
  6. person.setBirth(new Date());
  7. person.setUserName("zhangsan");
  8. return person;
  9. }

3、postman分别测试返回json和xml
image.png

13.4、开启基于参数的内容协商

1、配置文件

  1. spring:
  2. contentnegotiation:
  3. favor-parameter: true #开启请求参数内容协商模式

2、访问方式
localhost:8080/test/person?format=json
localhost:8080/test/person?format=xml

13.5、自定义内容协商(请求头)

MessageConverter,自定义请求头的内容协商后,基于参数的内容协商会失效
1、接口代码及要求(appliaction/x-guigu)

  1. /**
  2. * 1、浏览器发请求直接返回 xml [application/xml] jacksonXmlConverter
  3. * 2、如果是ajax请求 返回 json [application/json] jacksonJsonConverter
  4. * 3、如果硅谷app发请求,返回自定义协议数据 [appliaction/x-guigu] xxxxConverter
  5. * 属性值1;属性值2;
  6. *
  7. * 步骤:
  8. * 1、添加自定义的MessageConverter进系统底层
  9. * 2、系统底层就会统计出所有MessageConverter能操作哪些类型
  10. * 3、客户端内容协商 [guigu--->guigu]
  11. *
  12. * 作业:如何以参数的方式进行内容协商
  13. * @return
  14. */
  15. @ResponseBody //利用返回值处理器里面的消息转换器进行处理
  16. @GetMapping(value = "/test/person")
  17. public Person getPerson(){
  18. Person person = new Person();
  19. person.setAge(28);
  20. person.setBirth(new Date());
  21. person.setUserName("zhangsan");
  22. return person;
  23. }

2、自定义MessageConverter

  1. public class GuiguMessageConverter implements HttpMessageConverter<Person> {
  2. @Override
  3. public boolean canRead(Class<?> clazz, MediaType mediaType) {
  4. return false;
  5. }
  6. @Override
  7. public boolean canWrite(Class<?> clazz, MediaType mediaType) {
  8. return clazz.isAssignableFrom(Person.class);
  9. }
  10. /**
  11. * 服务器要统计所有MessageConverter都能写出哪些内容类型
  12. *
  13. * application/x-guigu
  14. * @return
  15. */
  16. @Override
  17. public List<MediaType> getSupportedMediaTypes() {
  18. return MediaType.parseMediaTypes("application/x-guigu");
  19. }
  20. @Override
  21. public Person read(Class<? extends Person> clazz, HttpInputMessage inputMessage) throws IOException, HttpMessageNotReadableException {
  22. return null;
  23. }
  24. @Override
  25. public void write(Person person, MediaType contentType, HttpOutputMessage outputMessage) throws IOException, HttpMessageNotWritableException {
  26. //自定义协议数据的写出
  27. String data = person.getUserName()+";"+person.getAge()+";"+person.getBirth();
  28. //写出去
  29. OutputStream body = outputMessage.getBody();
  30. body.write(data.getBytes());
  31. }
  32. }

3、将自定义MessageConverter添加到容器

  1. @Configration
  2. public class WebConfig {
  3. @Bean
  4. public WebMvcConfigurer webMvcConfigurer(){
  5. return new WebMvcConfigurer() {
  6. @Override
  7. public void extendMessageConverters(List<HttpMessageConverter<?>> converters) {
  8. converters.add(new GuiguMessageConverter());
  9. }
  10. }
  11. }
  12. }

13.6、自定义内容协商(请求参数)

自定义请求参数的内容协商后,基于请求头的内容协商会失效,这里添加了请求头的内容协商,支持两种方式

  1. @Configuration(proxyBeanMethods = false)
  2. public class WebConfig /*implements WebMvcConfigurer*/ {
  3. //1、WebMvcConfigurer定制化SpringMVC的功能
  4. @Bean
  5. public WebMvcConfigurer webMvcConfigurer(){
  6. return new WebMvcConfigurer() {
  7. /**
  8. * 自定义内容协商策略
  9. * @param configurer
  10. */
  11. @Override
  12. public void configureContentNegotiation(ContentNegotiationConfigurer configurer) {
  13. //Map<String, MediaType> mediaTypes
  14. Map<String, MediaType> mediaTypes = new HashMap<>();
  15. mediaTypes.put("json",MediaType.APPLICATION_JSON);
  16. mediaTypes.put("xml",MediaType.APPLICATION_XML);
  17. mediaTypes.put("gg",MediaType.parseMediaType("application/x-guigu"));
  18. //指定支持解析哪些参数对应的哪些媒体类型
  19. ParameterContentNegotiationStrategy parameterStrategy = new ParameterContentNegotiationStrategy(mediaTypes);
  20. // parameterStrategy.setParameterName("ff");
  21. //不添加请求头的方式的话,基于请求头的内容协商则会失效
  22. HeaderContentNegotiationStrategy headeStrategy = new HeaderContentNegotiationStrategy();
  23. configurer.strategies(Arrays.asList(parameterStrategy,headeStrategy));
  24. }
  25. }
  26. }
  27. }

14、视图解析与模板引擎

视图解析:SpringBoot默认不支持 JSP,需要引入第三方模板引擎技术实现页面渲染。

14.1、视图解析

image.png

14.2、模板引擎-Thymeleaf

1、thymeleaf简介

Thymeleaf is a modern server-side Java template engine for both web and standalone environments, capable of processing HTML, XML, JavaScript, CSS and even plain text.
现代化、服务端Java模板引擎

2、基本语法

1、表达式

表达式名字 语法 用途
变量取值 ${…} 获取请求域、session域、对象等值
选择变量 *{…} 获取上下文对象值
消息 #{…} 获取国际化等值
链接 @{…} 生成链接
片段表达式 ~{…} jsp:include 作用,引入公共页面片段

2、字面量

文本值: ‘one text’ , ‘Another one!’ ,…数字: 0 , 34 , 3.0 , 12.3 ,…布尔值: true , false
空值: null
变量: one,two,…. 变量不能有空格

3、文本操作

字符串拼接: +
变量替换: |The name is ${name}|

4、数学运算

运算符: + , - , * , / , %

5、布尔运算

运算符: and , or
一元运算: ! , not

6、比较运算

比较: > , < , >= , <= ( gt , lt , ge , le )等式: == , != ( eq , ne )

7、条件运算

If-then: (if) ? (then)
If-then-else: (if) ? (then) : (else)
Default: (value) ?: (defaultvalue)

8、特殊操作

无操作: _

14.3、thymeleaf的HelloWorld

1、导入依赖

  1. <dependency>
  2. <groupId>org.springframework.boot</groupId>
  3. <artifactId>spring-boot-starter-thymeleaf</artifactId>
  4. </dependency>

2、接口代码

  1. @Controller
  2. public class ViewTestController {
  3. @GetMapping("/atguigu")
  4. public String atguigu(Model model){
  5. //model中的数据会被放在请求域中 request.setAttribute("a",aa)
  6. model.addAttribute("msg","你好 guigu");
  7. model.addAttribute("link","http://www.baidu.com");
  8. return "success";
  9. }
  10. }

3、html页面

  1. <!DOCTYPE html>
  2. <html lang="en" xmlns:th="http://www.thymeleaf.org">
  3. <head>
  4. <meta charset="UTF-8">
  5. <title>Title</title>
  6. </head>
  7. <body>
  8. <h1 th:text="${msg}">哈哈</h1>
  9. <h2>
  10. <a href="www.atguigu.com" th:href="${link}">去百度</a> <br/>
  11. //会将访问前缀与/link拼接
  12. <a href="www.atguigu.com" th:href="@{/link}">去百度2</a>
  13. </h2>
  14. </body>
  15. </html>

4、配置文件设置访问前缀

  1. server:
  2. servlet:
  3. context-path: /world

5、测试结果
image.png

15、搭建简易的后台管理系统

1、去到登录页面

  1. @GetMapping(value = {"/","/login"})
  2. public String loginPage(){
  3. return "login";
  4. }

2、登录表单提交

  1. @PostMapping("/login")
  2. public String main(User user, HttpSession session, Model model){ //RedirectAttributes
  3. if(StringUtils.hasLength(user.getUserName()) && "123456".equals(user.getPassword())){
  4. //把登陆成功的用户保存起来
  5. session.setAttribute("loginUser",user);
  6. //登录成功重定向到main.html; 重定向防止表单重复提交
  7. return "redirect:/main.html";
  8. }else {
  9. model.addAttribute("msg","账号密码错误");
  10. //回到登录页面
  11. return "login";
  12. }
  13. }
  1. <form class="form-signin" action="index.html" method="post" th:action="@{/login}">

3、解决登录后重复表单提交

后面利用拦截器,过滤器替换此解决方案

  1. @GetMapping("/main.html")
  2. public String mainPage(HttpSession session,Model model){
  3. log.info("当前方法是:{}","mainPage");
  4. //是否登录。 拦截器,过滤器
  5. Object loginUser = session.getAttribute("loginUser");
  6. if(loginUser != null){
  7. return "main";
  8. }else {
  9. //回到登录页面
  10. model.addAttribute("msg","请重新登录");
  11. return "login";
  12. }
  13. }

4、抽取公共页面

5、登录拦截器

1、编写一个拦截器实现HandlerInterceptor接口

  1. @Slf4j
  2. public class LoginInterceptor implements HandlerInterceptor {
  3. /**
  4. * 目标方法执行之前
  5. * @param request
  6. * @param response
  7. * @param handler
  8. * @return
  9. * @throws Exception
  10. */
  11. @Override
  12. public boolean preHandle(HttpServletRequest request, HttpServletResponse response, Object handler) throws Exception {
  13. String requestURI = request.getRequestURI();
  14. log.info("preHandle拦截的请求路径是{}",requestURI);
  15. //登录检查逻辑
  16. HttpSession session = request.getSession();
  17. Object loginUser = session.getAttribute("loginUser");
  18. if(loginUser != null){
  19. //放行
  20. return true;
  21. }
  22. //拦截住。未登录。跳转到登录页
  23. request.setAttribute("msg","请先登录");
  24. // re.sendRedirect("/");
  25. request.getRequestDispatcher("/").forward(request,response);
  26. return false;
  27. }
  28. /**
  29. * 目标方法执行完成以后
  30. * @param request
  31. * @param response
  32. * @param handler
  33. * @param modelAndView
  34. * @throws Exception
  35. */
  36. @Override
  37. public void postHandle(HttpServletRequest request, HttpServletResponse response, Object handler, ModelAndView modelAndView) throws Exception {
  38. log.info("postHandle执行{}",modelAndView);
  39. }
  40. /**
  41. * 页面渲染以后
  42. * @param request
  43. * @param response
  44. * @param handler
  45. * @param ex
  46. * @throws Exception
  47. */
  48. @Override
  49. public void afterCompletion(HttpServletRequest request, HttpServletResponse response, Object handler, Exception ex) throws Exception {
  50. log.info("afterCompletion执行异常{}",ex);
  51. }
  52. }

2、拦截器注册到容器中(实现WebMvcConfigurer的addInterceptors)
3、指定拦截规则【如果是拦截所有,静态资源也会被拦截】

  1. @Configuration
  2. public class AdminWebConfig implements WebMvcConfigurer{
  3. @Override
  4. public void addInterceptors(InterceptorRegistry registry) {
  5. registry.addInterceptor(new LoginInterceptor())
  6. .addPathPatterns("/**") //所有请求都被拦截包括静态资源
  7. .excludePathPatterns("/","/login","/css/**","/fonts/**","/images/**",
  8. "/js/**","/aa/**"); //放行的请求
  9. }
  10. }

6、单与多文件上传

1、配置文件设置单文件与多文件上传大小

  1. spring.servlet.multipart.max-file-size=10MB
  2. spring.servlet.multipart.max-request-size=100MB

2、接口处理文件存储

  1. /**
  2. * MultipartFile 自动封装上传过来的文件
  3. * @param email
  4. * @param username
  5. * @param headerImg
  6. * @param photos
  7. * @return
  8. */
  9. @PostMapping("/upload")
  10. public String upload(@RequestParam("email") String email,
  11. @RequestParam("username") String username,
  12. @RequestPart("headerImg") MultipartFile headerImg,
  13. @RequestPart("photos") MultipartFile[] photos) throws IOException {
  14. log.info("上传的信息:email={},username={},headerImg={},photos={}",
  15. email,username,headerImg.getSize(),photos.length);
  16. if(!headerImg.isEmpty()){
  17. //保存到文件服务器,OSS服务器
  18. String originalFilename = headerImg.getOriginalFilename();
  19. headerImg.transferTo(new File("H:\\cache\\"+originalFilename));
  20. }
  21. if(photos.length > 0){
  22. for (MultipartFile photo : photos) {
  23. if(!photo.isEmpty()){
  24. String originalFilename = photo.getOriginalFilename();
  25. photo.transferTo(new File("H:\\cache\\"+originalFilename));
  26. }
  27. }
  28. }
  29. return "main";
  30. }

3、html

  1. <form method="post" action="/upload" enctype="multipart/form-data">
  2. <input type="file" name="file"><br>
  3. <input type="submit" value="提交">
  4. </form>
  5. <div class="form-group">
  6. <label for="exampleInputFile">头像</label>
  7. <input type="file" name="headerImg" id="exampleInputFile">
  8. </div>
  9. <div class="form-group">
  10. <label for="exampleInputFile">生活照</label>
  11. <input type="file" name="photos" multiple>
  12. </div>

7、异常处理

1、错误处理

1、默认规则

  • 默认情况下,Spring Boot提供/error处理所有错误的映射
  • 对于机器客户端,它将生成JSON响应,其中包含错误,HTTP状态和异常消息的详细信息。对于浏览器客户端,响应一个“ whitelabel”错误视图,以HTML格式呈现相同的数据
  • image.pngimage.png
  • 要对其进行自定义,添加**View**解析为**error**
  • 要完全替换默认行为,可以实现 ErrorController并注册该类型的Bean定义,或添加ErrorAttributes类型的组件以使用现有机制但替换其内容。
  • error/下的4xx,5xx页面会被自动解析;

    • image.png

      2、定制错误处理逻辑

      1、自定义错误页

    • error/404.html error/5xx.html;有精确的错误状态码页面就匹配精确,没有就找 4xx.html;如果都没有就触发白页

    2、@ControllerAdvice+@ExceptionHandler处理全局异常;底层是 ExceptionHandlerExceptionResolver 支持的

    1. /**
    2. * 处理整个web controller的异常
    3. */
    4. @Slf4j
    5. @ControllerAdvice
    6. public class GlobalExceptionHandler {
    7. @ExceptionHandler({ArithmeticException.class,NullPointerException.class}) //处理异常
    8. public String handleArithException(Exception e){
    9. log.error("异常是:{}",e);
    10. return "login"; //视图地址
    11. }
    12. }

    3、@ResponseStatus+自定义异常 ;底层是 ResponseStatusExceptionResolver ,把responsestatus注解的信息底层调用 response.sendError(statusCode, resolvedReason);tomcat发送的/error ```java @ResponseStatus(value= HttpStatus.FORBIDDEN,reason = “用户数量太多”) public class UserTooManyException extends RuntimeException {

    public UserTooManyException(){

    } public UserTooManyException(String message){

    1. super(message);

    } }

  1. 4Spring底层的异常,如 参数类型转换异常;**DefaultHandlerExceptionResolver 处理框架底层的异常。**
  2. - response.sendError(HttpServletResponse.**SC_BAD_REQUEST**, ex.getMessage());
  3. - ![image.png](https://cdn.nlark.com/yuque/0/2020/png/1354552/1606114118010-f4aaf5ee-2747-4402-bc82-08321b2490ed.png?x-oss-process=image%2Fwatermark%2Ctype_d3F5LW1pY3JvaGVp%2Csize_19%2Ctext_YXRndWlndS5jb20g5bCa56GF6LC3%2Ccolor_FFFFFF%2Cshadow_50%2Ct_80%2Cg_se%2Cx_10%2Cy_10#crop=0&crop=0&crop=1&crop=1&height=190&id=NmiFo&margin=%5Bobject%20Object%5D&name=image.png&originHeight=190&originWidth=662&originalType=binary&ratio=1&rotation=0&showTitle=false&size=15123&status=done&style=none&title=&width=662)
  4. 5、自定义实现 HandlerExceptionResolver 处理异常;可以作为默认的全局异常处理规则
  5. - ![image.png](https://cdn.nlark.com/yuque/0/2020/png/1354552/1606114688649-e6502134-88b3-48db-a463-04c23eddedc7.png?x-oss-process=image%2Fwatermark%2Ctype_d3F5LW1pY3JvaGVp%2Csize_16%2Ctext_YXRndWlndS5jb20g5bCa56GF6LC3%2Ccolor_FFFFFF%2Cshadow_50%2Ct_80%2Cg_se%2Cx_10%2Cy_10#crop=0&crop=0&crop=1&crop=1&height=153&id=MuFGL&margin=%5Bobject%20Object%5D&name=image.png&originHeight=153&originWidth=552&originalType=binary&ratio=1&rotation=0&showTitle=false&size=13831&status=done&style=none&title=&width=552)
  6. ```java
  7. @Order(value= Ordered.HIGHEST_PRECEDENCE) //优先级,数字越小优先级越高
  8. @Component
  9. public class CustomerHandlerExceptionResolver implements HandlerExceptionResolver {
  10. @Override
  11. public ModelAndView resolveException(HttpServletRequest request,
  12. HttpServletResponse response,
  13. Object handler, Exception ex) {
  14. try {
  15. response.sendError(511,"我喜欢的错误");
  16. } catch (IOException e) {
  17. e.printStackTrace();
  18. }
  19. return new ModelAndView();
  20. }
  21. }

6、ErrorViewResolver 实现自定义处理异常;

  • response.sendError 。error请求就会转给controller
  • 你的异常没有任何人能处理。tomcat底层 response.sendError。error请求就会转给controller
  • basicErrorController 要去的页面地址是 ErrorViewResolver