当前位置：首页 > news >正文

多级@JsonTypeInfo和@JsonSubTypes注解使用详解及场景分析

news 2025/7/14 6:20:18

Hello，大家好，我是灰小猿！

最近在开发的过程中遇到了两个在处理Json解析方面比较有用的注解：@JsonTypeInfo和@JsonSubTypes，所以在这里记录分享一下使用。

@JsonTypeInfo和@JsonSubTypes是Jackson库中用于处理多态类型的注解。

@JsonTypeInfo

@JsonTypeInfo注解用于指定在序列化和反序列化过程中如何处理多态类型。

多态类型指的是在反序列化时，JSON 数据可能对应多个子类型。为了正确读取对象的类型，我们需要在 JSON 数据中添加一些类型信息。

use: 定义使用哪种类型识别码，有以下几种可选值：
- JsonTypeInfo.Id.CLASS: 使用完全限定类名作为识别码。
- JsonTypeInfo.Id.MINIMAL_CLASS: 若基类和子类在同一包内，使用类名（忽略包名）作为识别码。
- JsonTypeInfo.Id.NAME: 使用逻辑名称作为识别码。
- JsonTypeInfo.Id.CUSTOM: 自定义识别码，由 @JsonTypeIdResolver 对应。
- JsonTypeInfo.Id.NONE: 不使用识别码。
include: 指定识别码如何包含在 JSON 数据中，有以下几种可选值：
- JsonTypeInfo.As.PROPERTY: 作为数据的兄弟属性。
- JsonTypeInfo.As.EXISTING_PROPERTY: 作为 POJO 中已经存在的属性。
- JsonTypeInfo.As.EXTERNAL_PROPERTY: 作为扩展属性。
- JsonTypeInfo.As.WRAPPER_OBJECT: 作为一个包装对象。
- JsonTypeInfo.As.WRAPPER_ARRAY: 作为一个包装数组。
property: 指定识别码的属性名称。此属性在 use 为 JsonTypeInfo.Id.CLASS、JsonTypeInfo.Id.MINIMAL_CLASS 或 JsonTypeInfo.Id.NAME 时有效。
defaultImpl: 指定反序列化时使用的默认类型，如果类型识别码不存在或无效。
visible: 指定类型标识符是否在反序列化时保留，默认为 false。

@JsonSubTypes

@JsonSubTypes注解用于指定多态类型的子类型。它可以通过属性value来指定子类型的映射关系。通过name来标识当识别码的属性名称为什么值时对应为这个类型，并且每个子类型都需要使用@JsonSubTypes.Type注解进行标注，并指定子类型的类和名称。

@JsonTypeInfo和@JsonSubTypes是结合使用的，他们可以实现对多态类型的序列化和反序列化。

在序列化时，Jackson库会根据@JsonTypeInfo注解指定的类型信息包含方式和使用机制，将对象的类型信息包含在序列化结果中。

在反序列化时，Jackson库会根据@JsonTypeInfo注解指定的类型信息使用机制，将序列化结果中的类型信息解析出来，并根据@JsonSubTypes注解指定的子类型映射关系，将序列化结果转换为正确的对象类型。

这两个注解的优势在于可以灵活处理多态类型的序列化和反序列化。它可以帮助开发人员在处理多态类型时，准确地恢复对象的类型信息，从而实现正确的对象转换和处理。

多级@JsonTypeInfo和@JsonSubTypes的应用场景包括但不限于以下几个方面：

在分布式系统中，多级@JsonTypeInfo和@JsonSubTypes可以帮助实现跨系统的对象传输和转换。
在消息队列中，多级@JsonTypeInfo和@JsonSubTypes可以帮助实现不同消息类型的序列化和反序列化。
在RESTful API中，多级@JsonTypeInfo和@JsonSubTypes可以帮助实现不同资源类型的序列化和反序列化。
在数据库表设计中，同类对象的不同类型属性采用Json存储时可以使用这两个注解帮助进行对象的序列化和反序列化。

实际的使用案例

