在Java项目中经常能看到fastjson和jackson这两个库同时出现,因为spring mvc默认使用jackson作为restful接口的序列化和反序列化库,在restful接口、feign调用中不可避免在框架层面就引入了jackson;而fastjson则提供了很多JSON操作的静态方法,很适合日常编码拿来就用。
混用两个库大多数时候没什么问题,在少数情况下,如开发过程中序列化异常的时候会出现两种风格的异常信息,让人一下子懵圈,这个问题其实习惯了也还好。
但是如果某些dto需要json注解的时候,就需要同时使用两套注解来作兼容,这个问题会让编码工作更繁琐,使项目不容易维护,这是无法接受的,我们来看一个例子
在微信网页授权登陆的api中使用code换取access_token的返回结果如下
{
"access_token":"ACCESS_TOKEN",
"expires_in":7200,
"refresh_token":"REFRESH_TOKEN",
"openid":"OPENID",
"scope":"SCOPE"
}
这个返回结果中,三个字段使用下划线分割单词,一个字段忽略了大小写,这种命名方式在我们转成dto类的时候就需要指定json属性名以满足我们对Java项目的命名规范。fastjson使用@JSONField实现,而jackson则是使用@ JsonProperty注解来实现,我们可以看到多了一份注解
@Data
class TokenResp {
@JSONField(name = "access_token")
@JsonProperty("access_token")
private String accessToken;
@JSONField(name = "expires_in")
@JsonProperty("expires_in")
private Integer expiresIn;
@JSONField(name = "refresh_token")
@JsonProperty("refresh_token")
private String refreshToken;
@JSONField(name = "openid")
@JsonProperty("openid")
private String openId;
private String scope;
}
因此使用同一个库可以简化这些代码,让项目更好维护。推荐使用jackson来作为全项目json序列化的库,因为spring全家桶方便的进行整合,开箱即用。
从自动配置类MappingJackson2HttpMessageConverterConfiguration的注解 @ConditionalOnBean({ObjectMapper.class})可以看到spring mvc加载的是jackson的ObjectMapper类,因此我们可以在需要使用到json库的地方注入ObjectMapper这个bean,即可使用到跟spring mvc框架一样的jackson配置信息,如:
@Slf4j
@RestController
public class HelloController {
@Autowired
private ObjectMapper objectMapper;
@PostMapping("/hello")
public String hello(@RequestBody HelloReq req) {
log.info("got request data {}", objectMapper.writeValueAsString(req));
return "hello world";
}
}