Spring Boot JPA Entity Jackson序列化觸發懶加載的解決方案

Spring Jpa這項技術在Spring 開發中常常用到。

今天在作項目用到了Entity的關聯懶加載，可是在返回Json的時候，無論關聯數據有沒有被加載，都會觸發數據序列化，而若是關聯關係沒有被加載，此時是一個 HibernateProxy，並非真實的數據，而致使了報錯。

例如這個Topic Entity:

@Entity
@Table(name = "yms_topics")
@Getter
@Setter
@NoArgsConstructor
@EntityListeners(AuditingEntityListener.class)
@JsonInclude(JsonInclude.Include.NON_EMPTY)
@NamedEntityGraphs({
        @NamedEntityGraph(name = "topic.all",
                attributeNodes = {
                        @NamedAttributeNode(value = "author"),
                        @NamedAttributeNode(value = "category")
                })
})
public class Topic implements Serializable {

    @Id
    @GeneratedValue(strategy = GenerationType.IDENTITY)
    private Long id;

    @ManyToOne(targetEntity = User.class, cascade = CascadeType.ALL, fetch = FetchType.LAZY)
    @JoinColumn(name = "user_id")
    private User author;

    @ManyToOne(targetEntity = TopicCategory.class, cascade = CascadeType.ALL, fetch = FetchType.LAZY)
    @JoinColumn(name = "category_id")
    private TopicCategory category;

    @Column(nullable = false, length = 200)
    private String title;

    @Lob
    @Column(nullable = false, length = 50000)
    private String content;

    @CreatedDate
    private Date createdAt;

    @LastModifiedDate
    private Date updatedAt;
}

author 和 category 都是多對一的關聯，也就是做者和分類，定義的是懶加載LAZY，如今須要分頁取出記錄，Repository 以下：

@EntityGraph(value = "topic.all")
Page<Topic> findAll(Pageable pageable);

這是關聯讀取author和category數據，沒有任何問題。可是若是有的關聯不須要加載，將EntityGraph去掉，就會報錯。

Page<Topic> findAll(Pageable pageable);

究其緣由就是HibernateProxy 沒有辦法被序列化，網上有不少的方法，例如JsonIgnoreProperties，這是治標不治本的方法

如今要達到的目標是當有關聯數據的時候序列化，不存在的時候不返回，或者直接返回Null。

其實要解決這個問題很簡單，那就是使用 Jackson 的一個包 jackson-datatype-hibernate5。
首先gradle添加依賴：

compile group: 'com.fasterxml.jackson.datatype', name: 'jackson-datatype-hibernate5', version: '2.9.8'

這個版本要注意jackson-datatype-hibernateX，根據Hibernate的版原本定

而後咱們要重寫 SpringMvc的 MappingJackson2HttpMessageConverter，將Hibernate5Module這個Module 註冊到ObjectMapper。

咱們新建一個WebMvcConfig類，以下：

@Configuration
public class WebMvcConfig {

    @Bean
    public MappingJackson2HttpMessageConverter mappingJackson2HttpMessageConverter() {
        MappingJackson2HttpMessageConverter converter = new MappingJackson2HttpMessageConverter();
        ObjectMapper mapper = converter.getObjectMapper();
        Hibernate5Module hibernate5Module = new Hibernate5Module();
        mapper.registerModule(hibernate5Module);
        mapper.setDateFormat(new SimpleDateFormat("yyyy-MM-dd HH:mm:ss"));
        return converter;
    }
}

這是一個Config類,很簡單

• 就是注入一個Bean，類型爲MappingJackson2HttpMessageConverter，獲取到ObjectMapper
• 經過mapper.registerModule(hibernate5Module);註冊Module
• 還能夠定義時間如期的序列化格式。
• 注意若是要讓未加載的時候徹底不輸出，那麼在Entity的類級別註解要使用Empty，例如：@JsonInclude(JsonInclude.Include.NON_EMPTY)，否則當數據爲null的時候會輸出null。

到這裏咱們就能夠達到預期的目的了。

這裏可能會致使spring.jackson的配置失效，之後再行研究。