Fastjson实战:3个高频业务场景深度解析
每次看到同事在手动拼接JSON字符串,或者用反射处理复杂嵌套结构时,我都忍不住想分享Fastjson这个利器。作为阿里巴巴开源的JSON处理库,Fastjson在性能上一直保持着领先优势,特别是在1.2.62版本中,其稳定性和功能完整性都有了显著提升。但很多开发者仅仅停留在基础API调用层面,没有真正发挥它的威力。
1. 复杂表单数据处理:Vue与Java的完美对接
上周排查一个生产问题时,发现前端提交的嵌套表单数据在后端变成了乱码。这让我意识到,很多团队在前后端数据交互上还存在不少误区。
现代前端框架如Vue配合Axios提交数据时,经常会遇到这样的结构:
{ "order": { "items": [ { "sku": "A001", "quantity": 2, "specs": {"color": "red", "size": "XL"} } ], "user": { "deliveryAddress": { "city": "杭州", "details": "余杭区..." } } } }传统做法可能是逐层解析,但用Fastjson可以一步到位:
// 定义DTO结构 public class OrderDTO { private List<OrderItem> items; private UserInfo user; // getters/setters } public class OrderItem { private String sku; private Integer quantity; private Map<String, String> specs; // getters/setters } // 直接转换 String jsonStr = request.getParameter("formData"); OrderDTO order = JSON.parseObject(jsonStr, OrderDTO.class);几个实用技巧:
- 对于不确定的字段,可以用
JSONObject接收,再通过getJSONObject()方法逐层获取 - 日期格式化问题可以在全局配置:
JSON.DEFFAULT_DATE_FORMAT = "yyyy-MM-dd HH:mm:ss"; - 遇到特殊字符时,使用
Feature.OrderedField保持字段顺序
注意:1.2.62版本对泛型支持有优化,处理
List<Item>这类结构时更稳定
2. Redis缓存交互:对象序列化的正确姿势
我们项目曾因为序列化问题导致缓存命中率骤降,后来通过统一Fastjson方案解决了问题。相比Java原生序列化,JSON格式有三大优势:
- 可读性强,便于调试
- 跨语言兼容
- 存储空间更小
典型的使用模式:
// 存储对象 User user = getUserFromDB(); String jsonUser = JSON.toJSONString(user); redisTemplate.opsForValue().set("user:"+userId, jsonUser); // 读取对象 String cachedJson = redisTemplate.opsForValue().get("user:"+userId); User cachedUser = JSON.parseObject(cachedJson, User.class);性能优化点:
- 开启
SerializerFeature.WriteClassName可以在反序列化时保留类型信息 - 对于大对象,使用
JSON.toJSONBytes()比转字符串更节省内存 - 1.2.62版本新增的
Feature.SupportAutoType可以自动识别类型
对比测试数据(10000次操作):
| 序列化方式 | 耗时(ms) | 内存占用(KB) |
|---|---|---|
| Java原生 | 450 | 1200 |
| Fastjson | 210 | 680 |
| Jackson | 280 | 710 |
3. Spring Boot统一响应体设计
在RESTful API设计中,统一的响应格式至关重要。我们团队经过多次迭代,总结出这样的结构:
public class ApiResponse<T> { private Integer code; private String message; private T data; private Long timestamp; // 成功响应快捷方法 public static <T> ApiResponse<T> success(T data) { return new ApiResponse<T>() .setCode(200) .setMessage("success") .setData(data) .setTimestamp(System.currentTimeMillis()); } // getters/setters }Fastjson在此场景下的妙用:
@RestControllerAdvice public class ResponseWrapper implements ResponseBodyAdvice<Object> { @Override public Object beforeBodyWrite(Object body, MethodParameter param, MediaType type, Class<? extends HttpMessageConverter<?>> converter, ServerHttpRequest request, ServerHttpResponse response) { if (body instanceof ApiResponse) { return body; } // 处理String类型特殊处理 if (body instanceof String) { return JSON.toJSONString(ApiResponse.success(body)); } return ApiResponse.success(body); } }遇到的坑与解决方案:
- 日期格式全局配置不生效?试试在
WebMvcConfigurer中添加:@Override public void configureMessageConverters(List<HttpMessageConverter<?>> converters) { FastJsonHttpMessageConverter converter = new FastJsonHttpMessageConverter(); FastJsonConfig config = new FastJsonConfig(); config.setDateFormat("yyyy-MM-dd HH:mm:ss"); converter.setFastJsonConfig(config); converters.add(0, converter); } - 循环引用问题使用
@JSONField(serialize = false)忽略特定字段 - 1.2.62版本对Spring Boot 2.3+的兼容性更好
4. 高级特性与版本升级指南
在深度使用Fastjson的过程中,我发现这些特性特别实用:
自定义序列化:
public class MoneySerializer implements ObjectSerializer { @Override public void write(JSONSerializer serializer, Object object, Object fieldName, Type fieldType, int features) throws IOException { BigDecimal value = (BigDecimal) object; String text = value.setScale(2, RoundingMode.HALF_UP) + "元"; serializer.write(text); } } // 注册自定义序列化器 SerializeConfig.getGlobalInstance().put(BigDecimal.class, new MoneySerializer());安全防护措施:
// 开启安全模式防止注入攻击 ParserConfig.getGlobalInstance().setSafeMode(true); // 设置白名单 ParserConfig.getGlobalInstance().addAccept("com.yourpackage.");版本迁移注意事项:
- 1.2.62修复了多个安全漏洞,建议所有低于此版本的立即升级
- 新版本对
@JSONField注解的支持更完善,可以配置:@JSONField(name = "user_name", ordinal = 1, format = "yyyy-MM-dd") private String username; - 序列化过滤器功能增强:
SimplePropertyPreFilter filter = new SimplePropertyPreFilter(); filter.getExcludes().add("password"); String json = JSON.toJSONString(user, filter);
在微服务架构下,我们还用Fastjson实现了这样的协议转换中间件:
public class ProtocolConverter { public static <T> T convert(Object source, Class<T> targetClass) { String json = JSON.toJSONString(source); return JSON.parseObject(json, targetClass); } // 支持泛型转换 public static <T> List<T> convertList(List<?> source, Class<T> elementClass) { String json = JSON.toJSONString(source); return JSON.parseArray(json, elementClass); } }实际项目中,我们团队建立了这样的规范:
- 所有DTO类必须实现
Serializable - 敏感字段必须加
@JSONField(serialize = false) - 跨服务调用使用
JSON.toJSONBytes()提高传输效率 - 日志输出对象时使用
JSON.toJSONString(obj, SerializerFeature.PrettyFormat)