使用 JPA 和 Spring 注解映射购物车、购物车项和商品实体

本文旨在帮助初学者理解并正确配置 JPA 中购物车(Cart)、购物车项(CartItem)和商品(Item)之间的关系。通过示例代码和详细解释，阐述了如何使用 Spring 注解建立一对多、多对一和一对一的关系，避免常见的配置错误，并确保数据持久化的正确性。重点关注 @OneToMany, @ManyToOne, @OneToOne 以及 @JoinColumn 的使用，从而实现实体间的关联映射。

实体关系分析

在购物车应用中，购物车(Cart)、购物车项(CartItem)和商品(Item)之间存在以下关系：

• 一个购物车(Cart)可以包含多个购物车项(CartItem) (一对多)。
• 一个购物车项(CartItem)属于一个购物车(Cart) (多对一)。
• 一个购物车项(CartItem)对应一个商品(Item) (一对一)。
• 一个商品(Item)可以出现在多个购物车项(CartItem) (多对多，但通常通过购物车项来间接关联)。

JPA 实体配置

以下展示了如何使用 JPA 和 Spring 注解正确配置这些实体类，并解释了关键注解的作用。

迷你天猫商城

迷你天猫商城是一个基于Spring Boot的综合性B2C电商平台，需求设计主要参考天猫商城的购物流程：用户从注册开始，到完成登录，浏览商品，加入购物车，进行下单，确认收货，评价等一系列操作。 作为迷你天猫商城的核心组成部分之一，天猫数据管理后台包含商品管理，订单管理，类别管理，用户管理和交易额统计等模块，实现了对整个商城的一站式管理和维护。所有页面均兼容IE10及以上现代浏览器。部署方式1、项目

下载

1. 购物车实体 (Cart)

@Entity
@Table(name="my_cart")
public class Cart {

    @Id
    @GeneratedValue(strategy = GenerationType.IDENTITY)
    @Column(name="cart_id")
    private Long cartId;

    @OneToMany(mappedBy = "cart", cascade = CascadeType.ALL, orphanRemoval = true)
    private List cartItems;

    @Column(name="cart_total_number_of_items")
    private long totalNumberOfItems;

    @Column(name="cart_total_price")
    private double totalPrice;

    // + getters and setters and constructor
}

• @Entity: 标记该类为 JPA 实体。
• @Table(name="my_cart"): 指定实体对应的数据库表名为 "my_cart"。
• @Id: 标记 cartId 字段为主键。
• @GeneratedValue(strategy = GenerationType.IDENTITY): 指定主键的生成策略为自增长。
• @Column(name="cart_id"): 指定 cartId 字段对应的数据库列名为 "cart_id"。
• @OneToMany(mappedBy = "cart", cascade = CascadeType.ALL, orphanRemoval = true): 定义购物车(Cart)和购物车项(CartItem)之间的一对多关系。
  • mappedBy = "cart": 指定由 CartItem 实体中的 cart 属性维护关系。
  • cascade = CascadeType.ALL: 配置级联操作，当购物车被删除时，相关的购物车项也会被删除。
  • orphanRemoval = true: 配置孤儿删除，当购物车项不再属于任何购物车时，该购物车项会被删除。

2. 购物车项实体 (CartItem)

@Entity
@Table(name="cart_items")
public class CartItem {

    @Id
    @GeneratedValue(strategy = GenerationType.IDENTITY)
    @Column(name="cartitem_id")
    private Long cartItemId;

    @Column(name="cart_item_name")
    private String productName;

    @Column(name="cart_item_description")
    private String itemDescription;

    @Column(name="cart_item_quantity")
    private int itemQuantity;

    @Column(name="cart_item_price")
    private double itemPrice;

    @ManyToOne
    @JoinColumn(name = "cart_id")
    private Cart cart;

    @OneToOne
    @JoinColumn(name = "item_id")
    private Item item;

    // + getters and setters and constructor
}

• @ManyToOne: 定义购物车项(CartItem)和购物车(Cart)之间的多对一关系。
• @JoinColumn(name = "cart_id"): 指定外键列名为 "cart_id"，该列引用 my_cart 表的主键。
• @OneToOne: 定义购物车项(CartItem)和商品(Item)之间的一对一关系。
• @JoinColumn(name = "item_id"): 指定外键列名为 "item_id"，该列引用 my_items 表的主键。

3. 商品实体 (Item)

@Entity
@Table(name="my_items")
public class Item {

    @Id
    @Column(name="item_id")
    private Long itemId;

    @Column(name="item_name", nullable = false)
    private String name;

    @Column(name="item_description", nullable = false)
    private String description;

    @Column(name="item_price", nullable = false)
    private Double price;

    // + getters and setters and constructor
}

关键点总结

1. @JoinColumn 的使用: @JoinColumn 用于指定外键列的名称。在 @OneToMany 关系中，通常在“多”的一方（例如 CartItem）使用 @JoinColumn，而在 @OneToOne 和 @ManyToOne 关系中，也需要在拥有外键的实体中使用 @JoinColumn。
2. mappedBy 的使用: 在 @OneToMany 关系中，mappedBy 属性用于指定由哪个实体来维护关系。避免双向关系时重复维护关系。
3. 级联操作 (CascadeType): 合理配置级联操作，可以简化代码，例如在删除购物车时自动删除相关的购物车项。常用的级联类型包括 ALL, PERSIST, MERGE, REMOVE 等。
4. 孤儿删除 (orphanRemoval): orphanRemoval = true 用于删除不再与父实体关联的子实体。

注意事项

• 确保实体类中的字段类型与数据库表中的列类型一致。
• 仔细检查实体关系配置，避免循环依赖和错误的关联。
• 使用适当的事务管理，确保数据的一致性。
• 在实际应用中，可能需要根据业务需求调整实体关系和级联策略。

通过上述配置，可以正确地映射购物车、购物车项和商品实体之间的关系，并使用 JPA 进行数据持久化操作。 仔细理解每个注解的含义，能够帮助你更好地掌握 JPA 的使用。