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

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

后来在网上找到开源的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();

博客http://blog.csdn.net/accountwcx/article/details/46785437的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;
     }
 }