当前位置:   article > 正文

SpringBoot(尚硅谷学习笔记)_create stand-alone spring applications

create stand-alone spring applications

1、SpringBoot优点(官网 spring.io)

  • Create stand-alone Spring applications
    • 创建独立Spring应用
  • Embed Tomcat, Jetty or Undertow directly (no need to deploy WAR files)
    • 内嵌web服务器,内含Tomcat
  • Provide opinionated 'starter' dependencies to simplify your build configuration
    • 自动starter依赖,简化构建配置,一个依赖包含所以需要的依赖
  • 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技术栈的快速开发脚手架

image.png

第一个程序HelloWold

pom.xml文件

  1. <?xml version="1.0" encoding="UTF-8"?>
  2. <project xmlns="http://maven.apache.org/POM/4.0.0"
  3. xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
  4. xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/xsd/maven-4.0.0.xsd">
  5. <modelVersion>4.0.0</modelVersion>
  6. <groupId>org.example</groupId>
  7. <artifactId>SpringBoot</artifactId>
  8. <version>1.0-SNAPSHOT</version>
  9. <parent>
  10. <groupId>org.springframework.boot</groupId>
  11. <artifactId>spring-boot-starter-parent</artifactId>
  12. <version>2.5.0</version>
  13. </parent>
  14. <properties>
  15. <mysql.version>5.1.47</mysql.version>
  16. </properties>
  17. <dependencies>
  18. <dependency>
  19. <groupId>org.springframework.boot</groupId>
  20. <artifactId>spring-boot-starter-web</artifactId>
  21. </dependency>
  22. <dependency>
  23. <groupId>mysql</groupId>
  24. <artifactId>mysql-connector-java</artifactId>
  25. </dependency>
  26. </dependencies>
  27. </project>

主程序

  1. package com;
  2. import org.springframework.boot.SpringApplication;
  3. import org.springframework.boot.autoconfigure.SpringBootApplication;
  4. /**
  5. @SpringBootApplication 标志主程序,这是一个springboot应用
  6. */
  7. @SpringBootApplication
  8. public class MainApplication {
  9. public static void main(String[] args) {
  10. //固定写法
  11. SpringApplication.run(MainApplication.class,args);
  12. }
  13. }

controller

  1. package com.controller;
  2. import org.springframework.stereotype.Controller;
  3. import org.springframework.web.bind.annotation.RequestMapping;
  4. import org.springframework.web.bind.annotation.ResponseBody;
  5. import org.springframework.web.bind.annotation.RestController;
  6. @RestController
  7. //@ResponseBody
  8. //@Controller
  9. public class HelloController {
  10. @RequestMapping("/hello")
  11. public String hello(){
  12. return "hello,SpringBoot2";
  13. }
  14. }

application.properties 配置文件(Spring Boot有默认的配置,即使什么都不写)

默认扫描主程序下的包和主程序所在包

    • 想要改变扫描路径,@SpringBootApplication(scanBasePackages="com.atguigu")
      • 或者@ComponentScan 指定扫描路径

2、容器功能

2.1、组件添加

1、@Configuration

       默认是Full模式  @Configuration(proxyBeanMethods = true)

  • 基本使用
  • Full模式与Lite模式   
  • 配置
    类组件之间无依赖关系用Lite模式加速容器启动过程,减少判断   
  • 配置类组件之间有依赖关系,方法会被调用得到之前单实例组件,用Full模
  1. package com.config;
  2. import com.pojo.Pet;
  3. import com.pojo.User;
  4. import org.springframework.beans.factory.annotation.Configurable;
  5. import org.springframework.context.annotation.Bean;
  6. import org.springframework.context.annotation.Configuration;
  7. /**
  8. * * 1、配置类里面使用@Bean标注在方法上给容器注册组件,默认也是单实例的 即proxyBeanMethods = true 如果容器中存在不会重新创建保证单实例
  9. * * 2、配置类本身也是组件
  10. * * 3、proxyBeanMethods:代理bean的方法
  11. * * Full(proxyBeanMethods = true)、【保证每个@Bean方法被调用多少次返回的组件都是单实例的】
  12. * * Lite(proxyBeanMethods = false)【每个@Bean方法被调用多少次返回的组件都是新创建的】
  13. * * 组件依赖必须使用Full模式默认。其他默认是否Lite模式
  14. */
  15. @Configuration(proxyBeanMethods = false) //告诉SpringBoot这是一个配置文件
  16. public class MyConfig {
  17. @Bean
  18. public User user01(){
  19. User user = new User("zhangsan", 18);
  20. // user.setPet(tomcat());
  21. user.setPet(new Pet("daojun"));
  22. return user;
  23. }
  24. @Bean
  25. public Pet tomcat(){
  26. return new Pet("tomcat");
  27. }
  28. }
  1. * 4@Import({User.class, DBHelper.class})
  2. * 给容器中自动创建出这两个类型的组件、默认组件的名字就是全类名
  3. *
  4. *
  5. *
  6. */

@Import导入组件

  1. @Conditional
  2. 条件装配:满足Conditional指定的条件,则进行组件注入
  3. @Conditional()
  4. @ConditionalOnBean(name = tomcat) //有tomcat组件执行操作

@ImportResource  可以通过这个注解导入xml文件

@ImportResource("classpath:beans.xml")

2、@Component、@Controller、@Service、@Repository 加入到容器中

