如何用Spring Data JDBC实现同类型嵌套实体（目录层级）映射？

要实现你描述的导航结构映射，需要结合Spring Data JDBC的聚合映射规则，处理嵌套实体与自关联集合的逻辑，具体步骤如下：

1. 调整实体类定义 #

Spring Data JDBC要求聚合内的嵌套实体满足映射规则，需为Directory添加主键、无参构造，并通过注解声明自关联集合的映射关系：

Hierarchy（聚合根） #

public class Hierarchy {

    @Id
    private String id;

    private Directory root;

    // 无参构造、getter/setter
    public Hierarchy() {}

    public String getId() { return id; }
    public void setId(String id) { this.id = id; }
    public Directory getRoot() { return root; }
    public void setRoot(Directory root) { this.root = root; }
}

Directory（嵌套实体） #

public class Directory {

    @Id
    private Long id; // 目录自身主键，用于自关联
    
    private String path;

    // 声明自关联子集合：idColumn指定父目录外键，sortColumn维护有序集合的顺序
    @MappedCollection(idColumn = "parent_id", sortColumn = "position")
    private Set<Directory> children = new LinkedHashSet<>();

    // 必须提供无参构造，供Spring Data JDBC反射实例化
    public Directory() {}

    public Directory(String path) {
        this.path = path;
    }

    // getter/setter
    public Long getId() { return id; }
    public void setId(Long id) { this.id = id; }
    public String getPath() { return path; }
    public void setPath(String path) { this.path = path; }
    public Set<Directory> getChildren() { return children; }
    public void setChildren(Set<Directory> children) { this.children = children; }
}

2. 数据库表结构设计 #

导航结构需要两张表：聚合根表hierarchy，以及存储目录结构的directory表（包含聚合外键、自关联外键和排序字段）：

hierarchy表 #

CREATE TABLE hierarchy (
    id VARCHAR(255) PRIMARY KEY COMMENT '聚合根ID'
);

directory表 #

CREATE TABLE directory (
    id BIGINT AUTO_INCREMENT PRIMARY KEY COMMENT '目录自身ID',
    hierarchy_id VARCHAR(255) NOT NULL COMMENT '所属聚合根ID',
    path VARCHAR(255) NOT NULL COMMENT '目录路径',
    parent_id BIGINT COMMENT '父目录ID，自关联外键',
    position INT NOT NULL COMMENT '子目录排序位置，维护LinkedHashSet顺序',
    FOREIGN KEY (hierarchy_id) REFERENCES hierarchy(id),
    FOREIGN KEY (parent_id) REFERENCES directory(id)
);

3. 定义Repository接口 #

继承Spring Data JDBC的CrudRepository，实现聚合根的CRUD操作：

import org.springframework.data.repository.CrudRepository;

public interface HierarchyRepository extends CrudRepository<Hierarchy, String> {
}

4. 使用示例 #

// 构建导航结构
Hierarchy hierarchy = new Hierarchy();
hierarchy.setId("h1");

Directory root = new Directory("/");
Directory docsDir = new Directory("/docs");
Directory imagesDir = new Directory("/images");
Directory springDir = new Directory("/docs/spring");

root.getChildren().add(docsDir);
root.getChildren().add(imagesDir);
docsDir.getChildren().add(springDir);

hierarchy.setRoot(root);

// 保存聚合
hierarchyRepository.save(hierarchy);

// 查询并验证结构
Hierarchy foundHierarchy = hierarchyRepository.findById("h1").orElseThrow();
assert foundHierarchy.getRoot().getPath().equals("/");
assert foundHierarchy.getRoot().getChildren().size() == 2;

// 验证子目录顺序（与添加顺序一致）
Directory firstChild = foundHierarchy.getRoot().getChildren().iterator().next();
assert firstChild.getPath().equals("/docs");

关键注意事项 #

• 必须为实体提供无参构造函数，Spring Data JDBC依赖反射实例化对象。
• 有序集合LinkedHashSet通过sortColumn字段维护顺序，插入时Spring Data JDBC会自动填充排序值，查询时按该字段排序恢复顺序。
• 整个目录结构属于同一个聚合，directory表的hierarchy_id字段确保所有目录都关联到所属的聚合根，Spring Data JDBC会自动维护该字段的值。
• 聚合内的实体操作遵循ACID边界，保存/更新聚合根时，会自动同步所有嵌套目录的增删改。

内容的提问来源于stack exchange，提问作者user10715946