<select id="balanceByUserIds" parameterType="xxx.BalanceReqVO" 
resultType="xxx.Balance">
        select * from balance
        <where>
            <if test="dataOrgCodes != null and dataOrgCodes.size > 0">
                and data_org_code in
                <foreach collection="dataOrgCodes" open="(" separator="," close=")" item="dataOrgCode">
                    #{dataOrgCode}
                </foreach>
            </if>
            <if test="dataOrgCode != null and dataOrgCode != ''">
                and data_org_code = #{dataOrgCode}
            </if>
        </where>
    </select>

{
    "dataOrgCodes":["6","2"]
}

SELECT
	*
FROM
	balance
WHERE
	data_org_code IN (?, ?)
AND data_org_code = ?

{
    "dataOrgCodes":["6","2"]
}

SELECT
	*
FROM
	balance
WHERE
	data_org_code IN (?, ?)

// Configuration是Mybatis核心類，rootSqlNode 根SQL節(jié)點是我們定義在XML中的SQL語句。
//（例如<select>rootSqlNode</sselect>， 標簽中間的內容就是 rootSqlNode）
public DynamicSqlSource(Configuration configuration, SqlNode rootSqlNode) {
    this.configuration = configuration;
    this.rootSqlNode = rootSqlNode;
}

public BoundSql getBoundSql(Object parameterObject) {
  DynamicContext context = new DynamicContext(configuration, parameterObject);
  rootSqlNode.apply(context);
  ..............................
    BoundSql boundSql = sqlSource.getBoundSql(parameterObject);
  context.getBindings().forEach(boundSql::setAdditionalParameter);
  return boundSql;
}

public class DynamicContext {

  public static final String PARAMETER_OBJECT_KEY = "_parameter";
  public static final String DATABASE_ID_KEY = "_databaseId";
	
  // 存儲動態(tài)生成的SQL，類似于 StringBuilder 的角色
  private final StringJoiner sqlBuilder = new StringJoiner(" ");
  // 唯一編號值，會在生成最終SQL和參數(shù)值映射關系的時候用到
  private int uniqueNumber = 0;

  // 拼接SQL
  public void appendSql(String sql) {
    sqlBuilder.add(sql);
  }

  // 獲取拼接好的SQL
  public String getSql() {
    return sqlBuilder.toString().trim();
  }

  // 獲取唯一編號，返回后進行加一
  public int getUniqueNumber() {
    return uniqueNumber++;
  }
}

rootSqlNode.apply(context)

<SqlNode>
  	select * from balance
    <SqlNode>
        where
        <SqlNode>
            and data_org_code in
            <SqlNode>
               #{dataOrgCode}
            </SqlNode>
        </SqlNode>
      	<SqlNode>
            and data_org_code =
            <SqlNode>
               #{dataOrgCode}
            </SqlNode>
        </SqlNode>
    </SqlNode>
</SqlNode>

public interface SqlNode {
  boolean apply(DynamicContext context);
}

public class StaticTextSqlNode implements SqlNode {
  // 存儲我們寫的 sql 
  // 類似于 and data_org_code in
  private final String text;

  public StaticTextSqlNode(String text) {
    this.text = text;
  }

  @Override
  public boolean apply(DynamicContext context) {
    // 調用 DynamicContext 對象的 sqppendSql 方法拼接最終 sql
    context.appendSql(text);
    return true;
  }

}

public class IfSqlNode implements SqlNode {
  // 評估器
  private final ExpressionEvaluator evaluator;
  // if標簽中用于判斷這個語句是否生效的 test 屬性值
  // 這里對應我們例子中的一個為 "dataOrgCodes != null and dataOrgCodes.size > 0"
  private final String test;
  // if標簽中的內容，如果if標簽中不存在其他標簽，那么這里的值就是StaticTextSqlNode類型的節(jié)點
  // StaticTextSqlNode 節(jié)點的 text 屬性就是我們最終需要拼接的 sql 語句
  private final SqlNode contents;
	
  // contents 是我們定義在 if 標簽里面的內容， test 是 if 標簽的屬性 test 定義的內容
  public IfSqlNode(SqlNode contents, String test) {
    this.test = test;
    this.contents = contents;
    this.evaluator = new ExpressionEvaluator();
  }

