jackson JsonPropertyOrder和@JsonIgnoreProperties注解
Posted 太白的技术博客
tags:
篇首语:本文由小常识网(cha138.com)小编为大家整理,主要介绍了jackson JsonPropertyOrder和@JsonIgnoreProperties注解相关的知识,希望对你有一定的参考价值。
有些时候,我们在和外部系统交互的时候使用了json作为标准的数据交换格式,同时为了安全性考虑,增加了对报文的校验,因此我们需要确保序列化的时候参数有序且不多不少刚好,因为对外的API不像后台和前端交互一样,兼容即可,而是对严谨性的要求极高。jackson默认的机制是序列化的时候,先父类的属性,然后再是子类的属性按照定义的顺序进行(fastjson则刚好相反,先序列化子类,然后序列化父类)。为了使用json的工具类,且达到有序的目的,之前特地研究了fastjson/jackson两者的序列化特性,fastjson/jackson都有设置序列化顺序的参数,也就是jackson @JsonProperty注解的index以及fastjson @JSONField注解的ordinal。实际设置了测试下来,感觉两者都不生效或者有bug,总之行为比较怪异。之前记得jackson有个类级别的@JsonInclude注解可以设置要序列化的所有属性,于是特地测试了,符合预期的要求,不过记错了是JsonIgnoreProperties。结合继承[email protected]注解,我们甚至可以完美的达到对于一个相同的属性比如状态,有些view要称为orderStatus,另外一些称为shippingStatus的目标,同时确保在service/mapper层,完全是场景无关的。jacksonJsonIgnoreProperties/JsonPropertyOrder在序列化和反序列化时仅读取当前类的注解,忽略父类的注解,这样我们就可以做到行为的100%精确控制,同时尽可能的复用了父类的定义。
如下:
package tf56.lf.lfoms.model.pub; import java.io.Serializable; import java.util.List; import javax.validation.constraints.NotNull; import com.fasterxml.jackson.annotation.JsonFormat; import com.fasterxml.jackson.annotation.JsonIgnoreProperties; import com.fasterxml.jackson.annotation.JsonInclude; import com.fasterxml.jackson.annotation.JsonPropertyOrder; import lombok.Getter; import lombok.Setter; import tf56.lf.base.metadata.validate.ValidServices; import tf56.lf.common.util.JacksonHelper; import tf56.lf.lfoms.validate.group.Group; /** * @author admin * */ @Getter @Setter @Deprecated @JsonPropertyOrder({"fromOutPartyType","receiverMobile","sessionBean"}) @JsonIgnoreProperties({"businessPartId","omsPaymentCollectionList","requestOrderNo"}) public class TmsCreateRequestOrderIQReqDTO extends TmsCreateRequestOrderMainReqDTO implements Serializable{ private static final long serialVersionUID = 8617922710046163090L; //费用list @ValidServices(services = Group.RQUERSTORDER_CREATE ) @NotNull @JsonFormat private List<CreateOmsPaymentCollectionReq> omsPaymentCollectionList; //货物列表 @ValidServices(services = Group.RQUERSTORDER_CREATE ) @NotNull private List<CreateGoodsDOReq> goodsList; public static void main(String[] args) { TmsCreateRequestOrderIQReqDTO dto = new TmsCreateRequestOrderIQReqDTO(); System.out.println(JacksonHelper.toJSON(dto)); } }
在TmsCreateRequestOrderMainReqDTO类上设置了:
@JsonPropertyOrder({"sessionBean","fromOutPartyType","receiverMobile"})
@JsonIgnoreProperties({"senderMobile"})
输出如下:
{"fromOutPartyType":null,"receiverMobile":null,"sessionBean":null,"tfSign":null,"senderPartyId":null,"senderName":null,"senderMobile":null,"fromDistrict":null,"fromAddress":null,"senderOrganization":null,"toOutPartyType":null,"receiverPartyId":null,"receiverPartyName":null,"toDistrict":null,"toAddress":null,"receiverOrganization":null,"carriersPartyId":null,"carriersCompany":null,"clientNumber":null,"transportMethod":null,"deliveryMethod":null,"isNeedReceipt":null,"receiptMethod":null,"receiptNum":null,"orderSource":null,"terminal":null,"memo":null,"goodsList":null}
不过总的来说,Jackson应该提供JsonProperties注解,毕竟仅提供ignore,不提供正向的总会有些时候无法直接满足一样,就像黑白名单一样的道理。
不过这只是解决了单项的序列化问题,反序列化的时候,同样需要解决。如果暴露的接口直接通过json requestbody映射进来,就只能定义一个一一对应的接口代理类来映射了。
以上是关于jackson JsonPropertyOrder和@JsonIgnoreProperties注解的主要内容,如果未能解决你的问题,请参考以下文章