MyBatis-Plus Mapper 接口方法操作详解_Java

mybatis-plus mapper 接口方法详解

1. basemapper 核心方法概览

mybatis-plus 的 basemapper<t> 接口提供了丰富的 crud 操作方法，所有方法都不需要编写 sql即可使用。

1.1 完整方法列表

方法类别	方法名	说明	使用场景
插入	`insert(t entity)`	插入一条记录	新增数据
删除	`deletebyid(serializable id)`	根据id删除	按主键删除
	`deletebatchids(collection ids)`	批量id删除	批量删除
	`deletebymap(map map)`	根据map删除	简单条件删除
	`delete(wrapper wrapper)`	条件删除	复杂条件删除
更新	`updatebyid(t entity)`	根据id更新	按主键更新
	`update(t entity, wrapper wrapper)`	条件更新	复杂更新逻辑
查询	`selectbyid(serializable id)`	根据id查询	按主键查询
	`selectbatchids(collection ids)`	批量id查询	按主键列表查询
	`selectbymap(map map)`	根据map查询	简单条件查询
	`selectone(wrapper wrapper)`	查询单条记录	确保结果唯一时
	`selectcount(wrapper wrapper)`	查询记录数	统计数量
	`selectlist(wrapper wrapper)`	查询列表	条件查询
	`selectmaps(wrapper wrapper)`	查询map列表	只需要部分字段
分页	`selectpage(page page, wrapper wrapper)`	分页查询	分页数据查询
	`selectmapspage(page page, wrapper wrapper)`	map分页查询	分页+部分字段

public interface basemapper<t> extends mapper<t> {
// ========== 插入操作 ==========
int insert(t entity);
// ========== 删除操作 ==========
int deletebyid(serializable id);
int deletebymap(@param(constants.column_map) map<string, object> columnmap);
int delete(@param(constants.wrapper) wrapper<t> wrapper);
int deletebatchids(@param(constants.collection) collection<? extends serializable> idlist);
// ========== 更新操作 ==========
int updatebyid(@param(constants.entity) t entity);
int update(@param(constants.entity) t entity, @param(constants.wrapper) wrapper<t> updatewrapper);
// ========== 查询操作 ==========
t selectbyid(serializable id);
list<t> selectbatchids(@param(constants.collection) collection<? extends serializable> idlist);
list<t> selectbymap(@param(constants.column_map) map<string, object> columnmap);
t selectone(@param(constants.wrapper) wrapper<t> querywrapper);
integer selectcount(@param(constants.wrapper) wrapper<t> querywrapper);
list<t> selectlist(@param(constants.wrapper) wrapper<t> querywrapper);
list<map<string, object>> selectmaps(@param(constants.wrapper) wrapper<t> querywrapper);
list<object> selectobjs(@param(constants.wrapper) wrapper<t> querywrapper);
// ========== 分页查询 ==========
<e extends ipage<t>> e selectpage(e page, @param(constants.wrapper) wrapper<t> querywrapper);
<e extends ipage<map<string, object>>> e selectmapspage(e page, @param(constants.wrapper) wrapper<t> querywrapper);
}

2. 插入操作（insert）

2.1 基本插入方法

// mapper接口定义
public interface usermapper extends basemapper<user> {
// 无需额外声明，直接使用继承的方法
}
// 使用示例
@service
public class userservice {
@autowired
private usermapper usermapper;
public void testinsert() {
    user user = new user();
    user.setname("张三");
    user.setage(25);
    user.setemail("zhangsan@example.com");
    // 插入一条记录
    int result = usermapper.insert(user);
    system.out.println("插入结果: " + result); // 影响行数
    system.out.println("自增id: " + user.getid()); // 自动回填主键
}
}

2.2 插入相关配置

// 实体类配置示例
@data
@tablename("user")
public class user {
@tableid(type = idtype.auto) // 自增主键
private long id;
private string name;
private integer age;
private string email;
@tablefield(fill = fieldfill.insert)  // 自动填充
private localdatetime createtime;
}

3. 删除操作（delete）

3.1 根据id删除

// 根据主键删除
public void testdeletebyid() {
// 删除id为1的用户
int result = usermapper.deletebyid(1l);
system.out.println("删除行数: " + result);
}
// 批量根据id删除
public void testdeletebatchids() {
list<long> ids = arrays.aslist(1l, 2l, 3l);
int result = usermapper.deletebatchids(ids);
system.out.println("批量删除行数: " + result);
}

3.2 条件删除

// 根据map条件删除
public void testdeletebymap() {
map<string, object> condition = new hashmap<>();
condition.put("name", "张三"); // name = '张三'
condition.put("age", 25); // and age = 25
int result = usermapper.deletebymap(condition);
system.out.println("条件删除行数: " + result);
}
// 使用wrapper条件删除
public void testdeletebywrapper() {
lambdaquerywrapper<user> wrapper = new lambdaquerywrapper<>();
wrapper.eq(user::getname, "张三")
.ge(user::getage, 18); // name = '张三' and age >= 18
int result = usermapper.delete(wrapper);
system.out.println("wrapper删除行数: " + result);
}

