理解Maven的运行模式
maven在执行构建时，可以运行在两种主要模式下：交互式模式（interactive mode）和批处理模式（batch mode）。
- 交互式模式（默认）：Maven在需要用户输入时会暂停并等待，例如当插件需要用户确认某些操作时。
- 批处理模式（-B 或 --batch-mode）：当命令行中指定了-B或--batch-mode参数时，Maven会进入批处理模式。在这种模式下，Maven会尝试避免任何需要用户交互的操作，通常会采用默认值或直接失败，这对于自动化构建、持续集成/持续部署（CI/CD）环境至关重要。
对于Maven插件开发者而言，了解当前Mojo运行在哪种模式下，可以帮助插件在不同环境下提供更智能、更适应性的行为。例如，在交互模式下可以提示用户进行确认，而在批处理模式下则直接执行默认操作或记录警告。
注入MavenSession对象
要在Mojo中获取Maven的当前会话信息，需要通过@Parameter注解注入MavenSession对象。MavenSession包含了当前Maven构建的所有运行时上下文信息，包括命令行请求、项目列表、插件上下文等。
以下是在Mojo中声明并注入MavenSession的示例代码：
import org.apache.maven.execution.MavenSession;
import org.apache.maven.plugins.annotations.Parameter;
import org.apache.maven.plugin.AbstractMojo;
import org.apache.maven.plugin.MojoExecutionException;
import org.apache.maven.plugins.annotations.Mojo;
@Mojo(name = "check-mode")
public class ModeCheckMojo extends AbstractMojo {
/**
* The current Maven session.
*/
@Parameter(defaultValue = "${session}", required = true, readonly = true)
private MavenSession session;
@Override
public void execute() throws MojoExecutionException {
// Mojo的执行逻辑
}
}@Parameter注解的解释：
- defaultValue = "${session}": 这告诉Maven，当插件被执行时，将当前的MavenSession对象注入到session字段中。${session}是一个内置的Maven表达式，指向当前的MavenSession实例。
- required = true: 表示此参数是必需的。如果无法注入MavenSession，Mojo将无法执行。
- readonly = true: 表示此参数是只读的，插件不应修改它。
判断是否处于批处理模式
一旦MavenSession对象被成功注入，就可以通过session.getRequest().isInteractiveMode()方法来判断Maven的运行模式。
- 如果isInteractiveMode()返回true，则表示Maven当前处于交互式模式。
- 如果isInteractiveMode()返回false，则表示Maven当前处于非交互式模式，即批处理模式。
以下是完整的Mojo示例，演示如何根据运行模式调整行为：
import org.apache.maven.execution.MavenSession;
import org.apache.maven.plugins.annotations.Parameter;
import org.apache.maven.plugin.AbstractMojo;
import org.apache.maven.plugin.MojoExecutionException;
import org.apache.maven.plugins.annotations.Mojo;
import org.apache.maven.plugins.annotations.LifecyclePhase;
@Mojo(name = "check-mode", defaultPhase = LifecyclePhase.VALIDATE)
public class ModeCheckMojo extends AbstractMojo {
/**
* The current Maven session.
*/
@Parameter(defaultValue = "${session}", required = true, readonly = true)
private MavenSession session;
@Override
public void execute() throws MojoExecutionException {
getLog().info("Executing ModeCheckMojo...");
if (session.getRequest().isInteractiveMode()) {
getLog().info("Maven is running in INTERACTIVE mode.");
// 在交互模式下执行特定逻辑，例如提示用户输入
// getLog().info("Please confirm operation (Y/N):");
// ... (此处通常不直接进行控制台输入，而是通过插件配置或提供默认值)
} else {
getLog().info("Maven is running in BATCH mode (non-interactive).");
// 在批处理模式下执行特定逻辑，例如使用默认值或跳过需要交互的操作
// getLog().info("Skipping interactive prompt and proceeding with default settings.");
}
getLog().info("ModeCheckMojo execution finished.");
}
}如何测试：
- 交互模式： 在项目根目录下执行：mvn check-mode 输出应包含：Maven is running in INTERACTIVE mode.
- 批处理模式： 在项目根目录下执行：mvn check-mode -B 或 mvn check-mode --batch-mode 输出应包含：Maven is running in BATCH mode (non-interactive).
注意事项
- isInteractiveMode()的语义：请记住，isInteractiveMode()返回true表示交互式，返回false表示批处理（非交互式）。
- Mojo的生命周期：确保你的Mojo在适当的Maven生命周期阶段执行，以便能够获取到正确的MavenSession信息。
- 错误处理：虽然@Parameter(required = true)会确保session对象被注入，但在极端情况下，仍然建议进行空值检查（尽管对于${session}通常不是必需的）。
- 插件配置：对于需要在两种模式下有不同行为的插件，除了依赖isInteractiveMode()，也可以考虑引入插件配置参数，允许用户显式控制行为。
总结
通过注入MavenSession并利用session.getRequest().isInteractiveMode()方法，Maven插件可以可靠地判断当前Maven构建是否在批处理模式下运行。这一机制为插件提供了强大的能力，使其能够根据不同的运行环境（如开发者的本地环境或CI/CD流水线）调整其行为，从而提高插件的健壮性和用户体验。在设计需要用户交互或有不同自动化策略的Maven插件时，理解并应用这一技术是至关重要的。
