在Java项目中使用同一个json库

在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";
    }
}