4. 更新操作（update）

4.1 根据id更新

// 根据主键更新
public void testupdatebyid() {
user user = new user();
user.setid(1l);
user.setname("李四");
user.setemail("lisi@example.com");
int result = usermapper.updatebyid(user);
system.out.println("更新行数: " + result);
}

4.2 条件更新

// 使用updatewrapper进行条件更新
public void testupdatebywrapper() {
// 方法1：实体 + wrapper
user user = new user();
user.setemail("updated@example.com");
updatewrapper<user> wrapper = new updatewrapper<>();
wrapper.eq("name", "张三")                    // 条件：name = '张三'
       .set("age", 30)                       // 直接设置字段值
       .setsql("version = version + 1");     // 自定义sql片段
int result = usermapper.update(user, wrapper);
// 方法2：纯wrapper更新（推荐）
lambdaupdatewrapper<user> lambdawrapper = new lambdaupdatewrapper<>();
lambdawrapper.eq(user::getname, "张三")
            .set(user::getage, 30)
            .set(user::getemail, "updated@example.com");
int result2 = usermapper.update(null, lambdawrapper);
}

5. 查询操作（select）

5.1 根据id查询

// 基本id查询
public void testselectbyid() {
user user = usermapper.selectbyid(1l);
system.out.println("查询结果: " + user);
}
// 批量id查询
public void testselectbatchids() {
list<long> ids = arrays.aslist(1l, 2l, 3l, 4l);
list<user> users = usermapper.selectbatchids(ids);
system.out.println("批量查询结果: " + users.size());
}

5.2 条件查询

// 根据map条件查询
public void testselectbymap() {
map<string, object> condition = new hashmap<>();
condition.put("name", "张三");
condition.put("status", 1);
list<user> users = usermapper.selectbymap(condition);
system.out.println("map条件查询: " + users);
}
// 查询单条记录
public void testselectone() {
lambdaquerywrapper<user> wrapper = new lambdaquerywrapper<>();
wrapper.eq(user::getname, "张三");
user user = usermapper.selectone(wrapper);  // 必须确保结果唯一
system.out.println("单条查询: " + user);
}
// 查询数量
public void testselectcount() {
lambdaquerywrapper<user> wrapper = new lambdaquerywrapper<>();
wrapper.ge(user::getage, 18); // 年龄 >= 18
long count = usermapper.selectcount(wrapper);
system.out.println("满足条件的记录数: " + count);
}

5.3 复杂查询示例

// 复杂条件查询
public void testcomplexquery() {
lambdaquerywrapper<user> wrapper = new lambdaquerywrapper<>();
// 条件组合
wrapper.select(user::getid, user::getname, user::getage)  // 指定查询字段
      .like(user::getname, "张")                          // 模糊查询
      .between(user::getage, 18, 30)                      // 范围查询
      .isnotnull(user::getemail)                        // 非空查询
      .in(user::getstatus, arrays.aslist(1, 2, 3))      // in查询
      .orderbydesc(user::getcreatetime)                  // 排序
      .last("limit 10");                                 // 自定义sql后缀
list<user> users = usermapper.selectlist(wrapper);
system.out.println("复杂查询结果: " + users);
}
// 查询特定字段
public void testselectspecificfields() {
querywrapper<user> wrapper = new querywrapper<>();
wrapper.select("id", "name", "email") // 只查询指定字段
.eq("status", 1);
list<user> users = usermapper.selectlist(wrapper);
}
// 查询为map列表
public void testselectmaps() {
lambdaquerywrapper<user> wrapper = new lambdaquerywrapper<>();
wrapper.select(user::getid, user::getname)
.ge(user::getage, 18);
list<map<string, object>> maplist = usermapper.selectmaps(wrapper);
// 结果: [{"id":1, "name":"张三"}, {"id":2, "name":"李四"}]
}

6. 分页查询

6.1 基本分页配置

// 配置分页插件
@configuration
public class mybatisplusconfig {
@bean
public mybatisplusinterceptor mybatisplusinterceptor() {
    mybatisplusinterceptor interceptor = new mybatisplusinterceptor();
    interceptor.addinnerinterceptor(new paginationinnerinterceptor(dbtype.mysql));
    return interceptor;
}
}

6.2 分页查询使用

