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;
}
}
-
运行
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;
-
运行
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
-
运行
- 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方法
而默认的匹配策略在WebMvcProperties这个属性文件中,/**的意思是默认过滤所有静态资源
WebMvcProperties类
而获取到的默认静态资源位置定义在 ResourceProperties中。意思就是静态资源的位置只在下面这些地方
ResourceProperties类
但是getResourceLocations 方法中对这四个资源位置做了扩充,加了一个
SERVLET_LOCATIONS,而这个的定义就是“/”,所以总共有五个存放静态资源的地方,但是springboot项目不需要webapp所以第五个一般不考虑,其他优先级别以次降低。
3.2 默认静态资源实战
- 创建一个springboot项目
- 加入web依赖
-
在resources目录下创建四个目录,分别为并且放入不同的静态文件但是名字相同
- 运行,访问http://localhost:8080/default.jpg
这是META-INF下的
把META-INF下的删掉,变成resources下的
以此类推。 - 一般使用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文件夹下的图片。