mybatis-plus 基于 Mapper接口的 insert-平芜编程栈

基于BaseMapper的crud

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

insert

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

类型	参数名	描述
T	entity	实体对象

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}