// 分页查询示例
public void testselectpage() {
// 创建分页对象：查询第1页，每页10条
page<user> page = new page<>(1, 10);
lambdaquerywrapper<user> wrapper = new lambdaquerywrapper<>();
wrapper.ge(user::getage, 18)
      .orderbydesc(user::getcreatetime);
// 执行分页查询
page<user> result = usermapper.selectpage(page, wrapper);
system.out.println("总记录数: " + result.gettotal());
system.out.println("总页数: " + result.getpages());
system.out.println("当前页数据: " + result.getrecords());
system.out.println("是否有下一页: " + result.hasnext());
}
// map分页查询
public void testselectmapspage() {
page<map<string, object>> page = new page<>(1, 10);
querywrapper<user> wrapper = new querywrapper<>();
wrapper.select("id", "name", "age")
      .ge("age", 18);
page<map<string, object>> result = usermapper.selectmapspage(page, wrapper);
// 结果处理
result.getrecords().foreach(map -> {
    system.out.println("id: " + map.get("id") + ", name: " + map.get("name"));
});
}

7. 自定义方法扩展

7.1 自定义sql方法

// 在basemapper基础上扩展自定义方法
public interface usermapper extends basemapper<user> {
// 自定义查询方法
@select("select * from user where age > #{minage} and age < #{maxage}")
list<user> selectbyagerange(@param("minage") integer minage, 
                           @param("maxage") integer maxage);
// 自定义更新方法
@update("update user set email = #{email} where name = #{name}")
int updateemailbyname(@param("name") string name, 
                     @param("email") string email);
// 复杂查询方法
list<user> selectcomplexusers(@param("name") string name,
                             @param("minage") integer minage,
                             @param("statuslist") list<integer> statuslist);
}

7.2 对应的xml配置

<?xml version="1.0" encoding="utf-8" ?>
<!doctype mapper
public "-//mybatis.org//dtd mapper 3.0//en"
"http://mybatis.org/dtd/mybatis-3-mapper.dtd">
<mapper namespace="com.example.mapper.usermapper">
<select id="selectcomplexusers" resulttype="user">
    select * from user 
    <where>
        <if test="name != null">and name like concat('%', #{name}, '%')</if>
        <if test="minage != null">and age >= #{minage}</if>
        <if test="statuslist != null and statuslist.size() > 0">
            and status in
            <foreach collection="statuslist" item="status" open="(" separator="," close=")">
                #{status}
            </foreach>
        </if>
    </where>
</select>
</mapper>

8. 完整使用示例

8.1 完整服务类示例

@service
@transactional
public class userservice {
@autowired
private usermapper usermapper;
/**
 * 完整的crud操作示例
 */
public void completecrudexample() {
    // 1. 插入
    user newuser = new user();
    newuser.setname("测试用户");
    newuser.setage(20);
    newuser.setemail("test@example.com");
    usermapper.insert(newuser);
    long userid = newuser.getid();
    // 2. 查询
    user dbuser = usermapper.selectbyid(userid);
    system.out.println("插入后查询: " + dbuser);
    // 3. 更新
    dbuser.setage(25);
    usermapper.updatebyid(dbuser);
    // 4. 条件查询
    lambdaquerywrapper<user> wrapper = new lambdaquerywrapper<>();
    wrapper.between(user::getage, 20, 30)
          .orderbydesc(user::getid);
    list<user> users = usermapper.selectlist(wrapper);
    // 5. 分页查询
    page<user> page = new page<>(1, 5);
    page<user> pageresult = usermapper.selectpage(page, wrapper);
    // 6. 删除
    usermapper.deletebyid(userid);
}
/**
 * 批量操作示例
 */
public void batchoperationexample() {
    // 批量插入
    list<user> userlist = new arraylist<>();
    for (int i = 1; i <= 5; i++) {
        user user = new user();
        user.setname("批量用户" + i);
        user.setage(20 + i);
        userlist.add(user);
    }
    // 注意：basemapper没有批量插入方法，需要自定义或使用service的savebatch
    userlist.foreach(usermapper::insert);
    // 批量删除
    list<long> ids = userlist.stream()
        .map(user::getid)
        .collect(collectors.tolist());
    usermapper.deletebatchids(ids);
}
}

9. 最佳实践建议

简单crud：直接使用basemapper提供的方法
复杂查询：使用wrapper构建查询条件
分页查询：配置分页插件后使用selectpage方法
自定义sql：在basemapper基础上扩展自定义方法
事务管理：在service层使用@transactional注解
自动填充：利用@tablefield(fill)实现自动填充
逻辑删除：使用@tablelogic实现逻辑删除
乐观锁：使用@version实现乐观锁控制

mybatis-plus的basemapper提供了丰富的开箱即用方法，可以满足95%以上的日常开发需求。通过合理使用这些方法，可以显著提高开发效率，减少重复代码编写。

到此这篇关于mybatis-plus mapper 接口方法详解的文章就介绍到这了,更多相关mybatis-plus mapper 接口内容请搜索代码网以前的文章或继续浏览下面的相关文章希望大家以后多多支持代码网！

MyBatis-Plus Mapper 接口方法操作详解

2025年12月15日 • Java •我要评论