3、绑定配置信息

 3.1@Component //加入到ioc容器中   和  @ConfigurationProperties(prefix = "mycar")

  1. @Data
  2. @AllArgsConstructor
  3. @NoArgsConstructor
  4. @Component //加入到ioc容器中
  5. @ConfigurationProperties(prefix = "mycar")
  6. public class Car {
  7. private String name;
  8. private int price;
  9. }
  10. application.properties 配置文件
  11. mycar.name="BYD"
  12. mycar.price=1

 3.2 @EnableConfigurationProperties(Car.class) 和 @ConfigurationProperties(prefix = "mycar")

  1. @EnableConfigurationProperties(Car.class)
  2. 配置文件中 myconfig 即声明为SpringBoot的配置文件 @Configuration
  3. 加上要绑定核心配置文件内容的类上
  4. @ConfigurationProperties(prefix = "mycar")

3.3 两种绑定配置文件的区别

      注入容器的方式不同

@SpringBootApplication 原理

(详情https://www.yuque.com/atguigu/springboot/qb7hy2   

    基础入门-03自动装配原理)

  1. @SpringBootConfiguration
  2. @EnableAutoConfiguration
  3. @ComponentScan(
  4. excludeFilters = {@Filter(
  5. type = FilterType.CUSTOM,
  6. classes = {TypeExcludeFilter.class}
  7. ), @Filter(
  8. type = FilterType.CUSTOM,
  9. classes = {AutoConfigurationExcludeFilter.class}
  10. )}
  11. )
  12. @SpringBootConfiguration 底层就是一个配置文件 @Configuration
  13. @ComponentScan 指定扫描哪些,Spring注解
  14. 核心
  15. @EnableAutoConfiguration
  16. @AutoConfigurationPackage
  17. @Import({AutoConfigurationImportSelector.class})
  18. 包含127个配置信息类,但是会按需开启配置 (@Conditional

总结:

  • SpringBoot先加载所有的自动配置类  xxxxxAutoConfiguration
  • 每个自动配置类按照条件进行生效,默认都会绑定配置文件指定的值。xxxxProperties里面拿。xxxProperties和配置文件进行了绑定
  • 生效的配置类就会给容器中装配很多组件
  • 只要容器中有这些组件,相当于这些功能就有了
  • 定制化配置

xxxxxAutoConfiguration ---> 组件  ---> xxxxProperties里面拿值  ----> application.properties

3.4、最佳实践

  • 引入场景依赖
  • 查看自动配置了哪些(选做)
    • 自己分析,引入场景对应的自动配置一般都生效了
    • 配置文件中debug=true开启自动配置报告。Negative(不生效)\Positive(生效)
  • 是否需要修改
    • 参照文档修改配置项
    • 自定义加入或者替换组件
      • @Bean、@Component。。。
    • 自定义器  XXXXXCustomizer
    • ......

工具

  1. <!--热更新 ctrl+f9-->
  2. <dependency>
  3. <groupId>org.springframework.boot</groupId>
  4. <artifactId>spring-boot-devtools</artifactId>
  5. <optional>true</optional>
  6. </dependency>

yaml

        key: value   

        key: [ value,value]                      list

        key ; {key:value,key:value }       Map

实例

  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. health: [{name: mario,weight: 47}]

配置提示

   自定义的类和配置文件绑定一般没有提示。  所以添加以下配置

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

2、简单功能分析

2.1、静态资源访问

1、静态资源目录

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

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

原理: 静态映射/**。

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

改变默认的静态资源路径

  1. spring:
  2. mvc:
  3. static-path-pattern: /res/** 静态资源添加前缀 会导致welcomepage失效 favicon.ico失效
  4. resources:
  5. static-locations: [classpath:/haha/] 改静态资源路径的包

Rest风格

  • Rest风格支持(使用HTTP请求方式动词来表示对资源的操作
    • 以前:/getUser   获取用户     /deleteUser 删除用户    /editUser  修改用户       /saveUser 保存用户   太过麻烦
    • 现在: /user    GET-获取用户    DELETE-删除用户     PUT-修改用户      POST-保存用户  还有patch
    • 核心Filter;HiddenHttpMethodFilter
      • 用法: 表单method=post,隐藏域 _method=put
      • SpringBoot中手动开启  
        1. spring:
        2. mvc:
        3. hiddenmethod:
        4. filter:
        5. enabled: true

  1. @RequestMapping(value = "/user",method = RequestMethod.GET)
  2. public String getUser(){
  3. return "GET-张三";
  4. }
  5. @RequestMapping(value = "/user",method = RequestMethod.POST)
  6. public String saveUser(){
  7. return "POST-张三";
  8. }
  9. @RequestMapping(value = "/user",method = RequestMethod.PUT)
  10. public String putUser(){
  11. return "PUT-张三";
  12. }
  13. @RequestMapping(value = "/user",method = RequestMethod.DELETE)
  14. public String deleteUser(){
  15. return "DELETE-张三";
  16. }
  17. <form action="/user" method="post">
  18. <input type="hidden" name="_method" value="delete">
  19. <input value="delete" type="submit">
  20. </form>
  21. <form action="/user" method="post">
  22. <input type="hidden" name="_method" value="put">
  23. <input value="put" type="submit">
  24. </form>
  25. <form action="/user" method="post">
  26. <input type="hidden" name="_method" value="patch">
  27. <input value="patch" type="submit">
  28. </form>
  29. rest原理
  30. 在表单中只能提交get和post请求,所以在表单中通过post提交附带name="_method" value="put"
  31. 在底层嵌套替换原来的请求方式
  32. spring.mvc.hiddenmethod.filter.enabled=true 手动开启后生效
  33. @Bean
  34. @ConditionalOnMissingBean(HiddenHttpMethodFilter.class)
  35. @ConditionalOnProperty(prefix = "spring.mvc.hiddenmethod.filter", name = "enabled", matchIfMissing = false)
  36. public OrderedHiddenHttpMethodFilter hiddenHttpMethodFilter() {
  37. return new OrderedHiddenHttpMethodFilter();
  38. }
  1. @RequestMapping(value = "/user",method = RequestMethod.GET)
  2. @GetMapping("/user")
  3. 两者可以相互替换
  4. 点进@getMapping可以看见
  5. @RequestMapping(
  6. method = {RequestMethod.GET}
  7. )
  8. public @interface GetMapping

自定义rest风格提交名称   将  _method 改成自己想要的

  1. package com.example.boot.configer;
  2. import org.springframework.context.annotation.Bean;
  3. import org.springframework.context.annotation.Configuration;
  4. import org.springframework.web.filter.HiddenHttpMethodFilter;
  5. @Configuration
  6. public class Myconfiger {
  7. @Bean
  8. public HiddenHttpMethodFilter hiddenHttpMethodFilter(){
  9. //自己写 HiddenHttpMethodFilter 注册到容器中 springboot默认的就不生效
  10. HiddenHttpMethodFilter methodFilter = new HiddenHttpMethodFilter();
  11. methodFilter.setMethodParam("_m");
  12. return methodFilter;
  13. }
  14. }

2、请求映射原理

image.png

SpringMVC功能分析都从 org.springframework.web.servlet.DispatcherServlet-》doDispatch()

  1. protected void doDispatch(HttpServletRequest request, HttpServletResponse response) throws Exception {
  2. HttpServletRequest processedRequest = request;
  3. HandlerExecutionChain mappedHandler = null;
  4. boolean multipartRequestParsed = false;
  5. WebAsyncManager asyncManager = WebAsyncUtils.getAsyncManager(request);
  6. try {
  7. ModelAndView mv = null;
  8. Exception dispatchException = null;
  9. try {
  10. processedRequest = checkMultipart(request);
  11. multipartRequestParsed = (processedRequest != request);
  12. // 找到当前请求使用哪个Handler(Controller的方法)处理
  13. mappedHandler = getHandler(processedRequest);
  14. //HandlerMapping:处理器映射。/xxx->>xxxx

image.png

RequestMappingHandlerMapping:保存了所有@RequestMapping 和handler的映射规则。

image.png

所有的请求映射都在HandlerMapping中。

  • SpringBoot自动配置欢迎页的 WelcomePageHandlerMapping 。访问 /能访问到index.html;
  • SpringBoot自动配置了默认 的 RequestMappingHandlerMapping
  • 请求进来,挨个尝试所有的HandlerMapping看是否有请求信息。
    • 如果有就找到这个请求对应的handler
    • 如果没有就是下一个 HandlerMapping

1、普通参数与基本注解

1.1、注解:

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

  1. @PathVariable Map<String,String> m
  2. 可以将参数列表中的值自动装入map中,map的类型必须是<String,String>
  3. @RequestHeader 获取请求头 用Map<String,String>可以自动添加全部请求头加入map中
  4. @RequestParam 获取请求路径中参数 用Map<String,String>可以自动添加全部请求头加入map中
  5. @CookieValue("Idea-57038b6e") String cookie
  6. @RequestBody获取表单 请求体中的信息 {"count":"id=user&pwd=123"}
  1. @RestController
  2. public class parameterController {
  3. @GetMapping("/user/{id}/owner/{username}")
  4. public Map<String,Object> getCar(@PathVariable("id") int id, @PathVariable("username") String name,@PathVariable Map<String,String> m){
  5. //@PathVariable Map<String,String> m 可以将参数列表中的值自动装入map中,map的类型必须是<String,String>
  6. Map<String,Object> map = new HashMap<>();
  7. map.put("id",id);
  8. map.put("username",name);
  9. map.put("m",m);
  10. return map;
  11. }
  12. @GetMapping("/user2/{id}/owner/{username}")
  13. public Map<String,String> getCar2(@PathVariable("id") int id, @PathVariable("username") String name,@RequestHeader Map<String,String> m){
  14. //@RequestHeader 获取请求头 用Map<String,String>可以自动添加全部请求头加入map中
  15. return m;
  16. }
  17. @GetMapping("/user4")
  18. public Map<String,String> getCar3(@RequestParam("id") int id, @RequestParam("username") String name,@RequestParam Map<String,String> m){
  19. //@RequestHeader 获取请求头 用Map<String,String>可以自动添加全部请求头加入map中
  20. return m;
  21. }
  22. @GetMapping("/user5")
  23. public Map<String,String> cooki(@CookieValue("Idea-57038b6e") String cookie){
  24. Map<String,String> map = new HashMap<>();
  25. map.put("cookie",cookie);
  26. return map;
  27. }
  28. @PostMapping("/user6")
  29. public Map post(@RequestBody String count){
  30. //获取表单 请求体中的信息 {"count":"id=user&pwd=123"}
  31. Map<String,String> map = new HashMap<>();
  32. String[] split = count.split("&");
  33. for (String s : split) {
  34. System.out.println(s);
  35. }
  36. map.put("count",count);
  37. return map;
  38. }
  39. }
  1. <a href="/user/2/owner/zhangsan">/user/{id}/owner/{username}</a>
  2. <a href="/user2/2/owner/zhangsan">/user2/{id}/owner/{username}</a>
  3. <a href="/user4?id=3&username=laowang">/user2/{id}/owner/{username}</a>
  4. <a href="/user5">/user5</a>
  5. <form action="/user6" method="post">
  6. id <input type="text" name="id"><br>
  7. pwd <input type="text" name="pwd"><br>
  8. <input type="submit">
  9. </form>

@RequestAttribute  取request里面的属性attribute

@MatrixVariable 矩阵变量

  1. // /boss/2;low=zhangsan;list=list1,list2/3;low=lisi
  2. @GetMapping("/boss/{bossId}/{empId}")
  3. public Map<String,Object> pathvalue(@MatrixVariable(value = "low",pathVar = "bossId") String low,
  4. @MatrixVariable("list") List<String> list,
  5. @PathVariable("bossId") int bossId,
  6. @PathVariable("empId") int empId){
  7. // @MatrixVariable 矩阵变量 与路径携带参数区别 矩阵变量必须依靠在路径变量中即{bossId}中
  8. // 使用矩阵变量必须手动开启 实现WebMvcConfigurer中configurePathMatch方法
  9. // 矩阵变量中有相同的名字时添加路径变量确保唯一性
  10. Map<String,Object> map = new HashMap<>();
  11. map.put("low",low);
  12. map.put("list",list);
  13. map.put("bossId",bossId);
  14. map.put("empId",empId);
  15. return map;
  16. }

  手动开启

  1. @Bean
  2. public WebMvcConfigurer webMvcConfigurer(){
  3. return new WebMvcConfigurer() {
  4. @Override
  5. public void configurePathMatch(PathMatchConfigurer configurer) {
  6. UrlPathHelper urlPathHelper = new UrlPathHelper();
  7. urlPathHelper.setRemoveSemicolonContent(false);
  8. configurer.setUrlPathHelper(urlPathHelper);
  9. }
  10. };
  11. }

各种类型参数原理

    通过请求路径信息,获取方法名,属性值,所标注的注解类型,在底层通过注解解析器挨个遍历尝试解析器能否解析,可以解析,确定参数的值

在目标方法完成后,将所有的数据都放在 ModelAndViewContainer;包含要去的页面地址View。还包含Model数据。

参数中Map和Model的值可以通过request.getAttribute取出,原理是map、model里面的数据会被放在request的请求域,在底层会取出里面的值放入request请求域里面

  1. protected void exposeModelAsRequestAttributes(Map<String, Object> model,
  2. HttpServletRequest request) throws Exception {
  3. //model中的所有数据遍历挨个放在请求域中
  4. model.forEach((name, value) -> {
  5. if (value != null) {
  6. request.setAttribute(name, value);
  7. }
  8. else {
  9. request.removeAttribute(name);
  10. }
  11. });
  12. }

pojo的封装使用

   页面提交的请求数据(get,post)可以和对象属性相互对应

  1. @PostMapping("/user7")
  2. public User pojo(User user){
  3. return user;
  4. }
  1. <form action="/user7" method="post">
  2. name <input type="text" name="name"><br>
  3. age <input type="text" name="age"><br>
  4. pet.name <input type="text" name="pet.name"><br>
  5. <input type="submit">
  6. </form>

原理:判断方法参数是否为简单数据类型,是复杂类型则创建一个全为Null的复杂类型(pojo),通过converters将请求参数的值转换成需要的类型并绑定到pojo类型的属性上

  1. 判断是否为普通类型
  2. public static boolean isSimpleValueType(Class<?> type) {
  3. return (Void.class != type && void.class != type &&
  4. (ClassUtils.isPrimitiveOrWrapper(type) ||
  5. Enum.class.isAssignableFrom(type) ||
  6. CharSequence.class.isAssignableFrom(type) ||
  7. Number.class.isAssignableFrom(type) ||
  8. Date.class.isAssignableFrom(type) ||
  9. Temporal.class.isAssignableFrom(type) ||
  10. URI.class == type ||
  11. URL.class == type ||
  12. Locale.class == type ||
  13. Class.class == type));
  14. }

image.png

添加自定义格式化器  converters

  1. 添加自定义格式化器 自定义转换 pet.name,pat.age
  2. @Override
  3. public void addFormatters(FormatterRegistry registry) {
  4. registry.addConverter(new Converter<String, Pet>() {
  5. @Override
  6. public Pet convert(String s) {
  7. if (!StringUtils.isEmpty(s)){
  8. String[] split = s.split(",");
  9. Pet pet = new Pet();
  10. pet.setName(split[0]);
  11. pet.setAge(Integer.parseInt(split[1]));
  12. return pet;
  13. }
  14. return null;
  15. }
  16. });
  17. }
  1. <form action="/user8" method="post">
  2. name <input type="text" name="name"><br>
  3. age <input type="text" name="age"><br>
  4. pet.name和pet.age <input type="text" name="pet" value="阿猫,3"><br>
  5. <input type="submit">
  6. </form>

给前端自动返回json数据

    导入start-web依赖

  1. @ResponseBody
  2. @GetMapping("/test/user")
  3. public User test(){
  4. User user = new User();
  5. user.setName("狗俊");
  6. user.setAge(17);
  7. return user;
  8. }

 原理 通过返回值转换器,遍历找到可处理的消息转换器转换成json数据

具体

      RequestResponseBodyMethodProcessor 可以处理返回值标了@ResponseBody 注解的。

      利用 MessageConverters 进行处理 将数据写为json

      内容协商(浏览器默认会以请求头的方式告诉服务器他能接受什么样的内容类型

      服务器最终根据自己自身的能力,决定服务器能生产出什么样内容类型的数据,

      SpringMVC会挨个遍历所有容器底层的 HttpMessageConverter ,看谁能处理?

    • 1、得到MappingJackson2HttpMessageConverter可以将对象写为json
    • 2、利用MappingJackson2HttpMessageConverter将对象转为json再写出去。

默认的MessageConverters

0 - 只支持Byte类型的

1 - String

2 - String

3 - Resource

4 - ResourceRegion

5 - DOMSource.class \ SAXSource.class) \ StAXSource.class \StreamSource.class \Source.class

6 - MultiValueMap

7 - true

8 - true

9 - 支持注解方式xml处理的。

2、内容协商

内容协商包含响应数据响应页面

响应数据

根据客户端接收能力不同,返回不同媒体类型的数据。

客户端发送可以接受的类型

text/html,application/xhtml+xml,application/xml;q=0.9,

image/avif,image/webp,image/apng,*/*;q=0.8,

application/signed-exchange;v=b3;q=0.9

服务器可以向客户端返回的类型  由选中的类型决定@ResponseBody/导入xml依赖,多种结果则看权重

双方的类型相互匹配找到客户端接收,服务器可产生的,找到最佳匹配

开启浏览器请求参数的内容协商功能

  1. spring:
  2. mvc:
  3. contentnegotiation:
  4. favor-parameter: true

http://localhost:8080/test/user?format=json

http://localhost:8080/test/user?format=xml

确定客户端接收什么样的内容类型;

1、Parameter策略优先确定是要返回json数据(获取请求头中的format的值)

image.png

2、最终进行内容协商返回给客户端json即可。

自定义返回值类型   ( 返回值;返回值)

http://localhost:8080/test/user?format=gg

  1. //自定义返回值类型 通过第三方发送
  2. @Override
  3. public void extendMessageConverters(List<HttpMessageConverter<?>> converters) {
  4. converters.add(new GuiguMessageConverter());
  5. }
  6. /**
  7. * 自定义内容协商策略 自定义返回值类型 format发送
  8. * @param configurer
  9. */
  10. @Override
  11. public void configureContentNegotiation(ContentNegotiationConfigurer configurer) {
  12. Map<String, MediaType> mediaTypes=new HashMap<>();
  13. mediaTypes.put("json",MediaType.APPLICATION_JSON);
  14. mediaTypes.put("xml",MediaType.APPLICATION_XML);
  15. mediaTypes.put("gg",MediaType.parseMediaType("application/x-guigu"));
  16. ParameterContentNegotiationStrategy strategy = new ParameterContentNegotiationStrategy(mediaTypes);
  17. HeaderContentNegotiationStrategy headerContentNegotiationStrategy = new HeaderContentNegotiationStrategy();
  18. configurer.strategies(Arrays.asList(strategy,headerContentNegotiationStrategy));
  19. }
  1. /**
  2. * 自定义的Converter
  3. */
  4. public class GuiguMessageConverter implements HttpMessageConverter<User> {
  5. @Override
  6. public boolean canRead(Class<?> clazz, MediaType mediaType) {
  7. return false;
  8. }
  9. @Override
  10. public boolean canWrite(Class<?> clazz, MediaType mediaType) {
  11. return clazz.isAssignableFrom(User.class);
  12. }
  13. /**
  14. * 服务器要统计所有MessageConverter都能写出哪些内容类型
  15. *
  16. * application/x-guigu
  17. * @return
  18. */
  19. @Override
  20. public List<MediaType> getSupportedMediaTypes() {
  21. return MediaType.parseMediaTypes("application/x-guigu");
  22. }
  23. @Override
  24. public User read(Class<? extends User> clazz, HttpInputMessage inputMessage) throws IOException, HttpMessageNotReadableException {
  25. return null;
  26. }
  27. @Override
  28. public void write(User person, MediaType contentType, HttpOutputMessage outputMessage) throws IOException, HttpMessageNotWritableException {
  29. //自定义协议数据的写出
  30. String data = person.getName()+";"+person.getAge()+";";
  31. //写出去
  32. OutputStream body = outputMessage.getBody();
  33. body.write(data.getBytes());
  34. }
  35. }

5、视图解析与模板引擎

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

导入依赖

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

页面规则   放在指定位置

  1. public static final String DEFAULT_PREFIX = "classpath:/templates/";
  2. public static final String DEFAULT_SUFFIX = ".html"; //xxx.html

html中添加命名空间  

<html lang="en" xmlns:th="http://www.thymeleaf.org">
  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.taobao.com" th:href="${link}">百度</a>
  11. <a href="www.taobao.com" th:href="@{link}">百度</a>
  12. </h2>
  13. </body>
  14. </html>
  1. @GetMapping("/view")
  2. public String test(Model model){
  3. model.addAttribute("msg","Hello World");
  4. model.addAttribute("link","http://www.baidu.com");
  5. return "success";
  6. }

基于thymeleaf 的后台管理系统模板  web-admin

行内取值  [ [ $ { } ] ]

  1. <div id="comdiv">
  2. <link href="css/style.css" th:href="@{/css/style.css}" rel="stylesheet">
  3. <link href="css/style-responsive.css" th:href="@{/css/style-responsive.css}" rel="stylesheet">
  4. <!-- HTML5 shim and Respond.js IE8 support of HTML5 elements and media queries -->
  5. <!--[if lt IE 9]>
  6. <script th:src="@{/js/html5shiv.js}"></script>
  7. <script th:src="@{/js/respond.min.js}"></script>
  8. <![endif]-->
  9. </div>
  10. <link th:replace="common :: #comdiv">
  11. th:replace 去除link加上div
  12. <link th:include="common :: #comdiv">
  13. th:include 去除div保留link

遍历 

1、视图解析原理流程

1、目标方法处理的过程中,所有数据都会被放在 ModelAndViewContainer 里面。包括数据和视图地址

2、方法的参数是一个自定义类型对象(从请求参数中确定的),把他重新放在 ModelAndViewContainer

3、任何目标方法执行完成以后都会返回 ModelAndView(数据和视图地址) 

所有的视图解析器根据方法的String返回值依次尝试得到 View 对象【定义了页面的渲染逻辑】

view.render(mv.getModelInternal(), request, response);   视图对象调用自定义的render进行页面渲染工作

  • RedirectView 如何渲染【重定向到一个页面】
  • 1、获取目标url地址
  • 2、response.sendRedirect(encodedURL);

返回值以 forward: 开始-->

 转发request.getRequestDispatcher(path).forward(request, response);

拦截器

自定义拦截器,将拦截器注册到容器中

  1. public class LoginInterceptor implements HandlerInterceptor {
  2. @Override
  3. public boolean preHandle(HttpServletRequest request, HttpServletResponse response, Object handler) throws Exception {
  4. HttpSession session = request.getSession();
  5. if (session.getAttribute("loginInfo") != null){
  6. return true;
  7. }else {
  8. request.setAttribute("msg","请先登录");
  9. request.getRequestDispatcher("/").forward(request,response);
  10. return false;
  11. }
  12. }
  13. }
  1. @Configuration
  2. public class MyConfiger implements WebMvcConfigurer {
  3. @Override
  4. public void addInterceptors(InterceptorRegistry registry) {
  5. registry.addInterceptor(new LoginInterceptor())
  6. .addPathPatterns("/**") // /** 拦截所以资源,包括静态资源
  7. .excludePathPatterns("/","/login","/css/**","/fonts/**","/images/**","/js/**","favicon.ico");
  8. }
  9. }

文件上传

  1. enctype="multipart/form-data" 必须写
  2. <div class="panel-body">
  3. <form role="form" method="post" th:action="@{/upload}" enctype="multipart/form-data">
  4. <div class="form-group">
  5. <label for="exampleInputEmail1">Email</label>
  6. <input type="email" name="email" class="form-control" id="exampleInputEmail1" placeholder="Enter email">
  7. </div>
  8. <div class="form-group">
  9. <label for="exampleInputPassword1">name</label>
  10. <input type="text" name="username" class="form-control" id="exampleInputPassword1" placeholder="Password">
  11. </div>
  12. <div class="form-group">
  13. <label for="exampleInputFile">headerImg</label>
  14. <input type="file" name="headerImg" id="exampleInputFile">
  15. </div>
  16. <div class="form-group">
  17. <label for="exampleInputFile">headerImg</label>
  18. <input type="file" name="photos" multiple>
  19. <!-- multiple 多文件-->
  20. </div>
  21. <div class="checkbox">
  22. <label>
  23. <input type="checkbox"> Check me out
  24. </label>
  25. </div>
  26. <button type="submit" class="btn btn-primary">Submit</button>
  27. </form>
  28. </div>

  MultipartFile 自动封装上传的文件

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

文件上传原理

文件上传自动配置类-MultipartAutoConfiguration-MultipartProperties

自动配置好了 StandardServletMultipartResolver   【文件上传解析器】

  • 原理步骤
    • 1、请求进来使用文件上传解析器判断(isMultipart)并封装(resolveMultipart,返回MultipartHttpServletRequest)文件上传请求
    • 2、参数解析器来解析请求中的文件内容封装成MultipartFile
    • 3、将request中文件信息封装为一个Map;MultiValueMap<String, MultipartFile>

FileCopyUtils。实现文件流的拷贝

默认错误处理机制

默认规则

  • 默认情况下,Spring Boot提供/error处理所有错误的映射
  • 对于机器客户端,它将生成JSON响应,其中包含错误,HTTP状态和异常消息的详细信息。对于浏览器客户端,响应一个“ whitelabel”错误视图,以HTML格式呈现相同的数据
  • error/下的4xx,5xx页面会被自动解析,可以放在templates下也可以放在static下
  • image.png

2、定制错误处理逻辑

  • 自定义错误页
    • error/404.html   error/5xx.html;有精确的错误状态码页面就匹配精确,没有就找 4xx.html;如果都没有就触发白页
    • 默认情况下没有能处理异常的解释器,会触发/error请求使 白页或者json返回
  • @ControllerAdvice+@ExceptionHandler处理全局异常;底层是 ExceptionHandlerExceptionResolver 支持的
  • @ResponseStatus+自定义异常 ;底层是 ResponseStatusExceptionResolver ,把responsestatus注解的信息底层调用 response.sendError(statusCode, resolvedReason);tomcat发送的/error
  • Spring底层的异常,如 参数类型转换异常;DefaultHandlerExceptionResolver 处理框架底层的异常。
  • 3、异常处理组件
    • 容器中的组件:类型:BasicErrorController --> id:basicErrorController(json+白页 适配响应)
      • 处理默认 /error 路径的请求;页面响应 new ModelAndView("error", model);
      • 容器中有组件 View->id是error;(响应默认错误页)
      • 容器中放组件 BeanNameViewResolver(视图解析器);按照返回的视图名作为组件的id去容器中找View对象。
    • 容器中的组件:类型:DefaultErrorViewResolver -> id:conventionErrorViewResolver
      • 如果发生错误,会以HTTP的状态码 作为视图页地址(viewName),找到真正的页面
      • error/404、5xx.html

4、异常处理步骤流程

1、执行目标方法,目标方法运行期间有任何异常都会被catch、而且标志当前请求结束;并且用 dispatchException,保存catch得到的异常

2、进入视图解析流程(页面渲染)

processDispatchResult(processedRequest, response, mappedHandler, mv, dispatchException);   有异常时,mv为空,异常保存在了dispatchException中

3、mv = processHandlerException;处理handler发生的异常,处理完成返回ModelAndView;

  • 1、遍历所有的 handlerExceptionResolvers,看谁能处理当前异常【HandlerExceptionResolver处理器异常解析器
  • 2、系统默认的  异常解析器;
  • image.png
    • 1、DefaultErrorAttributes先来处理异常。定义一些属性如状态码,错误信息等异常信息保存到request域,并且返回null;
    • 2、默认没有任何人能处理异常,所以异常会被抛出
      • 1、如果没有任何人能处理最终底层就会发送 /error 请求。会被底层的BasicErrorController处理
      • 2、解析错误视图;遍历所有的  ErrorViewResolver  看谁能解析。
      • image.png
        https://www.yuque.com/atguigu/springboot
      • 3、默认的 DefaultErrorViewResolver ,作用是把响应状态码作为错误页的地址,error/500.html
      • 4、模板引擎最终响应这个页面 error/500.html

9、Web原生组件注入(Servlet、Filter、Listener)

1、使用Servlet API

@ServletComponentScan(basePackages = "com.atguigu.admin") :指定原生Servlet组件都放在那里

@WebServlet(urlPatterns = "/my"):效果:直接响应,没有经过Spring的拦截器?

@WebFilter(urlPatterns={"/css/*","/images/*"})

@WebListener

推荐可以这种方式;

  1. 实例
  2. @WebServlet(urlPatterns = "/my")
  3. public class MyServlet extends HttpServlet {
  4. @Override
  5. protected void doGet(HttpServletRequest req, HttpServletResponse resp) throws ServletException, IOException {
  6. resp.getWriter().write("6666");
  7. }
  8. }
  9. @Slf4j
  10. @WebFilter(urlPatterns = {"/css/*","/my"})
  11. public class MyFilter implements Filter {
  12. @Override
  13. public void init(FilterConfig filterConfig) throws ServletException {
  14. log.info("MyFilter初始化完成");
  15. }
  16. @Override
  17. public void doFilter(ServletRequest servletRequest, ServletResponse servletResponse, FilterChain filterChain) throws IOException, ServletException {
  18. log.info("MyFilter工作");
  19. filterChain.doFilter(servletRequest,servletResponse); //放行
  20. }
  21. @Override
  22. public void destroy() {
  23. log.info("MyFilter销毁");
  24. }
  25. }
  26. @Slf4j
  27. @WebListener
  28. public class MyListener implements ServletContextListener {
  29. @Override
  30. public void contextInitialized(ServletContextEvent sce) {
  31. //监听项目初始化
  32. log.info("MyListener:项目初始化完成");
  33. }
  34. @Override
  35. public void contextDestroyed(ServletContextEvent sce) {
  36. log.info("MyListener:项目销毁");
  37. }
  38. }
  39. @ServletComponentScan(basePackages = "com.example.webadmin")
  40. @SpringBootApplication
  41. public class WebAdminApplication {
  42. public static void main(String[] args) {
  43. SpringApplication.run(WebAdminApplication.class, args);
  44. }
  45. }

2、使用RegistrationBean

ServletRegistrationBean, FilterRegistrationBean, and ServletListenerRegistrationBean

  1. @Configuration
  2. public class MyRegistConfig {
  3. @Bean
  4. public ServletRegistrationBean myServlet(){
  5. MyServlet myServlet = new MyServlet();
  6. return new ServletRegistrationBean(myServlet,"/my","/my02");
  7. }
  8. @Bean
  9. public FilterRegistrationBean myFilter(){
  10. MyFilter myFilter = new MyFilter();
  11. // return new FilterRegistrationBean(myFilter,myServlet());
  12. FilterRegistrationBean filterRegistrationBean = new FilterRegistrationBean(myFilter);
  13. filterRegistrationBean.setUrlPatterns(Arrays.asList("/my","/css/*"));
  14. return filterRegistrationBean;
  15. }
  16. @Bean
  17. public ServletListenerRegistrationBean myListener(){
  18. MySwervletContextListener mySwervletContextListener = new MySwervletContextListener();
  19. return new ServletListenerRegistrationBean(mySwervletContextListener);
  20. }
  21. }

11、定制化原理

1、定制化的常见方式

  • 修改配置文件;
  • xxxxxCustomizer;
  • 编写自定义的配置类   xxxConfiguration;+ @Bean替换、增加容器中默认组件;视图解析器
  • Web应用 编写一个配置类实现 WebMvcConfigurer 即可定制化web功能;+ @Bean给容器中再扩展一些组件

2、原理分析套路

场景starter - xxxxAutoConfiguration - 导入xxx组件 - 绑定xxxProperties -- 绑定配置文件项

06、数据访问

1、SQL

1、数据源的自动配置-HikariDataSource

JdbcTemplateAutoConfiguration: JdbcTemplate的自动配置,可以来对数据库进行crud

  1. <dependency>
  2. <groupId>org.springframework.boot</groupId>
  3. <artifactId>spring-boot-starter-data-jdbc</artifactId>
  4. </dependency>
  5. <dependency>
  6. <groupId>mysql</groupId>
  7. <artifactId>mysql-connector-java</artifactId>
  8. <version>5.1.47</version>
  9. </dependency>
  1. Long aLong = jdbcTemplate.queryForObject("select count(*) from books", Long.class);
  2. log.info("查到的数据{}",aLong);

 yml

  1. spring:
  2. datasource:
  3. driver-class-name: com.mysql.jdbc.Driver
  4. url: jdbc:mysql://localhost:3366/ssmbuild
  5. password: 123456
  6. username: root

2、使用Druid数据源

1、druid官方github地址

https://github.com/alibaba/druid

使用官方starter方式

1、引入druid-starter

  1. <dependency>
  2. <groupId>com.alibaba</groupId>
  3. <artifactId>druid-spring-boot-starter</artifactId>
  4. <version>1.1.17</version>
  5. </dependency>

 监控页等功能   /druid  进入监控页

  1. spring:
  2. datasource:
  3. driver-class-name: com.mysql.jdbc.Driver
  4. url: jdbc:mysql://localhost:3366/ssmbuild
  5. password: 123456
  6. username: root
  7. druid:
  8. aop-patterns: com.atguigu.admin.* #监控SpringBean
  9. filters: stat,wall # 底层开启功能,stat(sql监控),wall(防火墙)
  10. # 配置监控页功能
  11. stat-view-servlet:
  12. enabled: true
  13. login-username: admin
  14. login-password: 123
  15. web-stat-filter:
  16. enabled: true
  17. url-pattern: /*
  18. exclusions: '*.js,*.gif,*.jpg,*.png,*.css,*.ico,/druid/*'
  19. filter:
  20. stat: # 对上面filters里面的stat的详细配置
  21. slow-sql-millis: 1000
  22. logSlowSql: true
  23. enabled: true
  24. wall:
  25. enabled: true
  26. config:
  27. drop-table-allow: false

SpringBoot配置示例

https://github.com/alibaba/druid/tree/master/druid-spring-boot-starter

配置项列表https://github.com/alibaba/druid/wiki/DruidDataSource%E9%85%8D%E7%BD%AE%E5%B1%9E%E6%80%A7%E5%88%97%E8%A1%A8

3、整合MyBatis操作

https://github.com/mybatis

starter

SpringBoot官方的Starter:spring-boot-starter-*

第三方的: *-spring-boot-starter

  1. <dependency>
  2. <groupId>org.mybatis.spring.boot</groupId>
  3. <artifactId>mybatis-spring-boot-starter</artifactId>
  4. <version>2.1.4</version>
  5. </dependency>

Mapper: 只要我们写的操作MyBatis的接口标准了 @Mapper 就会被自动扫描进来

  • 导入mybatis官方starter
  • 编写mapper接口。标准@Mapper注解
  • 编写sql映射文件并绑定mapper接口
  • 在application.yaml中指定Mapper配置文件的位置,以及指定全局配置文件的信息 (建议;配置在mybatis.configuration
  1. 实体类
  2. @Data
  3. @AllArgsConstructor
  4. @NoArgsConstructor
  5. public class Books {
  6. private int bookID;
  7. private String bookName;;
  8. private int bookCounts;
  9. private String detail;
  10. }
  1. @Mapper
  2. public interface BooksMapper {
  3. public Books getBooks(int id);
  4. }
  1. <?xml version="1.0" encoding="UTF8" ?>
  2. <!DOCTYPE mapper
  3. PUBLIC "-//mybatis.org//DTD Mapper 3.0//EN"
  4. "http://mybatis.org/dtd/mybatis-3-mapper.dtd">
  5. <!--namespace=绑定一个对应的Dao/Mapper接口-->
  6. <mapper namespace="com.example.webadmin.mapper.BooksMapper">
  7. <select id="getBooks" resultType="com.example.webadmin.pojo.Books">
  8. select * from Books where bookID=#{id}
  9. </select>
  10. </mapper>
  1. @Service
  2. public class BooksService implements BooksMapper {
  3. @Autowired
  4. BooksMapper booksMapper;
  5. @Override
  6. public Books getBooks(int id) {
  7. Books books = booksMapper.getBooks(id);
  8. return books;
  9. }
  10. }
  1. @Autowired
  2. BooksService booksService;
  3. @ResponseBody
  4. @GetMapping("/book")
  5. public Books getBooks(@RequestParam("id") int id){
  6. Books books = booksService.getBooks(id);
  7. return books;
  8. }
  1. mybatis:
  2. mapper-locations: classpath:mybatis/mapper/*.xml
  3. configuration:
  4. map-underscore-to-camel-case: true

注解版

  1. @Select("select * from Books where bookID=#{id}")
  2. public Books getBooks2(int id);
  1. @Service
  2. public class BooksService implements BooksMapper {
  3. @Autowired
  4. BooksMapper booksMapper;
  5. @Override
  6. public Books getBooks2(int id) {
  7. Books books = booksMapper.getBooks(id);
  8. return books;
  9. }
  10. }
  1. @Autowired
  2. BooksService booksService;
  3. @ResponseBody
  4. @GetMapping("/book2")
  5. public Books getBooks2(@RequestParam("id") int id){
  6. Books books = booksService.getBooks2(id);
  7. return books;
  8. }

最佳实战:

  • 引入mybatis-starter
  • 配置application.yaml中,指定mapper-location位置即可
  • 编写Mapper接口并标注@Mapper注解
  • 简单方法直接注解方式
  • 复杂方法编写mapper.xml进行绑定映射
  • @MapperScan("com.atguigu.admin.mapper") 简化,其他的接口就可以不用标注@Mapper注解

未完可看https://www.yuque.com/atguigu/springboot

声明:本文内容由网友自发贡献,不代表【wpsshop博客】立场,版权归原作者所有,本站不承担相应法律责任。如您发现有侵权的内容,请联系我们。转载请注明出处:https://www.wpsshop.cn/w/繁依Fanyi0/article/detail/710295
推荐阅读
相关标签
  

闽ICP备14008679号