第四章 SpringBoot整合Web开发

1、返回Json数据

SpringMvc中使用消息转换器HttpMessageConverter对Json转换提供了很好的支持。而SpringBoot提供了更加简便的方式。只要添加web依赖就自动默认添加了jackson-databind这个json处理器,这是使用了spring中默认的MappingJson2HttpMessageConverter来实现的。

• 创建springboot项目，而不是maven项目
• 添加依赖

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

• 实体类和controller类,主要是在contrller里添加responsebody注解，
  如果这个两个注解要用很多次，可以使用restresponse注解来替代。

public class Book {

    private Integer id;
    private String name;
    private String author;
    @JsonIgnore
    private Float price;
    @JsonFormat(pattern = "yyyy-MM-dd")
    private Date publicDate;

@Controller
@ResponseBody
public class BookController {

    @GetMapping("/book")
    public Book books(){
        Book book1 = new Book();
        book1.setId(1);
        book1.setName("springboot");
        book1.setAuthor("王松");
        book1.setPrice(15.6f);
        book1.setPublicDate(new Date());
        return  book1;

    }
}

• 运行

  
  image.png

2、自定义转换器

常见的json处理器除了jackson转换器外还有gson和fastson。

2.1 使用gson

• gjson是谷歌开源的一个解析框架。
• 默认去除jackson，再添加gson依赖。(这里加上web的版本还是加上如果不加会自动去下载最新的版本统一一点比较好)

<dependency>
            <groupId>org.springframework.boot</groupId>
            <artifactId>spring-boot-starter-web</artifactId>
            <exclusions>
                <exclusion>
                    <groupId>com.fasterxml.jackson.core</groupId>
                    <artifactId>jackson-databind</artifactId>
                </exclusion>
            </exclusions>
            <version>2.1.4.RELEASE</version>
        </dependency>
        <dependency>
            <groupId>com.google.code.gson</groupId>
            <artifactId>gson</artifactId>
            <version>2.8.5</version>
        </dependency>

• springboot中默认提供了gson的自动转换类GsonhttpMessageConvertersConfiguration,所以添加gson依赖后就可以像使用jackson一样使用gson了，但是如果在转换的时候需要转换格式化日期，还需要开发者自定义HttpMessageConverter

/**
 * @Author ljs
 * @Description 开发者自己提供一个GsonHttpMessageConverter的实例
 * @Date 2019/4/13 23:20
 **/
@Configuration
public class GsonConfig {

    @Bean
    GsonHttpMessageConverter gsonHttpMessageConverter(){

        GsonHttpMessageConverter gsonHttpMessageConverter = new GsonHttpMessageConverter();
        GsonBuilder gsonBuilder = new GsonBuilder();
        //设置gson的日期格式
        gsonBuilder.setDateFormat("yyyy-MM-dd");
        // 设置gson解析时修饰符为protected字段被过滤掉
        gsonBuilder.excludeFieldsWithModifiers(Modifier.PROTECTED);
        Gson gson = gsonBuilder.create();
        gsonHttpMessageConverter.setGson(gson);
        return gsonHttpMessageConverter;
    }
}

public class Book {

    private Integer id;
    private String name;
    private String author;
    protected Float price;
    private Date publicDate;

• 运行

  
  image.png

2.2 使用fastjson

• fastjson是阿里开源的一个json解析框架，是目前解析速度最快的开源框架。
• 创建springboot项目
• 加入依赖

    <dependency>
            <groupId>org.springframework.boot</groupId>
            <artifactId>spring-boot-starter-web</artifactId>
            <version>2.1.4.RELEASE</version>
            <exclusions>
                <exclusion>
                    <groupId>com.fasterxml.jackson.core</groupId>
                    <artifactId>jackson-databind</artifactId>
                </exclusion>
            </exclusions>
        </dependency>

        <dependency>
            <groupId>com.alibaba</groupId>
            <artifactId>fastjson</artifactId>
            <version>1.2.12</version>
        </dependency>

• fastjson加入依赖后并不能马上使用需要开发者提供相应的HttpMessageConverter后才能使用。

@Configuration
public class MyFastJsonConfig {