在设计数据表时，如果一个对象可以有多重类型，每一种类型之间有公共的属性和自身特有的属性，那么在定义数据表时，我们一般不会定义多张数据表进行存储，也不会将所有的属性都作为列添加到表中，那么这个时候，我们就可以将公共属性作为数据表的列，将特有的属性以Json的形式存储在一个字段中，而在数据模型定义中，这些特有的属性可以定义为继承自同一个父类的不同属性类，

这个时候在进行这个对象的序列化和反序列化的过程中，就需要使用到@JsonTypeInfo和@JsonSubTypes注解。

假如我们有一个商品类Commodity，但是在业务中我的商品除了有统一的名称、价格属性外，不同的商品还有不同的属性表示，比如食品有保质期，家电有能效标识和质量

那么我们创建Commodity的数据表时就可以这样创建：

其中使用commodity_attr_json字段来存储不同类型的商品的属性值的json，commodity_type用来标识不同的商品类型。

CREATE TABLE 'Commodity'{'id' varchar(32) NOT NULL,'name' varchar(32) NOT NULL,'price' int NOT NULL,'commodity_type' int DEFAULT 0,'commodity_attr_json' json NOT NULL COMMENT '不同商品特有属性的JSON'，PRIMARY KEY ('id')
}

在数据模型定义中，model的定义和数据表一致：

@Getter
@Setter
public class CommodityModel {private String id;private String name;private int price;private CommodityTypeEnum commodityType;private String commodityAttrJson;public static CommodityModel newInstance(CommodityDTO dto) {CommodityModel model = new CommodityModel();model.setId(dto.getId());model.setName(dto.getName());model.setPrice(dto.getPrice());model.setCommodityType(dto.getCommodityType());CommodityAttrDTO commodityAttr = dto.getCommodityAttr();ObjectMapper objectMapper = new ObjectMapper();String commodityAttrJson = null;try {commodityAttrJson = objectMapper.writeValueAsString(commodityAttr);} catch (JsonProcessingException e) {throw new RuntimeException(e);}model.setCommodityAttrJson(commodityAttrJson);return model;}
}

DTO的定义中，对象的属性不再使用json表示，而是有了对应的DTO对象

@Getter
@Setter
public class CommodityDTO {private String id;private String name;private int price;private CommodityTypeEnum commodityType;private CommodityAttrDTO commodityAttr;public static CommodityDTO newInstance(CommodityModel model) {CommodityDTO dto = new CommodityDTO();dto.setId(model.getId());dto.setName(model.getName());dto.setPrice(model.getPrice());dto.setCommodityType(model.getCommodityType());ObjectMapper objectMapper = new ObjectMapper();CommodityAttrDTO commodityAttrDTO = null;try {commodityAttrDTO = objectMapper.readValue(model.getCommodityAttrJson(), CommodityAttrDTO.class);} catch (JsonProcessingException e) {throw new RuntimeException(e);}dto.setCommodityAttr(commodityAttrDTO);return dto;}
}

定义统一的对象属性接口

@JsonTypeInfo(use = JsonTypeInfo.Id.NAME,property = "commodityType")
@JsonSubTypes({@JsonSubTypes.Type(value = FoodstuffCommodityAttrDTO.class,name = CommodityTypeEnum.Constant.FOODSTUFF),@JsonSubTypes.Type(value = ElectronicCommodityAttrDTO.class,name = CommodityTypeEnum.Constant.ELECTRONIC)
})
public interface CommodityAttrDTO {}

定义每一个商品类型具体的属性DTO，并继承CommodityAttrDTO

/*** 食品*/
@Getter
@Setter
public class FoodstuffCommodityAttrDTO implements CommodityAttrDTO{/*** 保质期*/private Timestamp expirationDate;
}

/*** 电子商品*/
@Getter
@Setter
public class ElectronicCommodityAttrDTO implements CommodityAttrDTO {/*** 能效等级*/private int energyEfficiencyGrade;/*** 商品重量*/private int weight;
}

通过上面的数据定义，即可方便的将model和DTO之间进行转换。

以上就是@JsonTypeInfo和@JsonSubTypes注解的主要作用和一个实际的使用场景分析。如果大家有好的场景或补充，可以一起聊聊！

我是灰小猿，我们下期见！

查看全文

http://www.dtcms.com/a/277190.html