
1. 理解JPA关联映射
关系型数据库通过外键(foreign key)来连接不同的表,从而表示实体之间的关系。jpa(java persistence api)提供了一套注解,允许开发者在java实体类中以面向对象的方式映射这些数据库关系。常见的关联映射类型包括:
- @OneToOne:一对一关系
- @OneToMany:一对多关系
- @ManyToOne:多对一关系
- @ManyToMany:多对多关系
对于“一门课程有多个学生,一个学生可以选修多门课程”的场景,典型的模型是多对多关系。关系型数据库通常通过一个中间表(也称为连接表或关联表)来处理多对多关系,该中间表包含两个实体表的主键作为联合主键或复合外键。
2. 多对多关系 (@ManyToMany) 的实现
为了在JPA中实现课程与学生的多对多关系,我们需要创建两个实体类:CourseEntity 和 StudentEntity,并在它们之间建立双向关联。
2.1 StudentEntity 类
首先定义学生实体。一个学生可以选修多门课程,因此StudentEntity中需要一个集合来存储其选修的课程。
import javax.persistence.Column;
import javax.persistence.Entity;
import javax.persistence.GeneratedValue;
import javax.persistence.GenerationType;
import javax.persistence.Id;
import javax.persistence.ManyToMany;
import javax.persistence.Table;
import lombok.Data;
import lombok.EqualsAndHashCode;
import lombok.ToString;
import java.util.HashSet;
import java.util.Set;
@Entity
@Table(name = "students")
@Data
@EqualsAndHashCode(exclude = "courses") // 避免循环引用导致StackOverflowError
@ToString(exclude = "courses") // 避免循环引用导致StackOverflowError
public class StudentEntity {
@Id
@GeneratedValue(strategy = GenerationType.IDENTITY)
private Long id;
@Column(name = "student_name", nullable = false)
private String studentName;
// mappedBy 指向 CourseEntity 中拥有关系的字段
// 这里表示 StudentEntity 是关系的非拥有方
@ManyToMany(mappedBy = "students")
private Set courses = new HashSet<>(); // 使用Set避免重复,并提高性能
} 注解解释:
- @Entity 和 @Table: 声明这是一个JPA实体,并映射到名为students的数据库表。
- @Id 和 @GeneratedValue: 定义主键及其生成策略。
- @Column: 定义普通列。
- @ManyToMany(mappedBy = "students"): 声明与CourseEntity的多对多关系。mappedBy = "students"表示StudentEntity是关系的非拥有方(Inverse Side),关系的映射由CourseEntity中的students字段负责。这意味着连接表(join table)的定义和管理将由CourseEntity负责。
- Set
courses = new HashSet(): 使用Set而不是List通常是更好的选择,因为它可以自动处理重复项,并且在某些操作(如查找、删除)上性能更优。 - @EqualsAndHashCode(exclude = "courses") 和 @ToString(exclude = "courses"): 这是一个重要的最佳实践。在双向关联中,hashCode()和toString()方法可能会因为循环引用(Student引用Course,Course引用Student)导致StackOverflowError。通过排除关联字段,可以避免这个问题。
2.2 CourseEntity 类
接下来定义课程实体。一门课程可以被多名学生选修,因此CourseEntity中需要一个集合来存储选修该课程的学生。
import javax.persistence.Column;
import javax.persistence.Entity;
import javax.persistence.GeneratedValue;
import javax.persistence.GenerationType;
import javax.persistence.Id;
import javax.persistence.JoinColumn;
import javax.persistence.JoinTable;
import javax.persistence.ManyToMany;
import javax.persistence.Table;
import lombok.Data;
import lombok.EqualsAndHashCode;
import lombok.ToString;
import java.util.HashSet;
import java.util.Set;
@Entity
@Table(name = "courses")
@Data
@EqualsAndHashCode(exclude = "students") // 避免循环引用导致StackOverflowError
@ToString(exclude = "students") // 避免循环引用导致StackOverflowError
public class CourseEntity {
@Id
@GeneratedValue(strategy = GenerationType.IDENTITY)
private Long id;
@Column(name = "course_name", nullable = false)
private String courseName;
// 多对多关系,CourseEntity 是关系的拥有方
@ManyToMany
@JoinTable(
name = "course_student", // 中间表的名称
joinColumns = @JoinColumn(name = "course_id"), // 本实体(Course)在中间表中的外键列
inverseJoinColumns = @JoinColumn(name = "student_id") // 关联实体(Student)在中间表中的外键列
)
private Set students = new HashSet<>(); // 使用Set避免重复,并提高性能
} 注解解释:
- @ManyToMany: 声明与StudentEntity的多对多关系。由于CourseEntity是关系的拥有方(Owning Side),它负责定义中间表。
- @JoinTable: 这个注解是定义多对多关系的关键,它指定了中间表的详细信息。
- name = "course_student": 指定中间表的名称。数据库中将创建一个名为course_student的表。
- joinColumns = @JoinColumn(name = "course_id"): 指定本实体(CourseEntity)在中间表中的外键列名。这意味着course_student表中将有一个course_id列,它引用courses表的主键。
- inverseJoinColumns = @JoinColumn(name = "student_id"): 指定关联实体(StudentEntity)在中间表中的外键列名。这意味着course_student表中将有一个student_id列,它引用students表的主键。
3. 关系的管理
建立了双向关联后,管理关系需要注意维护双方的引用。
添加学生到课程:
当一个学生选修一门课程时,你需要同时更新CourseEntity中的学生集合和StudentEntity中的课程集合。
// 假设 course 和 student 已经是持久化对象或从数据库加载
CourseEntity course = new CourseEntity();
course.setCourseName("计算机科学导论");
StudentEntity student = new StudentEntity();
student.setStudentName("张三");
// 建立双向关联
course.getStudents().add(student);
student.getCourses().add(course);
// 保存或更新实体(通常通过Repository或EntityManager)
// courseRepository.save(course);
// studentRepository.save(student); // 如果是新实体,需要先保存注意事项:
关系拥有方: 在双向关联中,通常只有一方是关系的拥有方(Owning Side),负责维护数据库中的关联关系(即中间表的插入、更新、删除)。在我们的例子中,CourseEntity是拥有方,因为它使用了@JoinTable。StudentEntity是关系的非拥有方,它使用mappedBy来指示其映射由CourseEntity中的students字段管理。
级联操作 (CascadeType): 如果希望在保存、删除CourseEntity时自动对关联的StudentEntity执行相应操作,可以使用cascade属性。例如,@ManyToMany(cascade = CascadeType.ALL)。但对于多对多关系,通常不推荐使用CascadeType.ALL,因为删除一门课程不应自动删除所有选修该课程的学生。更常见的是使用CascadeType.PERSIST或CascadeType.MERGE。
抓取策略 (FetchType): 默认情况下,@ManyToMany的抓取策略是FetchType.LAZY(延迟加载)。这意味着在访问course.getStudents()之前,相关的学生数据不会从数据库中加载。这有助于提高性能,避免不必要的数据库查询。如果需要立即加载,可以设置为FetchType.EAGER,但通常不推荐在@ManyToMany中使用EAGER,因为它可能导致大量的额外查询(N+1问题)。
-
维护双向关系: 当你添加或移除一个学生到课程时,为了确保对象模型的一致性,最佳实践是同时更新两边的集合。例如,创建一个辅助方法:
// 在 CourseEntity 中添加辅助方法 public void addStudent(StudentEntity student) { this.students.add(student); student.getCourses().add(this); } // 在 CourseEntity 中添加辅助方法 public void removeStudent(StudentEntity student) { this.students.remove(student); student.getCourses().remove(this); }
4. 总结
在JPA中,直接将List










