MyBatis-Plus中的复合主键

<think>好的，我现在需要帮助用户解决在MyBatis-Plus中如何处理复合主键的问题。用户已经提供了相关的引用内容，我需要先理解这些信息，然后结合MyBatis-Plus的官方文档或常见做法来回答。 首先，用户提到的引用[2]指出，复合主键在代码中需要处理多列的值，保证唯一性，并且在复杂查询时可能增加代码复杂性和难度。引用[4]展示了一个使用@TableName和简单主键的示例。但是MyBatis-Plus默认使用@TableId注解来标识主键，而复合主键需要不同的处理方式。 根据我所了解的，MyBatis-Plus本身并没有直接提供复合主键的注解支持，这与MyBatis-Flex可能不同。处理复合主键通常需要用户自定义实现，比如使用@TableId注解组合多个字段，或者在实体类中创建一个复合主键类，并实现Serializable接口。例如，用户可能需要定义一个包含多个主键字段的类，并在实体类中使用@TableId(type = IdType.INPUT)来指定复合主键，或者在XML映射文件中手动配置复合主键。 接下来，我需要验证这些方法是否正确。查阅MyBatis-Plus的官方文档，发现确实需要用户手动处理复合主键。常见做法是创建一个复合主键类，然后在实体类中使用@TableField注解，并结合@TableId(type = IdType.INPUT)来指明主键生成策略为手动输入。此外，在Mapper接口中，可能需要使用@SelectKey注解或者在XML中编写SQL来处理复合主键的查询和操作。 用户需要具体的示例，所以应该提供一个代码示例。例如，定义一个UserKey类包含id和name作为复合主键字段，然后在User实体类中引用这个复合主键类，并使用@TableId注解。同时，在Mapper接口中，可能需要自定义SQL语句来处理复合主键的条件查询。 另外，需要注意复合主键在CRUD操作中的影响，比如使用UpdateWrapper或QueryWrapper时，需要同时设置多个主键字段的值。例如，在根据主键查询时，需要同时传入多个字段的值，或者在更新操作中确保所有主键字段都被正确设置。 最后，根据引用[2]提到的性能影响，需要提醒用户复合主键可能带来的复杂性和潜在的性能问题，尤其是在多表关联和复杂查询时，需要仔细设计数据库结构和代码逻辑，以避免错误和性能下降。</think>### MyBatis-Plus 复合主键使用方法 在 MyBatis-Plus 中，**复合主键需要通过自定义方式实现**，因为框架默认仅支持单字段主键（通过 `@TableId` 注解）。以下是具体实现步骤和示例： --- #### 步骤 1：定义复合主键类 创建一个实现 `Serializable` 的类，包含所有主键字段： ```java public class UserKey implements Serializable { private Long id; private String name; // 假设 id + name 组成复合主键 // 必须重写 equals 和 hashCode 方法 @Override public boolean equals(Object o) { /*...*/ } @Override public int hashCode() { /*...*/ } } ``` --- #### 步骤 2：实体类配置 在实体类中通过 `@TableId` 和 `@TableField` 组合主键字段，并指定主键生成策略为手动输入（`IdType.INPUT`）： ```java @TableName("user") public class User { @TableId(type = IdType.INPUT) private UserKey key; // 复合主键对象 @TableField("age") private Integer age; // 其他字段... } ``` --- #### 步骤 3：Mapper 接口配置 在 Mapper 接口中自定义 SQL 或使用条件构造器时，需显式指定所有主键字段： ```xml <!-- XML 示例 --> <select id="selectByCompositeKey" resultType="User"> SELECT * FROM user WHERE id = #{key.id} AND name = #{key.name} </select> ``` ```java // 使用 QueryWrapper 查询 QueryWrapper<User> wrapper = new QueryWrapper<>(); wrapper.eq("id", userKey.getId()) .eq("name", userKey.getName()); userMapper.selectOne(wrapper); ``` --- #### 注意事项 1. **唯一性约束**：需在数据库表中为复合主键字段添加联合唯一约束，例如： ```sql ALTER TABLE user ADD PRIMARY KEY (id, name); ``` 2. **CRUD 操作影响**： - **查询**：必须同时传入所有主键字段值。 - **更新/删除**：需通过 `UpdateWrapper` 或 `DeleteWrapper` 明确指定所有主键条件。 3. **性能与复杂度**：复合主键会增加代码复杂度，尤其在多表关联查询时需谨慎处理字段映射[^2]。 --- #### 示例场景 假设需要根据复合主键查询用户： ```java UserKey key = new UserKey(); key.setId(1L); key.setName("Alice"); QueryWrapper<User> wrapper = new QueryWrapper<>(); wrapper.eq("id", key.getId()) .eq("name", key.getName()); User user = userMapper.selectOne(wrapper); ``` ---