如何用注解的方式实现Mybatis插入数据时返回自增的主键Id

下面详细讲解如何用注解的方式实现Mybatis插入数据时返回自增的主键Id。

首先，在处理插入操作时，通常需要获取数据库自动生成的主键Id，以便后续处理。使用Mybatis时，可以使用useGeneratedKeys和keyProperty两个属性来实现此功能。

其中，useGeneratedKeys表示是否使用数据库自动生成的主键，默认值是false；而keyProperty则表示映射到主键属性的全局名称，需要配合useGeneratedKeys使用。

接下来，我们看一个示例。假设有一个用户信息表user，包含主键id和字段name，希望插入一条用户信息，返回自动生成的主键id。对应的Java bean可以这样定义：

public class User {
    private Integer id;
    private String name;

    // getters and setters
}

然后，在Mapper接口UserMapper中，使用@Insert注解，并在注解中指定useGeneratedKeys和keyProperty属性。代码如下：

public interface UserMapper {
    @Insert("INSERT INTO user(name) VALUES(#{name})")
    @Options(useGeneratedKeys = true, keyProperty = "id")
    int insert(User user);
}

可以看到，通过@Insert注解指定SQL语句，使用#{name}占位符表示要插入的值；并在注解中使用@Options注解，指定useGeneratedKeys和keyProperty属性，其中keyProperty对应User类中的id属性。

最后，我们调用UserMapper中的insert()方法即可插入一条用户信息，并返回自动生成的主键id。示例代码如下：

@Autowired
private UserMapper userMapper;

@Test
public void testInsert() {
    User user = new User();
    user.setName("张三");
    int rows = userMapper.insert(user);
    System.out.println("插入的行数：" + rows);
    System.out.println("自动生成的主键id：" + user.getId());
}

可以看到，在调用insert()方法后，可以通过user.getId()方法获取自动生成的主键id。输出结果如下：

插入的行数：1
自动生成的主键id：1

除了@Options注解之外，Mybatis中还提供了@SelectKey等其他注解，可以实现类似的效果。下面再给出一个使用@SelectKey注解的示例代码。

public interface UserMapper {
    @Insert("INSERT INTO user(name) VALUES(#{name})")
    @SelectKey(statement="select last_insert_id()", keyProperty="id", before=false, resultType=Integer.class)
    int insert(User user);
}

这里使用@SelectKey注解，在插入语句之前，执行select last_insert_id()语句来获取最后一次插入自动生成的主键；并将返回值映射到User类的id属性中。