Package org.gradle.api.tasks
Class AbstractExecTask<T extends AbstractExecTask>
java.lang.Object
org.gradle.api.internal.AbstractTask
org.gradle.api.DefaultTask
org.gradle.api.internal.ConventionTask
org.gradle.api.tasks.AbstractExecTask<T>
- Type Parameters:
T- The concrete type of the class.
- All Implemented Interfaces:
Comparable<Task>,org.gradle.api.internal.DynamicObjectAware,org.gradle.api.internal.IConventionAware,org.gradle.api.internal.TaskInternal,Named,ExtensionAware,Task,BaseExecSpec,ExecSpec,ProcessForkOptions,Configurable<Task>
- Direct Known Subclasses:
Exec,RunTestExecutable
@DisableCachingByDefault(because="Abstract super-class, not to be instantiated directly")
public abstract class AbstractExecTask<T extends AbstractExecTask>
extends org.gradle.api.internal.ConventionTask
implements ExecSpec
AbstractExecTask is the base class for all exec tasks.-
Nested Class Summary
Nested classes/interfaces inherited from interface org.gradle.api.Task
Task.Namer -
Field Summary
Fields inherited from interface org.gradle.api.Task
TASK_ACTION, TASK_CONSTRUCTOR_ARGS, TASK_DEPENDS_ON, TASK_DESCRIPTION, TASK_GROUP, TASK_NAME, TASK_OVERWRITE, TASK_TYPE -
Constructor Summary
Constructors -
Method Summary
Modifier and TypeMethodDescriptionAdds arguments for the command to be executed.Adds arguments for the command to be executed.commandLine(Iterable<?> args) Sets the full command line, including the executable to be executed plus its arguments.commandLine(Object... arguments) Sets the full command line, including the executable to be executed plus its arguments.copyTo(ProcessForkOptions target) Copies these options to the given target options.environment(String name, Object value) Adds an environment variable to the environment for this process.environment(Map<String, ?> environmentVariables) Adds some environment variables to the environment for this process.protected voidexec()executable(Object executable) Sets the name of the executable to use.getArgs()Returns the arguments for the command to be executed.Argument providers for the application.Returns the full command line, including the executable plus its arguments.The environment variables to use for the process.Returns the output stream to consume standard error from the process executing the command.protected org.gradle.process.internal.ExecActionFactoryReturns the name of the executable to use.Returns the result for the command run by this task.protected ObjectFactoryReturns the standard input stream for the process executing the command.Returns the output stream to consume standard output from the process executing the command.Returns the working directory for the process.booleanTells whether a non-zero exit value is ignored, or an exception thrown.Sets the arguments for the command to be executed.Sets the arguments for the command to be executed.voidsetCommandLine(Iterable<?> args) Sets the full command line, including the executable to be executed plus its arguments.voidsetCommandLine(Object... args) Sets the full command line, including the executable to be executed plus its arguments.voidsetCommandLine(List<String> args) Sets the full command line, including the executable to be executed plus its arguments.voidsetEnvironment(Map<String, ?> environmentVariables) Sets the environment variable to use for the process.setErrorOutput(OutputStream outputStream) Sets the output stream to consume standard error from the process executing the command.voidsetExecutable(Object executable) Sets the name of the executable to use.voidsetExecutable(String executable) Sets the name of the executable to use.setIgnoreExitValue(boolean ignoreExitValue) Sets whether a non-zero exit value is ignored, or an exception thrown.setStandardInput(InputStream inputStream) Sets the standard input stream for the process executing the command.setStandardOutput(OutputStream outputStream) Sets the output stream to consume standard output from the process executing the command.voidsetWorkingDir(File dir) Sets the working directory for the process.voidsetWorkingDir(Object dir) Sets the working directory for the process.workingDir(Object dir) Sets the working directory for the process.Methods inherited from class org.gradle.api.internal.ConventionTask
conventionMapping, conventionMapping, getConventionMappingMethods inherited from class org.gradle.api.DefaultTask
compareTo, configure, dependsOn, doFirst, doFirst, doFirst, doLast, doLast, doLast, finalizedBy, getActions, getAnt, getDependsOn, getDescription, getDestroyables, getDidWork, getEnabled, getExtensions, getFinalizedBy, getGroup, getInputs, getLocalState, getLogger, getLogging, getMustRunAfter, getName, getOutputs, getPath, getProject, getShouldRunAfter, getState, getTaskDependencies, getTemporaryDir, getTimeout, hasProperty, mustRunAfter, onlyIf, onlyIf, onlyIf, property, setActions, setDependsOn, setDescription, setDidWork, setEnabled, setFinalizedBy, setGroup, setMustRunAfter, setOnlyIf, setOnlyIf, setOnlyIf, setProperty, setShouldRunAfter, shouldRunAfter, usesServiceMethods inherited from class org.gradle.api.internal.AbstractTask
acceptServiceReferences, appendParallelSafeAction, doNotTrackState, getAsDynamicObject, getConvention, getIdentityPath, getImpliesSubProjects, getLifecycleDependencies, getOnlyIf, getReasonNotToTrackState, getReasonTaskIsIncompatibleWithConfigurationCache, getRequiredServices, getServices, getSharedResources, getStandardOutputCapture, getTaskActions, getTaskIdentity, getTemporaryDirFactory, hasTaskActions, injectIntoNewInstance, isCompatibleWithConfigurationCache, isEnabled, isHasCustomActions, notCompatibleWithConfigurationCache, prependParallelSafeAction, setImpliesSubProjectsMethods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, waitMethods inherited from interface org.gradle.api.Task
doNotTrackState, getConvention, notCompatibleWithConfigurationCache
-
Constructor Details
-
AbstractExecTask
-
-
Method Details
-
getObjectFactory
-
getExecActionFactory
@Inject protected org.gradle.process.internal.ExecActionFactory getExecActionFactory() -
exec
protected void exec() -
commandLine
Sets the full command line, including the executable to be executed plus its arguments.- Specified by:
commandLinein interfaceExecSpec- Parameters:
arguments- the command plus the args to be executed- Returns:
- this
-
commandLine
Sets the full command line, including the executable to be executed plus its arguments.- Specified by:
commandLinein interfaceExecSpec- Parameters:
args- the command plus the args to be executed- Returns:
- this
-
args
Adds arguments for the command to be executed. -
args
Adds arguments for the command to be executed. -
setArgs
Sets the arguments for the command to be executed. -
setArgs
Sets the arguments for the command to be executed. -
getArgs
Returns the arguments for the command to be executed. Defaults to an empty list. -
getArgumentProviders
Argument providers for the application.- Specified by:
getArgumentProvidersin interfaceExecSpec
-
getCommandLine
Returns the full command line, including the executable plus its arguments.- Specified by:
getCommandLinein interfaceBaseExecSpec- Returns:
- The full command line, including the executable plus its arguments
-
setCommandLine
Sets the full command line, including the executable to be executed plus its arguments.- Specified by:
setCommandLinein interfaceExecSpec- Parameters:
args- the command plus the args to be executed
-
setCommandLine
Sets the full command line, including the executable to be executed plus its arguments.- Specified by:
setCommandLinein interfaceExecSpec- Parameters:
args- the command plus the args to be executed
-
setCommandLine
Sets the full command line, including the executable to be executed plus its arguments.- Specified by:
setCommandLinein interfaceExecSpec- Parameters:
args- the command plus the args to be executed
-
getExecutable
Returns the name of the executable to use.- Specified by:
getExecutablein interfaceProcessForkOptions- Returns:
- The executable.
-
setExecutable
Sets the name of the executable to use.- Specified by:
setExecutablein interfaceProcessForkOptions- Parameters:
executable- The executable. Must not be null.
-
setExecutable
Sets the name of the executable to use.- Specified by:
setExecutablein interfaceProcessForkOptions- Parameters:
executable- The executable. Must not be null.
-
executable
Sets the name of the executable to use.- Specified by:
executablein interfaceProcessForkOptions- Parameters:
executable- The executable. Must not be null.- Returns:
- this
-
getWorkingDir
Returns the working directory for the process. Defaults to the project directory.- Specified by:
getWorkingDirin interfaceProcessForkOptions- Returns:
- The working directory. Never returns null.
-
setWorkingDir
Sets the working directory for the process.- Specified by:
setWorkingDirin interfaceProcessForkOptions- Parameters:
dir- The working directory. Must not be null.
-
setWorkingDir
Sets the working directory for the process. The supplied argument is evaluated as perProject.file(Object).- Specified by:
setWorkingDirin interfaceProcessForkOptions- Parameters:
dir- The working directory. Must not be null.
-
workingDir
Sets the working directory for the process. The supplied argument is evaluated as perProject.file(Object).- Specified by:
workingDirin interfaceProcessForkOptions- Parameters:
dir- The working directory. Must not be null.- Returns:
- this
-
getEnvironment
The environment variables to use for the process. Defaults to the environment of this process.- Specified by:
getEnvironmentin interfaceProcessForkOptions- Returns:
- The environment. Returns an empty map when there are no environment variables.
-
setEnvironment
Sets the environment variable to use for the process.- Specified by:
setEnvironmentin interfaceProcessForkOptions- Parameters:
environmentVariables- The environment variables. Must not be null.
-
environment
Adds an environment variable to the environment for this process.- Specified by:
environmentin interfaceProcessForkOptions- Parameters:
name- The name of the variable.value- The value for the variable. Must not be null.- Returns:
- this
-
environment
Adds some environment variables to the environment for this process.- Specified by:
environmentin interfaceProcessForkOptions- Parameters:
environmentVariables- The environment variables. Must not be null.- Returns:
- this
-
copyTo
Copies these options to the given target options.- Specified by:
copyToin interfaceProcessForkOptions- Parameters:
target- The target options- Returns:
- this
-
setStandardInput
Sets the standard input stream for the process executing the command. The stream is closed after the process completes.- Specified by:
setStandardInputin interfaceBaseExecSpec- Parameters:
inputStream- The standard input stream for the process. Must not be null.- Returns:
- this
-
getStandardInput
Returns the standard input stream for the process executing the command. The stream is closed after the process completes. Defaults to an empty stream.- Specified by:
getStandardInputin interfaceBaseExecSpec- Returns:
- The standard input stream.
-
setStandardOutput
Sets the output stream to consume standard output from the process executing the command. The stream is closed after the process completes.- Specified by:
setStandardOutputin interfaceBaseExecSpec- Parameters:
outputStream- The standard output stream for the process. Must not be null.- Returns:
- this
-
getStandardOutput
Returns the output stream to consume standard output from the process executing the command. Defaults toSystem.out.- Specified by:
getStandardOutputin interfaceBaseExecSpec- Returns:
- The output stream
-
setErrorOutput
Sets the output stream to consume standard error from the process executing the command. The stream is closed after the process completes.- Specified by:
setErrorOutputin interfaceBaseExecSpec- Parameters:
outputStream- The standard output error stream for the process. Must not be null.- Returns:
- this
-
getErrorOutput
Returns the output stream to consume standard error from the process executing the command. Default toSystem.err.- Specified by:
getErrorOutputin interfaceBaseExecSpec- Returns:
- The error output stream.
-
setIgnoreExitValue
Sets whether a non-zero exit value is ignored, or an exception thrown.- Specified by:
setIgnoreExitValuein interfaceBaseExecSpec- Parameters:
ignoreExitValue- whether a non-zero exit value is ignored, or an exception thrown- Returns:
- this
-
isIgnoreExitValue
Tells whether a non-zero exit value is ignored, or an exception thrown. Defaults tofalse.- Specified by:
isIgnoreExitValuein interfaceBaseExecSpec- Returns:
- whether a non-zero exit value is ignored, or an exception thrown
-
getExecutionResult
Returns the result for the command run by this task. The provider has no value if this task has not been executed yet.- Returns:
- A provider of the result.
- Since:
- 6.1
-