如何基于现有MyBatis Mapper 将JSON关联查询结果转换为Java Bean?
复用MyBatis配置实现扁平JSON转嵌套对象的方案
核心思路
完全复用现有Mapper里定义的User、UserTagResultMap映射规则,不用重写任何字段映射、集合拼接逻辑,避免和实际线上查询的映射结果出现偏差。仅需要做一层极简的JSON到ResultSet的适配,不需要模拟完整JDBC链路,实现成本远低于之前尝试的拦截器方案。
具体实现步骤
1. 加载现有MyBatis配置获取ResultMap
直接在本地环境加载你已有的MyBatis配置和对应Mapper XML,从全局Configuration对象中取出已定义的User ResultMap,无需重复编写映射规则:
// 加载MyBatis核心配置和UserMapper XML,和你生产环境用的配置完全一致 Configuration configuration = new XMLConfigBuilder(yourMapperXmlStream).parse().getConfiguration(); // 直接获取Mapper中已定义的User结果映射,对应namespace+resultMap id ResultMap userResultMap = configuration.getResultMap("org.example.mybatis.mapper.UserMapper.User");
2. 实现极简JSON适配ResultSet
不需要实现JDBC规范里ResultSet的全部方法,只需要重写MyBatis做结果映射时会调用的几个核心方法,把导出的扁平JSON行数据包装成MyBatis可识别的ResultSet结构:
- 逐行遍历导出的JSON数组,每一个JSON对象对应ResultSet中的一行
- 重写核心方法支撑解析:
next():移动行指针到下一条JSON数据,无数据时返回falsegetObject(String columnName):根据列名(就是JSON里的key,比如user_id、tag_id)从当前行取值getMetaData():返回所有列名元数据
参考实现示例(其余未用到的方法直接抛UnsupportedOperationException即可,MyBatis解析不会触发):
public class JsonBackedResultSet extends BaseResultSet { private final List<Map<String, Object>> rowData; private int cursor = -1; private Map<String, Object> currentRow; public JsonBackedResultSet(List<Map<String, Object>> rowData) { this.rowData = rowData; } @Override public boolean next() { cursor++; if (cursor >= rowData.size()) { return false; } currentRow = rowData.get(cursor); return true; } @Override public Object getObject(String columnName) { return currentRow.get(columnName); } @Override public ResultSetMetaData getMetaData() { Set<String> columns = rowData.get(0).keySet(); return new SimpleResultSetMetaData(columns); } }
3. 调用内置处理器完成嵌套映射
直接使用MyBatis自带的DefaultResultSetHandler做结果解析,自动按照你配置的<id>主键去重、拼接tagList集合,不需要手动写分组逻辑:
// 构造临时MappedStatement,和实际查询用的配置保持一致 MappedStatement tempMappedStatement = new MappedStatement.Builder( configuration, "tempJsonParse", new RawSqlSource(configuration, "select * from dual", null), SqlCommandType.SELECT ).resultMaps(Collections.singletonList(userResultMap)).build(); // 初始化结果处理器 DefaultResultSetHandler resultHandler = new DefaultResultSetHandler( new DefaultSqlSession(configuration, null), tempMappedStatement ); // 直接输出最终嵌套结构的List<User> List<User> userList = resultHandler.handleResultSets(new JsonBackedResultSet(exportedJsonRows));
关键注意事项
- 导出的JSON字段名必须和SQL语句里定义的列别名完全一致(比如
user_id、tag_user_id),不能直接用Java属性名(比如id、name),否则ResultMap无法匹配对应列。 - 如果存在用户无标签的场景(left join产生的null行),要保证JSON中对应标签字段的key存在、值为null,不要直接缺字段,否则会触发
<collection>标签上配置的notNullColumn="tag_user_id"判断逻辑异常。 - 整个过程完全复用MyBatis内置的集合拼接、主键去重逻辑,和直接连接数据库查询得到的嵌套结构完全一致,不会出现映射偏差。
内容的提问来源于stack exchange,提问作者RTM
相关产品推荐
相关产品推荐