    @Bean
    FastJsonHttpMessageConverter fastJsonHttpMessageConverter(){
        FastJsonHttpMessageConverter converter = new FastJsonHttpMessageConverter();
        FastJsonConfig config = new FastJsonConfig();
        //设置日期
        config.setDateFormat("yyyy-MM-dd");
        //设置编码
        config.setCharset(Charset.forName("utf-8"));
        config.setSerializerFeatures(
                //是否在生成的json中输出类名
                SerializerFeature.WriteClassName,
                //是否输出value为null的数据
                SerializerFeature.WriteMapNullValue,
                //生成json格式化
                SerializerFeature.PrettyFormat,
                //空集合输出[]而非null
                SerializerFeature.WriteNullListAsEmpty,
                //空字符输出而“”而非null
                SerializerFeature.WriteNullStringAsEmpty
        );
        converter.setFastJsonConfig(config);
        return converter;
    }
}

• MyFastJsonConfig配置好后，还需要配置一下响应编码，否则返回的json中文会乱码。（application.properties）

spring.http.encoding.force-response=true

• 运行

  
  image.png
• fastjson除了FastJsonHttpMessageConverter的配置外，还有另一种配置方式，那就是实现WebMvcConfigurerAdapter类。该类在spring-boot-autoconfigure依赖里，而spring-boot-starter-web又依赖这个依赖，这个类提供了springmvc最基本配置。如果某一项自动化配置不满足开发需求，可以针对该项自定义配置。spring5.0之前是继承该类，5.0之后是实现。

@Configuration
public class MyWebMvcConfig implements WebMvcConfigurer {
    @Override
    public void configureMessageConverters(List<HttpMessageConverter<?>> converters) {
        FastJsonHttpMessageConverter converter = new FastJsonHttpMessageConverter();
        FastJsonConfig config = new FastJsonConfig();
        config.setDateFormat("yyyy-MM-dd");
        config.setCharset(Charset.forName("utf-8"));
        config.setSerializerFeatures(
                SerializerFeature.WriteClassName,
                SerializerFeature.WriteMapNullValue,
                SerializerFeature.PrettyFormat,
                SerializerFeature.WriteNullListAsEmpty,
                SerializerFeature.WriteNullListAsEmpty
        );
        converter.setFastJsonConfig(config);
        converters.add(converter);
    }
}

• 运行，记得去掉之前的MyFastJsonConfig的@Configuration注解。

• gson不推荐使用实现WebMvcConfigurer这种方式，因为springboot自己提供了GsonHttpMessageConverter，当你重写configureMessageConverters方法的时候，参数converters里已经有了这个GsonHttpMessageConverter，需要把自己写替换掉它比较麻烦。所以不建议使用这种方式。

3 静态资源访问

• spring mvc中，对于静态资源都需要开发者手动配置静态资源过滤。Spring Boot 中对此也提供了自动化配置，可以简化静态资源过滤配置。

3.1 默认策略

Springboot对于SpringMvc的自动化配置都在WebMvcAutoConfiguration类中。先从这个类中看看它的默认策略。
WebMvcAutoConfiguration类中有个WebMvcAutoConfigurationAdapter内部类，这个类实现了WebMvcConfigurer，而WebMvcConfigurer里有一个方法专门是用来配置静态资源过滤addResourceHandlers(ResourceHandlerRegistry registry)，所以静态类WebMvcAutoConfigurationAdapter主要是通过实现该方法来改变过滤默认策略，

WebMvcAutoConfigurationAdapter类里的addResourceHandlers方法

image.png

而默认的匹配策略在WebMvcProperties这个属性文件中，/**的意思是默认过滤所有静态资源
WebMvcProperties类

image.png

而获取到的默认静态资源位置定义在 ResourceProperties中。意思就是静态资源的位置只在下面这些地方
ResourceProperties类

image.png

但是getResourceLocations 方法中对这四个资源位置做了扩充，加了一个
SERVLET_LOCATIONS，而这个的定义就是“/”,所以总共有五个存放静态资源的地方，但是springboot项目不需要webapp所以第五个一般不考虑，其他优先级别以次降低。

image.png

3.2 默认静态资源实战

• 创建一个springboot项目
• 加入web依赖

• 在resources目录下创建四个目录，分别为并且放入不同的静态文件但是名字相同

  
  image.png
• 运行，访问http://localhost:8080/default.jpg
  这是META-INF下的
  image.png
  把META-INF下的删掉，变成resources下的
  image.png
  以此类推。
• 一般使用idea创建springboot项目，会默认创建classpath:/static/目录，静态资源一般放这里。

3.3 自定义策略

• 当你觉得默认配置不符合要求的时候，可以自定义策略，就是改匹配规则和存放位置。
• 在配置文件中定义
  意思是过滤规则为/static/**， 静态资源位置classpath:/static/。

spring.mvc.static-path-pattern=/static/**
spring.resources.static-locations=classpath:/static/

• java编码定义
  自己实现addResourceHandlers方法

@Configuration
public class MyWebMvcConfig implements WebMvcConfigurer {

    @Override
    public void addResourceHandlers(ResourceHandlerRegistry registry) {
        registry.addResourceHandler("/static/**")
                .addResourceLocations("classpath:/static/");

    }
}

• 最后启动项目输入http://localhost:8080/static/default.jpg，可以看到这是static文件夹下的图片。
  image.png