掌握Commons Exec，自定义外部进程执行

2023-06-08 03:25:40

Commons Exec：轻松执行外部进程

简介

在 Java 开发中，有时需要执行外部进程，例如系统命令、应用程序或脚本。Commons Exec 是一个功能强大的 Java 库，旨在简化和控制外部进程的执行。它提供了直观且灵活的 API，让您轻松启动、监视和管理进程。

安装和配置

要使用 Commons Exec，您需要将其添加到您的项目依赖中。您可以使用 Maven 或 Gradle：

<dependency>
    <groupId>commons-exec</groupId>
    <artifactId>commons-exec</artifactId>
    <version>1.3</version>
</dependency>

执行外部命令

使用 Commons Exec 执行外部命令非常简单：

创建一个 DefaultExecutor 实例：

DefaultExecutor executor = new DefaultExecutor();

设置要执行的命令：

executor.setCommand(Arrays.asList("ls", "-l"));

执行命令：

int exitCode = executor.execute();

exitCode 为 0 表示命令执行成功，非 0 表示失败。

自定义进程执行

Commons Exec 允许您高度定制进程执行行为：

executor.setWorkingDirectory(new File("/tmp"));

设置环境变量：

executor.setEnvironment(Collections.singletonMap("PATH", "/usr/local/bin:/usr/bin:/bin"));

设置输入输出流：

executor.setStreamHandler(new PumpStreamHandler(System.out, System.err));

设置超时：

executor.setWatchdog(new Watchdog(1000));

异常处理

如果进程执行失败，Commons Exec 会抛出异常。您可以使用 try-catch 块来捕获异常：

try {
    executor.execute();
} catch (ExecuteException e) {
    System.err.println("进程执行失败：" + e.getMessage());
}

进程监听器

进程监听器允许您监视进程执行并处理输出、输入和退出码：

executor.addProcessListener(new ProcessListener() {

    @Override
    public void processStarted(Process process, CommandLine commandLine) {
        System.out.println("进程已启动：" + commandLine);
    }

    @Override
    public void processCompleted(Process process, CommandLine commandLine, int exitCode) {
        System.out.println("进程已完成：" + commandLine + ", 退出码：" + exitCode);
    }

    @Override
    public void processFailed(Process process, CommandLine commandLine, ExecuteException e) {
        System.err.println("进程执行失败：" + commandLine + ", 异常：" + e.getMessage());
    }

});