  @Override
  public boolean apply(DynamicContext context) {
    // 使用評估器評估 if 標簽中定義的 test 中的內容是否為true
    if (evaluator.evaluateBoolean(test, context.getBindings())) {
      // 當contents為StaticTextSqlNode類型的節(jié)點時候，就把 if 標簽里的內容拼接到 sql 上
      // 否則繼續(xù)調用方法 apply（相當于遞歸調用，知道找到最下面的內容節(jié)點）
      contents.apply(context);
      return true;
    }
    return false;
  }

}

<if test="userIds != null and userIds.size > 0">
    and data_org_code in
    <foreach collection="dataOrgCodes" open="(" separator="," close=")" item="dataOrgCode">
         #{dataOrgCode}
    </foreach>
</if>

{
    "dataOrgCodes":["6","2"]
}

public boolean apply(DynamicContext context) {
  // 獲取參數(shù)映射存儲Map
  Map<String, Object> bindings = context.getBindings();
  // 獲取bingdings中的parameter參數(shù)，key為collectionExpression，也就是我們寫在標簽foreach 標簽的 collection 值里的內容
  // 根據(jù)collectionExpression從參數(shù)映射器中獲取到對應的值， 本次的值為：["1","2"]
  final Iterable<?> iterable = evaluator.evaluateIterable(collectionExpression, bindings,
    Optional.ofNullable(nullable).orElseGet(configuration::isNullableOnForEach));
  if (iterable == null || !iterable.iterator().hasNext()) {
    return true;
  }
  // 第一個參數(shù)
  boolean first = true;
  // 再拼接sql里添加我們定義在 foreach 標簽的 open 值里的內容
  applyOpen(context);
  // 遍歷的計數(shù)器
  int i = 0;
  // 遍歷我們傳進來的數(shù)組數(shù)據(jù) ["1","2"]
  // o 表示我們本次遍歷數(shù)組中的值，例如 ”1“
  for (Object o : iterable) {
    DynamicContext oldContext = context;
    if (first || separator == null) {
      context = new PrefixedContext(context, "");
    } else {
      context = new PrefixedContext(context, separator);
    }
    int uniqueNumber = context.getUniqueNumber();

    // 把 foreach 標簽的 index 值里的內容作為 key，計數(shù)器的值 i 作為 value 存儲到 bingdings 中。
    // 例如第一次循環(huán)就為（"index"，0）。注意：由于相同的key會被覆蓋住，所以最終存儲的為（"index"，userIds.length - 1）
    // 同時生成一個 key 為 ITEM_PREFIX + index 值內容 + "_" + uniqueNumber，value 為 uniqueNumber 存儲到 bingdings 中。
    // 例如第一次循環(huán)就為（"__frch_index_0"，0）
    applyIndex(context, i, uniqueNumber);
    
    // 把 foreach 標簽的 item 值里的內容作為 key，本次遍歷數(shù)組中的值作為 value 存儲到 bingdings 中。
    // 例如第一次循環(huán)就為（"userId"，"1"）。注意：由于相同的key會被覆蓋住，所以最終存儲的為（"index"，userIds[userIds.length - 1]）
    // 同時生成一個 key 為 ITEM_PREFIX + item 值內容 + "_" + uniqueNumber，value 為本次遍歷數(shù)組中的值存儲到 bingdings 中。
    // 例如第一次循環(huán)就為（"__frch_userId_0"，"1"）
    applyItem(context, o, uniqueNumber);
    
    contents.apply(new FilteredDynamicContext(configuration, context, index, item, uniqueNumber));
    if (first) {
      first = !((PrefixedContext) context).isPrefixApplied();
    }
    context = oldContext;
    // 計數(shù)器加一
    i++;
  }
  // foreach 遍歷完，添加 foreach 標簽定義的 close 內容
  applyClose(context);
  return true;
}

#ForEachSqlNode
private void applyIndex(DynamicContext context, Object o, int i) {
  if (index != null) {
    context.bind(index, o);
    context.bind(itemizeItem(index, i), o);
  }
}

private void applyItem(DynamicContext context, Object o, int i) {
  if (item != null) {
    context.bind(item, o);
    context.bind(itemizeItem(item, i), o);
  }
}

#DynamicContext
public void bind(String name, Object value) {
	bindings.put(name, value);
}