如何解决 Hibernate 中 \

2024-07-08 21:21:54

如何解决 Hibernate 中 "Could not determine recommended JdbcType for Java type 'java.util.Map<java.lang.String, java.util.List<java.lang.String>>'" 错误

你正在使用 Hibernate 开发，却碰到了 "Could not determine recommended JdbcType for Java type 'java.util.Map<java.lang.String, java.util.List<java.lang.String>>'" 这个错误？别担心，你不是一个人。当你尝试将类似 Map<String, List<ProductDetails>> 这样的复杂 Java 对象映射到数据库表时，就很容易遇到这个问题。Hibernate 难以将嵌套集合类型直接映射到关系型数据库的表结构，因此抛出异常。

本文将深入浅出地解释这个问题的根源，并为你提供两种行之有效的解决方案，帮你轻松解决这个常见的 Hibernate 映射问题。

问题根源解析

关系型数据库就像一个井然有序的仓库，数据以表格的形式存储，每个表格由行和列组成。Hibernate 就像一位勤劳的搬运工，负责将 Java 对象搬运到数据库的表格中。但是，关系型数据库的表格结构并不支持直接存储 Map<String, List<ProductDetails>> 这样的嵌套集合。

想象一下，你试图将一个多层抽屉柜（Map）塞进一个只有格子间（数据库表）的仓库里，每个抽屉（String）还装着不同种类的物品清单（List<ProductDetails>）。Hibernate 这位搬运工自然不知道该如何下手，只能抛出异常求助。

解决方案一：巧用连接表

我们可以利用数据库中现有的结构——连接表，来解决这个问题。

步骤详解

创建连接表：

我们需要在数据库中创建一个新的表格，作为桥梁连接公司信息和产品目录信息。假设新表格命名为 company_product_catalogue ，它需要包含以下几列：
- company_id: 公司表的外键，用于关联公司信息。
- category: 产品类别，例如“电子产品”，“服装”等。
- product_id: 产品表的外键，用于关联具体的产品信息。

修改实体类：

@Entity 
@Table(name = "company")
public class Company {

    // ...其他字段...

    @OneToMany(cascade = CascadeType.ALL, orphanRemoval = true)
    @JoinTable(
        name = "company_product_catalogue",
        joinColumns = @JoinColumn(name = "company_id"),
        inverseJoinColumns = @JoinColumn(name = "product_id")
    )
    private List<ProductDetails> productCatalogue = new ArrayList<>();

    // ...其他方法...
}

@Entity 
@Table(name = "product")
public class ProductDetails {

    // ...其他字段...

    private String category;

    // ...其他方法...
}

我们不再需要 Map<String, List<ProductDetails>> productCatalogue 字段。Company 实体现在直接关联到 ProductDetails 实体，并使用 @JoinTable 注解指定连接表信息。

更新数据库：

根据修改后的实体类，更新数据库结构，创建 company_product_catalogue 表。

方案解读

通过连接表，我们将原本复杂的嵌套集合结构，转化成了关系型数据库更容易理解的表关系。每个公司可以关联多个产品类别，每个产品类别下又可以关联多个具体产品，信息关联清晰明了。

解决方案二：序列化为 JSON 字符串

除了使用连接表，我们还可以借助 JSON 序列化，将 Map<String, List<ProductDetails>> 转化为字符串存储。

步骤详解

添加依赖：

我们需要引入 Jackson 库来帮助我们完成 Java 对象和 JSON 字符串之间的转换。在你的项目中添加以下依赖：

<dependency>
    <groupId>com.fasterxml.jackson.core</groupId>
    <artifactId>jackson-databind</artifactId>
    <version>2.13.3</version>
</dependency>

修改实体类：

@Entity 
@Table(name = "company")
public class Company {

    // ...其他字段...

    @Column(columnDefinition = "TEXT")
    private String productCatalogueJson;

    // ...其他方法...

    // 添加以下辅助方法，用于处理 productCatalogue 的序列化和反序列化
    public Map<String, List<ProductDetails>> getProductCatalogue() {
        if (productCatalogueJson == null) {
            return new HashMap<>();
        }
        try {
            ObjectMapper objectMapper = new ObjectMapper();
            return objectMapper.readValue(productCatalogueJson, new TypeReference<Map<String, List<ProductDetails>>>() {});
        } catch (JsonProcessingException e) {
            throw new RuntimeException("Error deserializing productCatalogue", e);
        }
    }

    public void setProductCatalogue(Map<String, List<ProductDetails>> productCatalogue) {
        try {
            ObjectMapper objectMapper = new ObjectMapper();
            this.productCatalogueJson = objectMapper.writeValueAsString(productCatalogue);
        } catch (JsonProcessingException e) {
            throw new RuntimeException("Error serializing productCatalogue", e);
        }
    }
}

我们将 productCatalogue 字段替换为 productCatalogueJson，用于存储序列化后的 JSON 字符串。同时，我们还添加了 getProductCatalogue 和 setProductCatalogue 两个辅助方法，分别用于将 JSON 字符串反序列化为 Java 对象，以及将 Java 对象序列化为 JSON 字符串。

更新数据库：

修改 company 表中 productCatalogueJson 字段的数据类型为 TEXT 或其他适合存储长字符串的类型。

方案解读

通过 JSON 序列化，我们将复杂的嵌套集合结构转化为字符串存储在数据库中，简单直接。但是，这种方式也存在一些弊端，例如查询效率相对较低，而且难以直接对 JSON 字符串中的数据进行筛选和排序。

总结

本文提供了两种解决 "Could not determine recommended JdbcType for Java type 'java.util.Map<String, List<java.lang.String>>'" 错误的方案：使用连接表和序列化为 JSON 字符串。

使用连接表更符合关系型数据库的设计原则，查询效率较高，但需要创建额外的表和维护表关系。
使用 JSON 序列化更加灵活，操作简单，但查询效率相对较低，且难以直接对 JSON 字符串中的数据进行筛选和排序。

最终选择哪种方案，需要根据项目的具体情况和需求来决定。

常见问题解答

为什么 Hibernate 不能直接映射嵌套集合类型？

关系型数据库的表结构是基于二维表的，无法直接表示嵌套集合这种多层级的数据结构。
使用连接表和 JSON 序列化，哪种方案性能更好？

通常情况下，使用连接表的查询效率更高，因为数据库可以直接利用索引进行优化。而 JSON 序列化需要先将字符串解析成 Java 对象，再进行操作，效率相对较低。
使用 JSON 序列化，如何保证数据的查询效率？

可以考虑使用数据库提供的全文索引功能，或者将部分关键信息提取出来存储在单独的列中，方便查询。
除了连接表和 JSON 序列化，还有其他解决方案吗？

还可以考虑使用 NoSQL 数据库，例如 MongoDB，它可以更灵活地存储和查询复杂数据结构。
如何选择合适的解决方案？

需要根据项目的具体需求、数据量、性能要求等因素综合考虑。如果数据量较大，且对查询效率要求较高，建议使用连接表。如果数据量较小，且对查询效率要求不高，则可以选择 JSON 序列化。