Groovy Sql.withBatch的addBatch(Map)工作原理及Java/Kotlin调用方法

问题背景 #

在Java/Kotlin等静态类型语言中调用groovy.sql.Sql.withBatch时，已成功通过List参数调用回调对象的addBatch方法适配带占位符的SQL，但Groovy文档标注支持Map参数实现批量更新，实际查看BatchingPreparedStatementWrapper类仅提供addBatch(Object[])、addBatch(List)、addBatch(String)重载方法，无addBatch(Map)方法，因此有以下两个疑问：

1. 如何在Java/Kotlin中使用Map参数调用Sql.withBatch？ #

由于Java/Kotlin是静态类型语言，无法直接调用Groovy动态扩展的方法，可通过两种方式实现：

• 方式一：利用GroovyObject的动态方法调用
  将BatchingPreparedStatementWrapper实例强转为GroovyObject，通过invokeMethod触发动态方法调用，传入方法名"addBatch"和Map参数。
  Java示例代码：

  import groovy.lang.GroovyObject;
  import groovy.sql.BatchingPreparedStatementWrapper;
  import groovy.sql.Sql;
  import java.util.HashMap;
  import java.util.Map;
  
  // 初始化Sql实例...
  sql.withBatch("INSERT INTO users (name, age) VALUES (:name, :age)", (BatchingPreparedStatementWrapper ps) -> {
      GroovyObject groovyPs = (GroovyObject) ps;
      
      Map<String, Object> user1 = new HashMap<>();
      user1.put("name", "Alice");
      user1.put("age", 30);
      groovyPs.invokeMethod("addBatch", user1);
  
      Map<String, Object> user2 = new HashMap<>();
      user2.put("name", "Bob");
      user2.put("age", 25);
      groovyPs.invokeMethod("addBatch", user2);
  });
  

  Kotlin版本逻辑一致，仅语法调整：

  import groovy.lang.GroovyObject
  import groovy.sql.BatchingPreparedStatementWrapper
  import groovy.sql.Sql
  
  // 初始化Sql实例...
  sql.withBatch("INSERT INTO users (name, age) VALUES (:name, :age)") { ps ->
      val groovyPs = ps as GroovyObject
      
      val user1 = mapOf("name" to "Alice", "age" to 30)
      groovyPs.invokeMethod("addBatch", user1)
  
      val user2 = mapOf("name" to "Bob", "age" to 25)
      groovyPs.invokeMethod("addBatch", user2)
  }
  

• 方式二：手动转换Map为有序参数列表/数组
  按SQL中命名占位符的顺序，从Map中提取对应的值，组成List或Object数组，调用已有的addBatch(List)或addBatch(Object[])方法。比如SQL为VALUES (:name, :age)，则按name、age的顺序提取值：

  sql.withBatch("INSERT INTO users (name, age) VALUES (:name, :age)", (BatchingPreparedStatementWrapper ps) -> {
      Map<String, Object> user = new HashMap<>();
      user.put("name", "Alice");
      user.put("age", 30);
      // 按占位符顺序组装参数
      ps.addBatch(List.of(user.get("name"), user.get("age")));
  });
  

2. Groovy中调用addBatch(Map)为何不会抛出方法不存在的异常？ #

这是Groovy动态语言特性带来的效果：

• Groovy提供**方法缺失拦截（Method Missing）**机制，当调用一个类中未定义的方法时，会自动触发methodMissing方法进行处理。
• BatchingPreparedStatementWrapper所属的Groovy SQL模块，通过该机制实现了对addBatch(Map)的支持：底层会将Map的键与SQL中的命名占位符匹配，自动按顺序转换为PreparedStatement所需的参数数组，最终调用已有的addBatch(Object[])方法完成批量添加。
• 这种动态扩展的方法仅在Groovy运行时可见，不会体现在静态类的方法签名中，因此Java/Kotlin等静态类型语言无法直接调用。

内容的提问来源于stack exchange，提问作者Frank Neblung