Gradle Copy任务from方法闭包为何可调用CopySourceSpec未声明的include等方法

问题解答 #

这个问题本质是对Gradle的DSL闭包设计和接口实现分层的误解，具体原因如下：

• 首先，CopySourceSpec只是闭包委托对象的最低约束接口，并非完整实现
  官方文档描述该闭包用于配置CopySourceSpec，只是说明这个闭包的核心作用是定义子源集，实际运行时传入闭包作为委托的是DefaultCopySourceSpec实现类，该类除了实现CopySourceSpec的from系列方法外，还实现了PatternFilterable、CopyProcessingSpec接口，include/exclude这类路径过滤方法、filter这类内容处理方法，正是定义在这两个额外实现的接口中。
• 其次，Gradle DSL闭包默认采用DELEGATE_FIRST的方法解析策略
  你在from方法后的闭包中调用的所有方法，都会优先从绑定的委托对象（也就是上述的DefaultCopySourceSpec实例）上查找匹配，所以即使CopySourceSpec接口没有定义这些方法，只要委托对象的实现类有对应方法，就可以正常调用。

// 你示例中用到的from方法闭包，实际执行逻辑等价于手动调用
def subSpec = project.copySpec {
    from 'src/main/config'
}
subSpec.include '**/*.properties'
subSpec.include '**/*.xml'
subSpec.filter(ReplaceTokens, tokens: [version: '2.3.1'])

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