領域物件表示(物件對映)
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;
}
在預設配置下,Jackson 在嚮導出器 POST 新資料時,不知道要例項化哪個類。您需要透過註解或(更簡潔地)透過使用 Module
註冊型別對映來告知 Jackson。
要將您自己的 Jackson 配置新增到 Spring Data REST 使用的 ObjectMapper
中,請重寫 configureJacksonObjectMapper
方法。該方法會傳入一個 ObjectMapper
例項,其中包含一個用於處理 PersistentEntity
物件序列化和反序列化的特殊模組。您也可以註冊自己的模組,如下例所示
@Override
protected void configureJacksonObjectMapper(ObjectMapper objectMapper) {
objectMapper.registerModule(new SimpleModule("MyCustomModule") {
@Override
public void setupModule(SetupContext context) {
context.addAbstractTypeResolver(
new SimpleAbstractTypeResolver()
.addMapping(MyInterface.class, MyInterfaceImpl.class));
}
});
}
一旦您在 Module
中訪問到 SetupContext
物件,您就可以做各種很酷的事情來配置 Jackson 的 JSON 對映。您可以在 Jackson 的 wiki 上閱讀更多關於 Module
例項如何工作的資訊。
為領域型別新增自定義序列化器
如果您想以特殊方式序列化或反序列化領域型別,您可以在 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);
}