// $Id:
/**
* This class can be used to execute a system command from a Java application.
* See the documentation for the public methods of this class for more
* information.
*
* Documentation for this class is available at this URL:
*
* http://devdaily.com/java/java-processbuilder-process-system-exec
*
* Copyright 2010 alvin j. alexander, devdaily.com.
*
* This program is free software: you can redistribute it and/or modify it under
* the terms of the GNU Lesser Public License as published by the Free Software
* Foundation, either version 3 of the License, or (at your option) any later
* version.
*
* This program is distributed in the hope that it will be useful, but WITHOUT
* ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS
* FOR A PARTICULAR PURPOSE. See the GNU Lesser Public License for more details.
*
* You should have received a copy of the GNU Lesser Public License along with
* this program. If not, see .
*
* Please see the following page for the LGPL license:
* http://www.gnu.org/licenses/lgpl.txt
*
*/
package org.forester.util;
import java.io.File;
import java.io.IOException;
import java.io.InputStream;
import java.io.OutputStream;
import java.util.List;
public class SystemCommandExecutor {
private final List _command_information;
private ThreadedStreamHandler _input_stream_handler;
private ThreadedStreamHandler _error_stream_handler;
private final static boolean DEBUG = false;
/**
* Pass in the system command you want to run as a List of Strings, as shown here:
*
* List commands = new ArrayList();
* commands.add("/sbin/ping");
* commands.add("-c");
* commands.add("5");
* commands.add("www.google.com");
* SystemCommandExecutor commandExecutor = new SystemCommandExecutor(commands);
* commandExecutor.executeCommand();
*
* Note: I've removed the other constructor that was here to support executing
* the sudo command. I'll add that back in when I get the sudo command
* working to the point where it won't hang when the given password is
* wrong.
*
* @param command_information The command you want to run.
*/
public SystemCommandExecutor( final List command_information ) {
if ( ( command_information == null ) || command_information.isEmpty() ) {
throw new IllegalArgumentException( "command information is required" );
}
checkCmdFile( new File( command_information.get( 0 ) ) );
_command_information = command_information;
}
public static boolean isExecuteableFile( final File path_to_cmd_f ) {
if ( !path_to_cmd_f.exists() ) {
return false;
}
else if ( path_to_cmd_f.isDirectory() ) {
return false;
}
else if ( !path_to_cmd_f.canExecute() ) {
return false;
}
return true;
}
private static void checkCmdFile( final File path_to_cmd_f ) {
if ( !path_to_cmd_f.exists() ) {
throw new IllegalArgumentException( "[" + path_to_cmd_f.getAbsolutePath() + "] does not exist" );
}
else if ( path_to_cmd_f.isDirectory() ) {
throw new IllegalArgumentException( "[" + path_to_cmd_f.getAbsolutePath() + "] is a directory" );
}
else if ( !path_to_cmd_f.canExecute() ) {
throw new IllegalArgumentException( "[" + path_to_cmd_f.getAbsolutePath() + "] is not executeable" );
}
}
public int executeCommand() throws IOException, InterruptedException {
int exit_value = -99;
try {
final ProcessBuilder pb = new ProcessBuilder( _command_information );
if ( DEBUG ) {
System.out.println( "command_information=" + _command_information );
}
final Process process = pb.start();
// you need this if you're going to write something to the command's input stream
// (such as when invoking the 'sudo' command, and it prompts you for a password).
final OutputStream stdOutput = process.getOutputStream();
// i'm currently doing these on a separate line here in case i need to set them to null
// to get the threads to stop.
// see http://java.sun.com/j2se/1.5.0/docs/guide/misc/threadPrimitiveDeprecation.html
final InputStream inputStream = process.getInputStream();
final InputStream errorStream = process.getErrorStream();
// these need to run as java threads to get the standard output and error from the command.
// the inputstream handler gets a reference to our stdOutput in case we need to write
// something to it, such as with the sudo command
_input_stream_handler = new ThreadedStreamHandler( inputStream, stdOutput );
_error_stream_handler = new ThreadedStreamHandler( errorStream );
_input_stream_handler.start();
_error_stream_handler.start();
// TODO a better way to do this?
exit_value = process.waitFor();
// TODO a better way to do this?
_input_stream_handler.interrupt();
_error_stream_handler.interrupt();
_input_stream_handler.join();
_error_stream_handler.join();
}
catch ( final IOException e ) {
throw e;
}
catch ( final InterruptedException e ) {
// generated by process.waitFor() call
throw e;
}
// finally {
return exit_value;
// }
}
/**
* Get the standard error (stderr) from the command you just exec'd.
*/
public StringBuilder getStandardErrorFromCommand() {
return _error_stream_handler.getOutputBuffer();
}
/**
* Get the standard output (stdout) from the command you just exec'd.
*/
public StringBuilder getStandardOutputFromCommand() {
return _input_stream_handler.getOutputBuffer();
}
}