/* * Copyright (C) 2010 Mathieu Baudier * * Licensed under the Apache License, Version 2.0 (the "License"); * you may not use this file except in compliance with the License. * You may obtain a copy of the License at * * http://www.apache.org/licenses/LICENSE-2.0 * * Unless required by applicable law or agreed to in writing, software * distributed under the License is distributed on an "AS IS" BASIS, * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. * See the License for the specific language governing permissions and * limitations under the License. */ package org.argeo.slc.core.execution.tasks; import java.io.File; import java.io.FileOutputStream; import java.io.FileWriter; import java.io.IOException; import java.io.InputStream; import java.io.OutputStream; import java.io.PipedInputStream; import java.io.PipedOutputStream; import java.io.Writer; import java.util.ArrayList; import java.util.Collections; import java.util.HashMap; import java.util.List; import java.util.Map; import org.apache.commons.exec.CommandLine; import org.apache.commons.exec.DefaultExecutor; import org.apache.commons.exec.ExecuteException; import org.apache.commons.exec.ExecuteResultHandler; import org.apache.commons.exec.ExecuteStreamHandler; import org.apache.commons.exec.ExecuteWatchdog; import org.apache.commons.exec.Executor; import org.apache.commons.exec.LogOutputStream; import org.apache.commons.exec.PumpStreamHandler; import org.apache.commons.exec.ShutdownHookProcessDestroyer; import org.apache.commons.io.FileUtils; import org.apache.commons.io.IOUtils; import org.apache.commons.logging.Log; import org.apache.commons.logging.LogFactory; import org.argeo.slc.SlcException; import org.argeo.slc.UnsupportedException; import org.argeo.slc.core.execution.ExecutionResources; import org.argeo.slc.core.test.SimpleResultPart; import org.argeo.slc.test.TestResult; import org.argeo.slc.test.TestStatus; import org.springframework.core.io.Resource; /** Execute an OS specific system call. */ public class SystemCall implements Runnable { public final static String LOG_STDOUT = "System.out"; private final Log log = LogFactory.getLog(getClass()); private String execDir; private String cmd = null; private List command = null; private Executor executor = new DefaultExecutor(); private Boolean synchronous = true; private String stdErrLogLevel = "ERROR"; private String stdOutLogLevel = "INFO"; private Resource stdOutFile = null; private Resource stdErrFile = null; private Resource stdInFile = null; /** * If no {@link #stdInFile} provided, writing to this stream will write to * the stdin of the process. */ private OutputStream stdInSink = null; private Boolean redirectStdOut = false; private List outputListeners = Collections .synchronizedList(new ArrayList()); private Map> osCommands = new HashMap>(); private Map osCmds = new HashMap(); private Map environmentVariables = new HashMap(); private Boolean logCommand = false; private Boolean redirectStreams = true; private Boolean exceptionOnFailed = true; private Boolean mergeEnvironmentVariables = true; private String osConsole = null; private String generateScript = null; /** 24 hours */ private Long watchdogTimeout = 24 * 60 * 60 * 1000l; private TestResult testResult; private ExecutionResources executionResources; /** Empty constructor */ public SystemCall() { } /** * Constructor based on the provided command list. * * @param command * the command list */ public SystemCall(List command) { this.command = command; } /** * Constructor based on the provided command. * * @param cmd * the command. If the provided string contains no space a * command list is initialized with the argument as first * component (useful for chained construction) */ public SystemCall(String cmd) { if (cmd.indexOf(' ') < 0) { command = new ArrayList(); command.add(cmd); } else { this.cmd = cmd; } } /** Executes the system call. */ public void run() { // Manage streams Writer stdOutWriter = null; OutputStream stdOutputStream = null; Writer stdErrWriter = null; InputStream stdInStream = null; if (stdOutFile != null) if (redirectStdOut) stdOutputStream = createOutputStream(stdOutFile); else stdOutWriter = createWriter(stdOutFile, true); if (stdErrFile != null) { stdErrWriter = createWriter(stdErrFile, true); } else { if (stdOutFile != null && !redirectStdOut) stdErrWriter = createWriter(stdOutFile, true); } try { if (stdInFile != null) stdInStream = stdInFile.getInputStream(); else { stdInStream = new PipedInputStream(); stdInSink = new PipedOutputStream( (PipedInputStream) stdInStream); } } catch (IOException e2) { throw new SlcException("Cannot open a stream for " + stdInFile, e2); } if (log.isTraceEnabled()) { log.debug("os.name=" + System.getProperty("os.name")); log.debug("os.arch=" + System.getProperty("os.arch")); log.debug("os.version=" + System.getProperty("os.version")); } // Execution directory File dir = new File(getExecDirToUse()); // if (!dir.exists()) // dir.mkdirs(); // Watchdog to check for lost processes Executor executorToUse; if (executor != null) executorToUse = executor; else executorToUse = new DefaultExecutor(); executorToUse.setWatchdog(new ExecuteWatchdog(watchdogTimeout)); if (redirectStreams) { // Redirect standard streams executorToUse.setStreamHandler(createExecuteStreamHandler( stdOutWriter, stdOutputStream, stdErrWriter, stdInStream)); } else { // Dummy stream handler (otherwise pump is used) executorToUse.setStreamHandler(new DummyexecuteStreamHandler()); } executorToUse.setProcessDestroyer(new ShutdownHookProcessDestroyer()); executorToUse.setWorkingDirectory(dir); // Command line to use final CommandLine commandLine = createCommandLine(); if (logCommand) log.info("Execute command:\n" + commandLine + "\n in working directory: \n" + dir + "\n"); // Env variables Map environmentVariablesToUse = null; environmentVariablesToUse = new HashMap(); if (mergeEnvironmentVariables) environmentVariablesToUse.putAll(System.getenv()); if (environmentVariables.size() > 0) environmentVariablesToUse.putAll(environmentVariables); // Execute ExecuteResultHandler executeResultHandler = createExecuteResultHandler(commandLine); // // THE EXECUTION PROPER // try { if (synchronous) try { int exitValue = executorToUse.execute(commandLine, environmentVariablesToUse); executeResultHandler.onProcessComplete(exitValue); } catch (ExecuteException e1) { if (e1.getExitValue() == Executor.INVALID_EXITVALUE) { Thread.currentThread().interrupt(); return; } executeResultHandler.onProcessFailed(e1); } else executorToUse.execute(commandLine, environmentVariablesToUse, executeResultHandler); } catch (SlcException e) { throw e; } catch (Exception e) { throw new SlcException("Could not execute command " + commandLine, e); } finally { IOUtils.closeQuietly(stdOutWriter); IOUtils.closeQuietly(stdErrWriter); IOUtils.closeQuietly(stdInStream); IOUtils.closeQuietly(stdInSink); } } public synchronized String function() { final StringBuffer buf = new StringBuffer(""); SystemCallOutputListener tempOutputListener = new SystemCallOutputListener() { public void newLine(SystemCall systemCall, String line, Boolean isError) { if (!isError) buf.append(line); } }; addOutputListener(tempOutputListener); run(); removeOutputListener(tempOutputListener); return buf.toString(); } public String asCommand() { return createCommandLine().toString(); } @Override public String toString() { return asCommand(); } /** * Build a command line based on the properties. Can be overridden by * specific command wrappers. */ protected CommandLine createCommandLine() { // Check if an OS specific command overrides String osName = System.getProperty("os.name"); List commandToUse = null; if (osCommands.containsKey(osName)) commandToUse = osCommands.get(osName); else commandToUse = command; String cmdToUse = null; if (osCmds.containsKey(osName)) cmdToUse = osCmds.get(osName); else cmdToUse = cmd; CommandLine commandLine = null; // Which command definition to use if (commandToUse == null && cmdToUse == null) throw new SlcException("Please specify a command."); else if (commandToUse != null && cmdToUse != null) throw new SlcException( "Specify the command either as a line or as a list."); else if (cmdToUse != null) { commandLine = CommandLine.parse(cmdToUse); } else if (commandToUse != null) { if (commandToUse.size() == 0) throw new SlcException("Command line is empty."); commandLine = new CommandLine(commandToUse.get(0).toString()); for (int i = 1; i < commandToUse.size(); i++) { if (log.isTraceEnabled()) log.debug(commandToUse.get(i)); commandLine.addArgument(commandToUse.get(i).toString()); } } else { // all cases covered previously throw new UnsupportedException(); } if (generateScript != null) { File scriptFile = new File(getExecDirToUse() + File.separator + generateScript); try { FileUtils.writeStringToFile(scriptFile, (osConsole != null ? osConsole + " " : "") + commandLine.toString()); } catch (IOException e) { throw new SlcException("Could not generate script " + scriptFile, e); } commandLine = new CommandLine(scriptFile); } else { if (osConsole != null) commandLine = CommandLine.parse(osConsole + " " + commandLine.toString()); } return commandLine; } /** * Creates a {@link PumpStreamHandler} which redirects streams to the custom * logging mechanism. */ protected ExecuteStreamHandler createExecuteStreamHandler( final Writer stdOutWriter, final OutputStream stdOutputStream, final Writer stdErrWriter, final InputStream stdInStream) { // Log writers PumpStreamHandler pumpStreamHandler = new PumpStreamHandler( stdOutputStream != null ? stdOutputStream : new LogOutputStream() { protected void processLine(String line, int level) { if (line != null && !line.trim().equals("")) logStdOut(line); if (stdOutWriter != null) appendLineToFile(stdOutWriter, line); } }, new LogOutputStream() { protected void processLine(String line, int level) { if (line != null && !line.trim().equals("")) logStdErr(line); if (stdErrWriter != null) appendLineToFile(stdErrWriter, line); } }, stdInStream) { @Override public void stop() { // prevents the method to block when joining stdin if (stdInSink != null) IOUtils.closeQuietly(stdInSink); super.stop(); } }; return pumpStreamHandler; } /** Creates the default {@link ExecuteResultHandler}. */ protected ExecuteResultHandler createExecuteResultHandler( final CommandLine commandLine) { return new ExecuteResultHandler() { public void onProcessComplete(int exitValue) { String msg = "System call '" + commandLine + "' properly completed."; if (log.isTraceEnabled()) log.trace(msg); if (testResult != null) { forwardPath(testResult); testResult.addResultPart(new SimpleResultPart( TestStatus.PASSED, msg)); } } public void onProcessFailed(ExecuteException e) { String msg = "System call '" + commandLine + "' failed."; if (testResult != null) { forwardPath(testResult); testResult.addResultPart(new SimpleResultPart( TestStatus.ERROR, msg, e)); } else { if (exceptionOnFailed) throw new SlcException(msg, e); else log.error(msg, e); } } }; } protected void forwardPath(TestResult testResult) { // TODO: allocate a TreeSPath } /** * Shortcut method getting the execDir to use */ protected String getExecDirToUse() { try { File dir = null; if (execDir != null) { return execDir; // Replace '/' by local file separator, for portability // execDir.replace('/', File.separatorChar); // dir = new File(execDir).getCanonicalFile(); // dir = execDir.; } if (dir == null) return System.getProperty("user.dir"); else return dir.getPath(); } catch (Exception e) { throw new SlcException("Cannot find exec dir", e); } } protected void logStdOut(String line) { for (SystemCallOutputListener outputListener : outputListeners) outputListener.newLine(this, line, false); log(stdOutLogLevel, line); } protected void logStdErr(String line) { for (SystemCallOutputListener outputListener : outputListeners) outputListener.newLine(this, line, true); log(stdErrLogLevel, line); } /** Log from the underlying streams. */ protected void log(String logLevel, String line) { if ("ERROR".equals(logLevel)) log.error(line); else if ("WARN".equals(logLevel)) log.warn(line); else if ("INFO".equals(logLevel)) log.info(line); else if ("DEBUG".equals(logLevel)) log.debug(line); else if ("TRACE".equals(logLevel)) log.trace(line); else if (LOG_STDOUT.equals(logLevel)) System.out.println(line); else if ("System.err".equals(logLevel)) System.err.println(line); else throw new SlcException("Unknown log level " + logLevel); } /** Append line to a log file. */ protected void appendLineToFile(Writer writer, String line) { try { writer.append(line).append('\n'); } catch (IOException e) { log.error("Cannot write to log file", e); } } /** Creates the writer for the output/err files. */ protected Writer createWriter(Resource target, Boolean append) { FileWriter writer = null; try { final File file; if (executionResources != null) file = new File(executionResources.getAsOsPath(target, true)); else file = target.getFile(); writer = new FileWriter(file, append); } catch (IOException e) { log.error("Cannot get file for " + target, e); IOUtils.closeQuietly(writer); } return writer; } /** Creates an outputstream for the output/err files. */ protected OutputStream createOutputStream(Resource target) { FileOutputStream out = null; try { final File file; if (executionResources != null) file = new File(executionResources.getAsOsPath(target, true)); else file = target.getFile(); out = new FileOutputStream(file, false); } catch (IOException e) { log.error("Cannot get file for " + target, e); IOUtils.closeQuietly(out); } return out; } /** Append the argument (for chaining) */ public SystemCall arg(String arg) { if (command == null) command = new ArrayList(); command.add(arg); return this; } /** Append the argument (for chaining) */ public SystemCall arg(String arg, String value) { if (command == null) command = new ArrayList(); command.add(arg); command.add(value); return this; } /** */ public void setCmd(String command) { this.cmd = command; } public void setCommand(List command) { this.command = command; } public void setExecDir(String execdir) { this.execDir = execdir; } public void setStdErrLogLevel(String stdErrLogLevel) { this.stdErrLogLevel = stdErrLogLevel; } public void setStdOutLogLevel(String stdOutLogLevel) { this.stdOutLogLevel = stdOutLogLevel; } public void setSynchronous(Boolean synchronous) { this.synchronous = synchronous; } public void setOsCommands(Map> osCommands) { this.osCommands = osCommands; } public void setOsCmds(Map osCmds) { this.osCmds = osCmds; } public void setEnvironmentVariables(Map environmentVariables) { this.environmentVariables = environmentVariables; } public void setWatchdogTimeout(Long watchdogTimeout) { this.watchdogTimeout = watchdogTimeout; } public void setStdOutFile(Resource stdOutFile) { this.stdOutFile = stdOutFile; } public void setStdErrFile(Resource stdErrFile) { this.stdErrFile = stdErrFile; } public void setStdInFile(Resource stdInFile) { this.stdInFile = stdInFile; } public void setTestResult(TestResult testResult) { this.testResult = testResult; } public void setLogCommand(Boolean logCommand) { this.logCommand = logCommand; } public void setRedirectStreams(Boolean redirectStreams) { this.redirectStreams = redirectStreams; } public void setExceptionOnFailed(Boolean exceptionOnFailed) { this.exceptionOnFailed = exceptionOnFailed; } public void setMergeEnvironmentVariables(Boolean mergeEnvironmentVariables) { this.mergeEnvironmentVariables = mergeEnvironmentVariables; } public void setOsConsole(String osConsole) { this.osConsole = osConsole; } public void setGenerateScript(String generateScript) { this.generateScript = generateScript; } public void setExecutionResources(ExecutionResources executionResources) { this.executionResources = executionResources; } public void setRedirectStdOut(Boolean redirectStdOut) { this.redirectStdOut = redirectStdOut; } public void addOutputListener(SystemCallOutputListener outputListener) { outputListeners.add(outputListener); } public void removeOutputListener(SystemCallOutputListener outputListener) { outputListeners.remove(outputListener); } public void setOutputListeners( List outputListeners) { this.outputListeners = outputListeners; } public void setExecutor(Executor executor) { this.executor = executor; } private class DummyexecuteStreamHandler implements ExecuteStreamHandler { public void setProcessErrorStream(InputStream is) throws IOException { } public void setProcessInputStream(OutputStream os) throws IOException { } public void setProcessOutputStream(InputStream is) throws IOException { } public void start() throws IOException { } public void stop() { } } }