行业资讯
Spring Boot集成fastjson2：高性能JSON处理实践
1. 为什么选择fastjson2作为Spring Boot的JSON处理器在Java生态中JSON处理库的选择一直是个值得讨论的话题。fastjson2作为阿里巴巴开源的JSON处理库相比其他同类产品有几个显著优势首先是性能表现。根据官方基准测试fastjson2在序列化和反序列化的速度上比Jackson和Gson快2-3倍。这对于高并发的Web应用来说意味着更低的延迟和更高的吞吐量。特别是在处理大型JSON数据时这种性能优势会更加明显。其次是功能丰富度。fastjson2支持JSONB二进制格式这在需要网络传输或持久化存储的场景下能显著减少数据体积。它还内置了JSONPath支持可以直接在JSON结构中进行查询和操作这在处理复杂JSON时非常实用。提示虽然fastjson2性能优异但在某些特殊场景下如需要严格遵循JSON规范时Jackson可能是更安全的选择。根据项目需求权衡选择很重要。2. 项目环境搭建与依赖配置2.1 创建Spring Boot项目建议使用Spring Initializrstart.spring.io创建一个基础的Spring Boot Web项目。选择以下依赖Spring WebLombok可选用于简化代码然后手动添加fastjson2的依赖。在pom.xml中添加dependency groupIdcom.alibaba.fastjson2/groupId artifactIdfastjson2/artifactId version2.0.40/version /dependency dependency groupIdcom.alibaba.fastjson2/groupId artifactIdfastjson2-extension-spring5/artifactId version2.0.40/version /dependency2.2 配置fastjson2作为默认消息转换器Spring Boot默认使用Jackson处理JSON我们需要替换为fastjson2。创建一个配置类Configuration public class WebMvcConfig implements WebMvcConfigurer { Override public void configureMessageConverters(ListHttpMessageConverter? converters) { FastJsonHttpMessageConverter converter new FastJsonHttpMessageConverter(); FastJsonConfig config new FastJsonConfig(); config.setDateFormat(yyyy-MM-dd HH:mm:ss); config.setReaderFeatures( JSONReader.Feature.FieldBased, JSONReader.Feature.SupportArrayToBean ); config.setWriterFeatures( JSONWriter.Feature.WriteMapNullValue, JSONWriter.Feature.PrettyFormat ); converter.setFastJsonConfig(config); converter.setDefaultCharset(StandardCharsets.UTF_8); converter.setSupportedMediaTypes(Collections.singletonList(MediaType.APPLICATION_JSON)); converters.add(0, converter); } }这个配置做了几件事创建FastJsonHttpMessageConverter实例配置日期格式设置读取和写入特性指定字符集和媒体类型将转换器添加到转换器列表的首位3. 基础使用示例3.1 简单的REST接口创建一个简单的控制器来测试fastjson2的集成RestController RequestMapping(/api) public class DemoController { GetMapping(/user) public User getUser() { return new User(1L, 张三, 25, new Date()); } PostMapping(/user) public User createUser(RequestBody User user) { // 模拟保存操作 user.setId(100L); return user; } }User类定义Data NoArgsConstructor AllArgsConstructor public class User { private Long id; private String name; private Integer age; private Date createTime; }测试这个接口你会看到返回的JSON格式美观因为配置了PrettyFormat特性日期格式也符合我们的配置。3.2 集合和复杂对象处理fastjson2处理集合和复杂对象同样简单GetMapping(/users) public ListUser getUsers() { ListUser users new ArrayList(); users.add(new User(1L, 张三, 25, new Date())); users.add(new User(2L, 李四, 30, new Date())); return users; } GetMapping(/complex) public MapString, Object getComplexData() { MapString, Object data new HashMap(); data.put(success, true); data.put(code, 200); data.put(data, getUsers()); data.put(timestamp, System.currentTimeMillis()); return data; }4. 高级特性与配置4.1 自定义序列化和反序列化有时我们需要对特定字段进行特殊处理。fastjson2提供了几种方式使用JSONField注解Data public class Product { private Long id; JSONField(name product_name) private String name; JSONField(format #.00) private BigDecimal price; JSONField(serialize false) private String internalCode; }实现ObjectSerializer和ObjectDeserializer接口public class CustomDateSerializer implements ObjectSerializer { Override public void write(JSONSerializer serializer, Object object, Object fieldName, Type fieldType, long features) { Date date (Date) object; SimpleDateFormat format new SimpleDateFormat(yyyy/MM/dd); String text format.format(date); serializer.write(text); } } // 注册自定义序列化器 FastJsonConfig config new FastJsonConfig(); config.getSerializeConfig().put(Date.class, new CustomDateSerializer());4.2 JSONPath的使用fastjson2内置了JSONPath支持可以直接在JSON结构中进行查询String json {\store\:{\book\:[{\category\:\reference\,\author\:\Nigel Rees\,\title\:\Sayings of the Century\,\price\:8.95},{\category\:\fiction\,\author\:\Evelyn Waugh\,\title\:\Sword of Honour\,\price\:12.99}],\bicycle\:{\color\:\red\,\price\:19.95}}}; // 获取所有书的作者 JSONPath.eval(json, $.store.book[*].author); // 获取价格大于10的书 JSONPath.eval(json, $.store.book[?(.price 10)]); // 修改自行车颜色 JSONPath.set(json, $.store.bicycle.color, blue);5. 常见问题与解决方案5.1 日期处理问题fastjson2处理日期时可能会遇到几个常见问题日期格式不一致建议在实体类中使用JSONField统一指定格式JSONField(format yyyy-MM-dd HH:mm:ss) private Date createTime;时区问题可以在配置中设置时区FastJsonConfig config new FastJsonConfig(); config.setDateFormat(yyyy-MM-dd HH:mm:ss); config.setWriterFeatures(JSONWriter.Feature.UseISO8601DateFormat);5.2 BigDecimal精度问题如示例中提到的BigDecimal在序列化时可能会丢失精度。解决方案// 单个序列化使用WriteBigDecimalAsPlain特性 String json JSON.toJSONString(obj, JSONWriter.Feature.WriteBigDecimalAsPlain); // 全局配置 FastJsonConfig config new FastJsonConfig(); config.setWriterFeatures(JSONWriter.Feature.WriteBigDecimalAsPlain);5.3 循环引用问题当对象存在循环引用时fastjson2默认会检测并抛出异常。可以通过配置来处理// 忽略循环引用 config.setWriterFeatures(JSONWriter.Feature.DisableCircularReferenceDetect); // 或者使用引用标识 config.setWriterFeatures(JSONWriter.Feature.ReferenceDetection);6. 性能优化建议重用JSON实例JSON和JSONB实例是线程安全的可以重用// 在类中定义静态实例 private static final JSONWriter.Context writerContext new JSONWriter.Context( JSONFactory.getDefaultObjectWriterProvider(), JSONWriter.Feature.PrettyFormat ); // 使用时 String json JSON.toJSONString(obj, writerContext);选择合适的特性根据场景启用或禁用特性会影响性能// 对于只读场景可以禁用一些特性提高性能 config.setReaderFeatures( JSONReader.Feature.FieldBased, JSONReader.Feature.UseNativeObject );考虑使用JSONB对于需要频繁传输或存储的场景JSONB能减少体积// 序列化为JSONB byte[] jsonbBytes JSONB.toBytes(obj); // 从JSONB反序列化 MyObject obj JSONB.parseObject(jsonbBytes, MyObject.class);7. 实际项目中的集成经验在实际项目中集成fastjson2时我总结了以下几点经验统一配置建议创建一个统一的配置类管理所有fastjson2相关配置而不是分散在各处。版本管理fastjson2仍在积极开发中建议在pom.xml中通过属性管理版本号properties fastjson2.version2.0.40/fastjson2.version /properties dependency groupIdcom.alibaba.fastjson2/groupId artifactIdfastjson2/artifactId version${fastjson2.version}/version /dependency与Swagger集成如果项目使用Swagger生成API文档需要额外配置Bean public HttpMessageConverters fastJsonHttpMessageConverters() { FastJsonHttpMessageConverter converter new FastJsonHttpMessageConverter(); // ... 配置converter return new HttpMessageConverters(converter); }监控与日志可以注册ParserConfig的globalInstance来监控反序列化过程ParserConfig.getGlobalInstance().addObserver(new ParserConfig.Observer() { Override public void onObserve(Type type, Object fieldName, Object fieldValue) { // 记录反序列化过程 } });测试覆盖特别要测试边界情况如大数字、特殊字符、空值等。
郑州网站建设
网页设计
企业官网
