领域对象表示(对象映射)
Spring Data REST 返回与 HTTP 请求中指定的 Accept 类型相对应的领域对象表示。
目前仅支持 JSON 表示。将来可通过添加合适的转换器并用相应的 content-type 更新控制器方法,来支持其他表示类型。
有时,Spring Data REST 的 ObjectMapper(它经过特殊配置,使用智能序列化器,可将领域对象转换为链接,也可反向转换)的行为可能无法正确处理您的领域模型。数据的组织方式千变万化,您可能会发现自己的领域模型未能正确地转换为 JSON。在这些情况下,试图以通用方式支持复杂的领域模型有时并不现实。有时,根据复杂程度,甚至无法提供通用的解决方案。
向 Jackson 的 ObjectMapper 添加自定义序列化器与反序列化器
为了覆盖绝大多数用例,Spring Data REST 会竭尽全力正确渲染您的对象图。它会尝试将非受管 Bean 作为普通 POJO 序列化,并在必要时为受管 Bean 创建链接。然而,如果您的领域模型不易于读写纯 JSON,您可能希望用自己的自定义映射、序列化器和反序列化器来配置 Jackson 的 ObjectMapper。
抽象类注册
当您在领域模型中使用抽象类(或接口)时,可能需要接入一个关键的配置点。默认情况下,Jackson 不知道该为接口创建哪个实现。请看以下示例:
@Entity
public class MyEntity {
@OneToMany
private List<MyInterface> interfaces;
}
在默认配置下,当向导出器 POST 新数据时,Jackson 不知道该实例化哪个类。您需要通过注解告知 Jackson,或者(更干净的做法)通过使用 Module 注册类型映射来告知。
要将您自己的 Jackson 配置添加到 Spring Data REST 所使用的 ObjectMapper,请重写 configureJacksonObjectMapper 方法。该方法会传入一个 MapperBuilder 实例,它带有一个用于处理 PersistentEntity 对象序列化与反序列化的特殊模块。您也可以注册自己的模块,如下例所示:
@Override
public void configureJacksonObjectMapper(MapperBuilder<? extends ObjectMapper, ? extends MapperBuilder<?, ?>> mapperBuilder) {
mapperBuilder.addModule(new SimpleModule("MyCustomModule") {
@Override
public void setupModule(SetupContext context) {
context.addAbstractTypeResolver(
new SimpleAbstractTypeResolver()
.addMapping(MyInterface.class, MyInterfaceImpl.class));
}
});
}
一旦在 Module 中获得对 SetupContext 对象的访问,您就可以做各种事情来配置 Jackson 的 JSON 映射。有关 Module 实例如何工作的更多信息,请参阅 Jackson 的 wiki。
为领域类型添加自定义序列化器
如果您想以特殊方式序列化或反序列化某个领域类型,可以在 Jackson 的 ObjectMapper 中注册自己的实现,Spring Data REST 导出器会透明地正确处理这些领域对象。要从 setupModule 方法实现中添加序列化器,您可以如下操作:
@Override
public void setupModule(SetupContext context) {
SimpleSerializers serializers = new SimpleSerializers();
SimpleDeserializers deserializers = new SimpleDeserializers();
serializers.addSerializer(MyEntity.class, new MyEntitySerializer());
deserializers.addDeserializer(MyEntity.class, new MyEntityDeserializer());
context.addSerializers(serializers);
context.addDeserializers(deserializers);
}