模块 jdk.compiler

接口 Plugin


public interface Plugin
javac 插件的接口。

javac 插件机制允许用户在 javac 命令行上指定一个或多个插件,以便在编译开始后立即启动。插件由用户友好的名称标识。每个启动的插件都将被传递一个字符串数组,这些字符串可用于为插件提供任何所需选项或其他参数的值。

插件通过 ServiceLoader 定位,使用与注解处理器相同的类路径(即 ANNOTATION_PROCESSOR_PATH -processorpath )。

预计典型的插件将简单地注册一个 TaskListener 以在编译执行期间通知事件,其余工作将由任务监听器完成。

自从:
1.8
  • 方法总结

    修饰符和类型
    方法
    描述
    default boolean
    返回此插件是否应自动启动,即使未在命令行选项中明确指定。
    返回此插件的用户友好名称。
    void
    init(JavacTask task, String... args)
    为给定的编译任务初始化插件。
  • 方法详情

    • getName

      String  getName()
      返回此插件的用户友好名称。
      返回:
      插件的用户友好名称
    • init

      void init(JavacTask  task, String ... args)
      为给定的编译任务初始化插件。
      参数:
      task - 刚刚开始的编译任务
      args - 插件的参数(如果有)
    • autoStart

      default boolean autoStart()
      返回此插件是否应自动启动,即使未在命令行选项中明确指定。

      该方法将由 javac 为服务加载器定位的所有插件调用。如果该方法返回 true ,如果由于显式命令行选项而未以其他方式初始化,则插件将为 initialized 并带有一个空的字符串参数数组。

      返回:
      这个插件是否应该自动启动