Spring JPA一对一关联场景下无法向employee_detail关联表存储数据如何解决

核心问题原因 #

• 实体类未配置级联保存属性，JPA不会自动处理关联对象的持久化
• 双向关联关系未手动维护：当前关联中EmployeeDetail是关系维护端（持有外键employeeId），存储时若EmployeeDetail的employee属性为null，外键为空会导致存储失败
• 新增EmployeeDetail的表单未传递关联的Employee主键，导致参数绑定后employee属性为空

分步解决方法 #

1. 实体类添加级联配置 #

修改Employee类的一对一关联注解，添加级联操作配置，操作主表时会自动处理关联的从表数据：

// 修改前：@OneToOne(mappedBy = "employee")
@OneToOne(mappedBy = "employee", cascade = CascadeType.ALL, orphanRemoval = true)
private EmployeeDetail employeeDetail;

如果需要单独存储EmployeeDetail时自动关联已存在的Employee，可以在EmployeeDetail的关联注解添加合适的级联属性：

@OneToOne(cascade = {CascadeType.PERSIST, CascadeType.MERGE})
@JoinColumn(name="employeeId")
private Employee employee;

2. 补全EmployeeDetail表单的关联字段 #

在addNewEmployeeDetailForm中添加关联员工的选择项，提交时传递关联的员工ID：

<tr>
    <td><label>关联员工:</label></td>
    <td>
        <form:select path="employee.id">
            <form:options items="${employees}" itemValue="id" itemLabel="firstName"/>
        </form:select>
    </td>
</tr>

同时修改EmployeeDetailController的跳转新增页面方法，把所有员工列表传入模型供下拉框选择：

@Autowired
private EmployeeService employeeService;

@GetMapping("/showFormForAddEmployeeDetail")
public String showFormForAddEmployeeDetail(Model theModel) {
    EmployeeDetail theEmployeeDetail = new EmployeeDetail();
    // 查询所有员工供关联选择
    List<Employee> employees = employeeService.listEmployee();
    theModel.addAttribute("employees", employees);
    theModel.addAttribute("employeeDetail", theEmployeeDetail);
    return "addNewEmployeeDetailForm";
}

3. 业务层手动维护关联关系 #

如果是单独存储EmployeeDetail，需要在service层先查询关联的员工实体，保证关联关系正确：

@Override
@Transactional
public void addNewEmployeeDetail(EmployeeDetail theEmployeeDetail) {
    // 校验关联的员工是否存在
    Integer employeeId = theEmployeeDetail.getEmployee().getId();
    Employee existEmployee = employeeService.getEmployeeById(employeeId);
    theEmployeeDetail.setEmployee(existEmployee);
    employeeDetailDAO.addNewEmployeeDetail(theEmployeeDetail);
}

如果是新增Employee时同时新增关联的EmployeeDetail，需要在Employee的service层手动维护双向关联：

@Override
@Transactional
public void addNewEmployee(Employee theEmployee) {
    if (theEmployee.getEmployeeDetail() != null) {
        // 给从表设置主表对象，维护关联关系
        theEmployee.getEmployeeDetail().setEmployee(theEmployee);
    }
    employeeDAO.addNewEmployee(theEmployee);
}

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