如何在Spring Data JDBC中实现互斥可选的一对一关系

问题背景 #

现有三张数据库表用于描述玩具、食品、未知类型的物品，当前Java建模中Item类的toyProperties和foodProperties无法被type字段约束，存在类型与属性不匹配的风险，需要实现：

• 未知类型物品无额外属性
• 玩具类仅包含玩具属性
• 食品类仅包含食品属性

一、Java端：用继承实现强类型约束 #

通过抽象基类+子类的方式，让每个类型的物品只持有对应属性，从编译期杜绝属性与类型不匹配的问题。

1. 抽象基类 Item #

import org.springframework.data.relational.core.mapping.DiscriminatorColumn;
import org.springframework.data.relational.core.mapping.Table;

@Table("item")
@DiscriminatorColumn("type") // 指定数据库中区分类型的字段为`type`
public abstract class Item {
    private int id;
    private String name;
    private ItemType type;

    // 构造方法、Getter/Setter
}

2. 类型枚举 ItemType #

public enum ItemType {
    TOY,
    FOOD,
    UNKNOWN
}

3. 子类实现 #

玩具物品类 ToyItem

import org.springframework.data.relational.core.mapping.DiscriminatorValue;

@DiscriminatorValue("TOY") // 对应数据库type字段的`TOY`值
public class ToyItem extends Item {
    private ItemToy toyProperties;

    // 构造方法、Getter/Setter
}

// 玩具属性类
public class ItemToy {
    private String color;
    private String material;

    // Getter/Setter
}

食品物品类 FoodItem

import org.springframework.data.relational.core.mapping.DiscriminatorValue;

@DiscriminatorValue("FOOD") // 对应数据库type字段的`FOOD`值
public class FoodItem extends Item {
    private ItemFood foodProperties;

    // 构造方法、Getter/Setter
}

// 食品属性类
public class ItemFood {
    private String smell;
    private String taste;

    // Getter/Setter
}

未知类型物品类 UnknownItem

import org.springframework.data.relational.core.mapping.DiscriminatorValue;

@DiscriminatorValue("UNKNOWN") // 对应数据库type字段的`UNKNOWN`值
public class UnknownItem extends Item {
    // 无额外属性
}

二、Spring Data JDBC 仓库实现 #

方式1：统一仓库（推荐） #

定义一个基于抽象基类的仓库，Spring Data JDBC会自动根据type字段映射到对应的子类：

import org.springframework.data.repository.CrudRepository;
import java.util.List;

public interface ItemRepository extends CrudRepository<Item, Integer> {
    // 按类型查询对应子类实例
    List<ToyItem> findByType(ItemType type);
    List<FoodItem> findByType(ItemType type);
    List<UnknownItem> findByType(ItemType type);
}

使用时，调用findById会返回对应类型的子类实例，保存时也会自动填充type字段。

方式2：细分仓库（按需选择） #

如果需要对不同类型物品做更细粒度的操作，可以为每个子类单独定义仓库：

public interface ToyItemRepository extends CrudRepository<ToyItem, Integer> {}
public interface FoodItemRepository extends CrudRepository<FoodItem, Integer> {}
public interface UnknownItemRepository extends CrudRepository<UnknownItem, Integer> {}

三、数据库层面的约束增强（可选） #

为了在数据库层面也保证类型与属性的一致性，可以给item_toy和item_food表添加约束：

修改 item_toy 表 #

CREATE TABLE item_toy (
    item INTEGER NOT NULL PRIMARY KEY REFERENCES item(id),
    color VARCHAR(255) NOT NULL,
    material VARCHAR(255) NOT NULL,
    FOREIGN KEY (item) REFERENCES item(id) ON DELETE CASCADE,
    -- 约束关联的item必须为TOY类型
    CHECK ( (SELECT type FROM item WHERE id = item) = 'TOY' )
);

修改 item_food 表 #

CREATE TABLE item_food (
    item INTEGER NOT NULL PRIMARY KEY REFERENCES item(id),
    smell VARCHAR(255) NOT NULL,
    taste VARCHAR(255) NOT NULL,
    FOREIGN KEY (item) REFERENCES item(id) ON DELETE CASCADE,
    -- 约束关联的item必须为FOOD类型
    CHECK ( (SELECT type FROM item WHERE id = item) = 'FOOD' )
);

优势总结 #

• 编译期约束：每个类型的物品只能持有对应属性，彻底避免无关属性存在的混乱
• 面向对象设计：符合单一职责原则，子类专注处理自身类型的逻辑
• 原生支持：Spring Data JDBC对继承映射的支持完善，无需额外复杂配置

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