mybatis-plus 基于 Mapper接口的 insert

基于BaseMapper的crud

• 通用 CRUD 封装BaseMapper接口，
• Mybatis-Plus 启动时，自动解析实体表关系映射转换为 Mybatis 内部对象注入容器，内部包含常见的单表操作

insert

"插入一条记录"T就是要插入的实体对象 默认主键生成策略为雪花算法（后面讲解）intinsert(Tentity);

insert 举例详解

前置准备

已定义的User实体类（稍补充主键策略说明）：

importcom.baomidou.mybatisplus.annotation.IdType;importcom.baomidou.mybatisplus.annotation.TableId;importcom.baomidou.mybatisplus.annotation.TableName;importlombok.Data;@Data@TableName("user")// 对应数据库user表publicclassUser{// 主键策略：// 1. IdType.AUTO：数据库自增（需先给数据库表id字段设置自增）// 2. IdType.ASSIGN_ID（默认）：雪花算法生成Long型ID// 3. IdType.INPUT：手动输入主键值@TableId(type=IdType.AUTO)privateLongid;// 用户IDprivateStringusername;// 用户名privateIntegerage;// 年龄privateStringemail;// 邮箱}

UserMapper接口（继承BaseMapper<User>即可使用insert方法）：

importcom.baomidou.mybatisplus.core.mapper.BaseMapper;importorg.apache.ibatis.annotations.Mapper;@MapperpublicinterfaceUserMapperextendsBaseMapper<User>{// 无需手动编写insert方法，BaseMapper已内置}

insert(T entity) 方法使用示例

示例1：基础使用（数据库自增主键）

适用于主键为数据库自增的场景（对应@TableId(type = IdType.AUTO)）：

importorg.springframework.stereotype.Service;importjavax.annotation.Resource;@ServicepublicclassUserService{@ResourceprivateUserMapperuserMapper;/** * 插入一条用户记录（数据库自增主键） */publicvoidinsertUser(){// 1. 创建实体对象，无需设置id（自增策略下会由数据库自动生成）Useruser=newUser();user.setUsername("zhangsan");// 设置用户名user.setAge(25);// 设置年龄user.setEmail("zhangsan@example.com");// 设置邮箱// 2. 调用insert方法，返回值为「受影响的行数」（插入成功返回1，失败返回0）intaffectedRows=userMapper.insert(user);// 3. 关键：插入后，实体对象的id会被**自动回填**System.out.println("插入受影响行数："+affectedRows);// 输出：1System.out.println("插入后生成的主键ID："+user.getId());// 输出：数据库自增的ID（如1、2、3...）}}

示例2：默认雪花算法主键（IdType.ASSIGN_ID）

如果将User实体的主键策略改为默认的雪花算法：

// 修改User类的主键注解@TableId(type=IdType.ASSIGN_ID)privateLongid;

调用逻辑不变，但主键生成规则不同：

publicvoidinsertUserWithSnowflakeId(){Useruser=newUser();user.setUsername("lisi");user.setAge(30);user.setEmail("lisi@example.com");intaffectedRows=userMapper.insert(user);System.out.println("插入受影响行数："+affectedRows);// 输出：1// 雪花算法生成的Long型ID（如175689876543219876）System.out.println("雪花算法生成的主键ID："+user.getId());}

示例3：手动输入主键（IdType.INPUT）

适用于需要自定义主键值的场景：

// 修改User类的主键注解@TableId(type=IdType.INPUT)privateLongid;

调用时需手动设置id：

publicvoidinsertUserWithCustomId(){Useruser=newUser();user.setId(100L);// 手动指定主键IDuser.setUsername("wangwu");user.setAge(28);user.setEmail("wangwu@example.com");intaffectedRows=userMapper.insert(user);System.out.println("插入受影响行数："+affectedRows);// 输出：1System.out.println("手动设置的主键ID："+user.getId());// 输出：100}

关键注意事项

1. 插入时，如果实体字段值为null，
   MyBatis-Plus 会忽略该字段，
   数据库中对应列，会按默认值填充（如null或数据库设置的默认值）；
2. 雪花算法生成的ID是全局唯一的，适合分布式系统，无需依赖数据库自增；
3. 若，数据库表字段 和 实体属性名 不一致，需用@TableField(value = "数据库列名")映射。

总结

1. insert(T entity)方法返回受影响的行数，插入成功返回1，失败返回0；
2. 主键生成策略由实体类@TableId的type决定，
   默认是雪花算法（IdType.ASSIGN_ID）
3. 插入完成后，实体对象的id字段会被自动回填，可直接获取生成的主键值。