如何避免Jenkins共享库Groovy类中繁琐的jfile.*语法？

有两种常用方法可以避免每次调用Jenkins流水线方法都要写jfile.的繁琐：

方法一：使用Groovy的@Delegate委托注解 #

通过@Delegate注解，让Groovy自动将类中未定义的方法和属性转发给jfile对象，直接调用流水线方法即可。

修改后的Greeter.groovy代码：

package com.company

class Greeter implements Serializable {
  @Delegate
  private def jfile = null // Jenkins流水线上下文
  private String msg = "Hello world!"

  Greeter(final def jfile) {
    this.jfile = jfile
  }

  def printMsg() {
    println msg // 直接调用流水线的println方法
    sh "echo ${msg}" // 直接调用流水线的sh方法
    dir("temp") { // 直接调用流水线的dir方法
      println "Inside temp directory"
    }
  }
}

这种方式最简洁，代码侵入性最低，自动继承jfile的所有流水线方法，无需额外编写转发逻辑。

方法二：实现methodMissing动态方法转发 #

如果需要更灵活的控制（比如对某些方法添加日志、参数校验），可以实现Groovy的methodMissing方法，手动将未定义的方法转发给jfile。

修改后的Greeter.groovy代码：

package com.company

class Greeter implements Serializable {
  private def jfile = null // Jenkins流水线上下文
  private String msg = "Hello world!"

  Greeter(final def jfile) {
    this.jfile = jfile
  }

  def printMsg() {
    println msg // 直接调用println
  }

  // 动态转发未定义的方法到jfile
  def methodMissing(String methodName, def args) {
    // 检查jfile是否支持该方法
    if (jfile.metaClass.respondsTo(jfile, methodName, args)) {
      return jfile.invokeMethod(methodName, args)
    }
    // 不支持则抛出标准异常
    throw new MissingMethodException(methodName, this.getClass(), args)
  }
}

这种方式可以在转发前加入自定义逻辑，比如记录方法调用日志、参数验证等，适合需要定制化的场景。

注意事项 #

• 如果类自身定义了和流水线方法同名的方法，会优先调用类自己的方法，不会触发转发。
• 确保jfile对象是可序列化的（Jenkins流水线上下文默认支持序列化），避免流水线执行时出现序列化错误。

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