Java执行外部程序(Apache Commons Exec)

之前使用Runtime.getRuntime().exec调用外部程序，在Tomcat下会有当前线程一直等待的现象。当时为了解决这个问题，使用新建线程接收外部程序的输出信息，详情请看博客/article/8687189.html。

后来在网上找到开源的Java调用外部程序类库Apache Commons Exce，这个类库提供非阻塞方法调用外部程序。

官方网址 http://commons.apache.org/proper/commons-exec/
maven地址 http://mvnrepository.com/artifact/org.apache.commons/commons-exec/1.3
官方教程 http://commons.apache.org/proper/commons-exec/tutorial.html 官方教程提供的非阻塞方法在1.3版中不适用

Commons Exec对调用外部程序进行了封装，只需要少量代码即可实现外部程序调用，如执行命令"AcroRd32.exe /p /h c:\help.pdf"。

String line = "AcroRd32.exe /p /h c:\help.pdf";
CommandLine cmdLine = CommandLine.parse(line);
DefaultExecutor executor = new DefaultExecutor();

//设置命令执行退出值为1，如果命令成功执行并且没有错误，则返回1
executor.setExitValue(1);

int exitValue = executor.execute(cmdLine);

Commons Exec支持通过添加参数方式构建命令，执行命令"AcroRd32.exe /p /h c:\help.pdf"也可以按如下方法创建。

CommandLine cmdLine = new CommandLine("AcroRd32.exe");
cmdLine.addArgument("/p");
cmdLine.addArgument("/h");

Map map = new HashMap();
map.put("file", new File("c:\help.pdf"));
cmdLine.addArgument("${file}");
cmdLine.setSubstitutionMap(map);

DefaultExecutor executor = new DefaultExecutor();
executor.setExitValue(1);
int exitValue = executor.execute(cmdLine);

Commons Exec支持设置外部命令执行等待时间，如果超过等等时间则中断执行。

CommandLine cmdLine = new CommandLine("AcroRd32.exe");
cmdLine.addArgument("/p");
cmdLine.addArgument("/h");

Map map = new HashMap();
map.put("file", new File("c:\help.pdf"));
cmdLine.addArgument("${file}");
cmdLine.setSubstitutionMap(map);

DefaultExecutor executor = new DefaultExecutor();

//创建监控时间60秒，超过60秒则中端执行
ExecuteWatchdog watchdog = new ExecuteWatchdog(60*1000);
executor.setWatchdog(watchdog);

executor.setExitValue(1);
int exitValue = executor.execute(cmdLine);

上面的执行外部命令都是阻塞式，也就是在执行外部命令时，当前线程是阻塞的。如果不想在执行外部命令的时候，把当前线程阻塞，可以使用DefaultExecuteResultHandler处理外部命令执行的结果，释放当前线程。

CommandLine cmdLine = new CommandLine("AcroRd32.exe");
cmdLine.addArgument("/p");
cmdLine.addArgument("/h");

Map map = new HashMap();
map.put("file", new File("c:\help.pdf"));
cmdLine.addArgument("${file}");
cmdLine.setSubstitutionMap(map);

DefaultExecuteResultHandler resultHandler = new DefaultExecuteResultHandler();
DefaultExecutor executor = new DefaultExecutor();
executor.setExitValue(1);
executor.execute(cmdLine, resultHandler);
resultHandler.waitFor();

博客/article/8687189.html的HtmlToPdf类可以改成如下。

import java.io.File;

import org.apache.commons.exec.CommandLine;
import org.apache.commons.exec.DefaultExecuteResultHandler;
import org.apache.commons.exec.DefaultExecutor;

public class HtmlToPdf {
//wkhtmltopdf在系统中的路径
private static final String toPdfTool = "c:\\wkhtmltopdf.exe";

/**
* @param srcPath html路径，可以本地硬盘路径或者url
* @param destPath pdf保存路径
* @return 转换成功返回true
*/
public static boolean convert(String srcPath, String destPath){
File file = new File(destPath);
File parent = file.getParentFile();
//如果pdf保存路径不存在，则创建路径
if(!parent.exists()){
parent.mkdirs();
}

CommandLine cmdLine = new CommandLine(toPdfTool);
cmdLine.addArgument(srcPath, true);
cmdLine.addArgument(destPath, true);

DefaultExecutor executor = new DefaultExecutor();

//设置执行命令成功的退出值为1
executor.setExitValue(1);

//非阻塞
DefaultExecuteResultHandler resultHandler = new DefaultExecuteResultHandler();

boolean result = true;
try {
executor.execute(cmdLine, resultHandler);
resultHandler.waitFor();
} catch (Exception e) {
result = false;
e.printStackTrace();
}

return result;
}
}