mybatis百科-结果集映射类ResultMap

ResultMap 对应的是结果集 <resultMap>中的一个结果集。 其基本组成部分中， 含有 ResultMapping 对象。

其组成大致如下：

本文， 主要讲解一下该类的组成。

1 成员变量 // resultMap 节点的 id private String id; // resultMap 节点的 type private Class<?> type; // 用于记录 <discriminayor> 节点之外的其他映射关系 private List<ResultMapping> resultMappings; // 记录映射关系中带有 ID 标记的映射关系。 如 id， constructor 等节点 private List<ResultMapping> idResultMappings; // 记录映射关系中有 Constructor 标记的映射关系 private List<ResultMapping> constructorResultMappings; // 记录映射关系中没有 Constructor 标记的映射关系 private List<ResultMapping> propertyResultMappings; // 记录所有映射关系中涉及 column 属性的集合 private Set<String> mappedColumns; private Set<String> mappedProperties; // 鉴别器， 对应 <discriminayor> 节点 private Discriminator discriminator; // 是否含有嵌套的结果映射， 如果某个映射关系中有 resultMap， 没有 resultSet ， 则为true private boolean hasNestedResultMaps; // 是否存在嵌套查询 private boolean hasNestedQueries; // 是否开启自动映射 private Boolean autoMapping; 2 构造函数

只有默认构造函数

private ResultMap() { } 3 其他函数 3.1 setter 和 getter 函数

对象创建使用的是建造者模式， 因此，只有部分成员变量含有 setter 函数。而除了 Configuration 对象， 其他都含有 getter 函数。

4 静态内部类 4.1 成员变量 private ResultMap resultMap = new ResultMap();

是要建造的对象。

4.2 构造函数 public Builder(Configuration configuration, String id, Class<?> type, List<ResultMapping> resultMappings) { this(configuration, id, type, resultMappings, null); } public Builder(Configuration configuration, String id, Class<?> type, List<ResultMapping> resultMappings, Boolean autoMapping) { resultMap.configuration = configuration; resultMap.id = id; resultMap.type = type; resultMap.resultMappings = resultMappings; resultMap.autoMapping = autoMapping; }

没有默认构造函数， 必须要给ResultMap对象的一些成员变量赋值。

4.3 建造者相关的函数 public Builder discriminator(Discriminator discriminator) { resultMap.discriminator = discriminator; return this; }

discriminator， 赋值后返回对象本身。

负责建造对象一些逻辑的函数。

public ResultMap build() { if (resultMap.id == null) { throw new IllegalArgumentException("ResultMaps must have an id"); } resultMap.mappedColumns = new HashSet<>(); resultMap.mappedProperties = new HashSet<>(); resultMap.idResultMappings = new ArrayList<>(); resultMap.constructorResultMappings = new ArrayList<>(); resultMap.propertyResultMappings = new ArrayList<>(); final List<String> constructorArgNames = new ArrayList<>(); // 遍历 resultMappings for (ResultMapping resultMapping : resultMap.resultMappings) { // 是否存在嵌套查询 resultMap.hasNestedQueries = resultMap.hasNestedQueries || resultMapping.getNestedQueryId() != null; // 是否存在嵌套的结果 resultMap.hasNestedResultMaps = resultMap.hasNestedResultMaps || (resultMapping.getNestedResultMapId() != null && resultMapping.getResultSet() == null); // 获取列名 final String column = resultMapping.getColumn(); if (column != null) { // 列名转大写添加到 mappedColumns 结果集中 resultMap.mappedColumns.add(column.toUpperCase(Locale.ENGLISH)); } else if (resultMapping.isCompositeResult()) { for (ResultMapping compositeResultMapping : resultMapping.getComposites()) { final String compositeColumn = compositeResultMapping.getColumn(); if (compositeColumn != null) { resultMap.mappedColumns.add(compositeColumn.toUpperCase(Locale.ENGLISH)); } } } // 获取列映射对应的属性 final String property = resultMapping.getProperty(); if(property != null) { resultMap.mappedProperties.add(property); } if (resultMapping.getFlags().contains(ResultFlag.CONSTRUCTOR)) { resultMap.constructorResultMappings.add(resultMapping); if (resultMapping.getProperty() != null) { constructorArgNames.add(resultMapping.getProperty()); } } else { resultMap.propertyResultMappings.add(resultMapping); } if (resultMapping.getFlags().contains(ResultFlag.ID)) { resultMap.idResultMappings.add(resultMapping); } } if (resultMap.idResultMappings.isEmpty()) { resultMap.idResultMappings.addAll(resultMap.resultMappings); } if (!constructorArgNames.isEmpty()) { final List<String> actualArgNames = argNamesOfMatchingConstructor(constructorArgNames); if (actualArgNames == null) { throw new BuilderException("Error in result map '" + resultMap.id + "'. Failed to find a constructor in '" + resultMap.getType().getName() + "' by arg names " + constructorArgNames + ". There might be more info in debug log."); } Collections.sort(resultMap.constructorResultMappings, (o1, o2) -> { int paramIdx1 = actualArgNames.indexOf(o1.getProperty()); int paramIdx2 = actualArgNames.indexOf(o2.getProperty()); return paramIdx1 - paramIdx2; }); } // lock down collections resultMap.resultMappings = Collections.unmodifiableList(resultMap.resultMappings); resultMap.idResultMappings = Collections.unmodifiableList(resultMap.idResultMappings); resultMap.constructorResultMappings = Collections.unmodifiableList(resultMap.constructorResultMappings); resultMap.propertyResultMappings = Collections.unmodifiableList(resultMap.propertyResultMappings); resultMap.mappedColumns = Collections.unmodifiableSet(resultMap.mappedColumns); return resultMap; } 4.4 获取配置的构造方法参数列表