Mybatis 自定义ResultHandler（结果处理器）正确使用姿势

原创已于 2024-02-04 09:53:51 修改 · 3.6k 阅读

10 ·

CC 4.0 BY-SA版权

文章标签：

#mybatis必知必会 #mybatis #java #spring boot #java-ee #spring #后端

于 2024-02-02 21:10:52 首次发布

工作笔记专栏收录该内容

17 篇文章

订阅专栏

本文介绍了如何在Mybatis中使用自定义ResultHandler将查询结果的Map转换为Record类型，以简化批量处理过程，避免冗余代码。

摘要生成于 C知道，由 DeepSeek-R1 满血版支持，前往体验 >

一、使用场景

对Mybatis查询的结果集进行统一批量处理，如进行类型转换、数据变更等等。

二、前提条件

必须是查询语句。
mapper方法的返回值必须是void，这也就是不能直接从这个方法获取到查询结果集，需要在ResultHandler里面自己存放查询结果。（这个很重要，否则ResultHandler里面的逻辑不会执行，目前网上大部分资料都没有提到这一点，巨坑）
mapper方法必须传入自定义的结果处理器。

三、源码对照

方法执行入口，org.apache.ibatis.binding.MapperMethod#execute：
根据获取方法参数中ResultHandler.class类型的变量作为结果处理器：
org.apache.ibatis.binding.MapperMethod#executeWithResultHandler，可以看到executeWithResultHandler方法无返回值。

四、使用示例

目标

将原查询结果的Map转为Record，Record可以理解为将Map进行包装了一次的实体类，代码结构如下：

public class Record implements Serializable {
	
	private static final long serialVersionUID = 905784513600884082L;
	
	private Map<String, Object> columns;	

	void setColumnsMap(Map<String, Object> columns) {
		this.columns = columns;
	}
	......
}

这种如果直接使用mybatis进行构造返回结果是比较麻烦，特别是使用的地方比较多，会有很多冗余代码。

实现方式

自定义ResultHandler代码

public class RecordResultHandler implements ResultHandler<Record> {

    private final List<Record> list = new ArrayList<>();

    @Override
    public void handleResult(ResultContext context) {
        Record record = new Record();
        record.setColumns((Map<String, Object>) context.getResultObject());
        list.add(record);
    }
    
    public List<Record> getResults(){
        return list;
    }
}

xml代码

    <select id="test" resultType="map">
        select * from user_test
    </select>

Mapper层代码

	//必须返回void且传入ResultHandler
	void test(ResultHandler recordResultHandler);

调用层代码

	RecordResultHandler recordResultHandler = new RecordResultHandler();
	//integDataMapper正常注入即可
    integDataMapper.test(recordResultHandler);
    List<Record> results = recordResultHandler.getResults();