hudson.tasks

Class CommandInterpreter

java.lang.Object

hudson.tasks.BuildStepCompatibilityLayer

hudson.tasks.Builder

hudson.tasks.CommandInterpreter

All Implemented Interfaces:

ExtensionPoint, Describable<Builder>, BuildStep

Direct Known Subclasses:

BatchFile, Shell

public abstract class CommandInterpreter
extends Builder

Common part between Shell and BatchFile.

Author:

Kohsuke Kawaguchi

Nested Class Summary

Nested classes/interfaces inherited from interface hudson.ExtensionPoint

ExtensionPoint.LegacyInstancesAreScopedToHudson

Nested classes/interfaces inherited from interface hudson.tasks.BuildStep

BuildStep.PublisherList

Field Summary

Fields

Modifier and Type	Field and Description
protected String	command Command to execute.

Fields inherited from interface hudson.tasks.BuildStep

BUILDERS, PUBLISHERS

Constructor Summary

Constructors

Constructor and Description
CommandInterpreter(String command)

Method Summary

Modifier and Type	Method and Description
abstract String[]	buildCommandLine(FilePath script)
FilePath	createScriptFile(FilePath dir) Creates a script file in a temporary name in the specified directory.
String	getCommand()
protected abstract String	getContents()
protected abstract String	getFileExtension()
protected int	join(Proc p) Reports the exit code from the process.
boolean	perform(AbstractBuild<?,?> build, Launcher launcher, BuildListener listener) Runs the step over the given build and reports the progress to the listener.
boolean	perform(AbstractBuild<?,?> build, Launcher launcher, TaskListener listener)

Methods inherited from class hudson.tasks.Builder

all, getDescriptor, getRequiredMonitorService, prebuild

Methods inherited from class hudson.tasks.BuildStepCompatibilityLayer

getProjectAction, getProjectAction, getProjectActions, perform, prebuild

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Field Detail

command

protected final String command

Command to execute. The format depends on the actual CommandInterpreter implementation.

Constructor Detail

CommandInterpreter

public CommandInterpreter(String command)

Method Detail

getCommand

public final String getCommand()

perform

public boolean perform(AbstractBuild<?,?> build,
                       Launcher launcher,
                       BuildListener listener)
                throws InterruptedException

Description copied from class: BuildStepCompatibilityLayer

Runs the step over the given build and reports the progress to the listener.

A plugin can contribute the action object to Actionable.getActions() so that a 'report' becomes a part of the persisted data of Build. This is how JUnit plugin attaches the test report to a build page, for example.

When this build step needs to make (direct or indirect) permission checks to ACL (for example, to locate other projects by name, build them, or access their artifacts) then it must be run under a specific Authentication. In such a case, the implementation should check whether Jenkins#getAuthentication is ACL.SYSTEM, and if so, replace it for the duration of this step with Jenkins#ANONYMOUS. (Either using ACL.impersonate(org.acegisecurity.Authentication), or by making explicit calls to ACL.hasPermission(Authentication, Permission).) This would typically happen when no QueueItemAuthenticator was available, configured, and active.

Specified by:

perform in interface BuildStep

Overrides:

perform in class BuildStepCompatibilityLayer

Returns:

Delegates to SimpleBuildStep.perform(Run, FilePath, Launcher, TaskListener) if possible, always returning true or throwing an error.

Throws:

InterruptedException - If the build is interrupted by the user (in an attempt to abort the build.) Normally the BuildStep implementations may simply forward the exception it got from its lower-level functions.

perform

public boolean perform(AbstractBuild<?,?> build,
                       Launcher launcher,
                       TaskListener listener)
                throws InterruptedException

Throws:

InterruptedException

join

protected int join(Proc p)
            throws IOException,
                   InterruptedException

Reports the exit code from the process. This allows subtypes to treat the exit code differently (for example by treating non-zero exit code as if it's zero, or to set the status to Result#UNSTABLE). Any non-zero exit code will cause the build step to fail.

Throws:

IOException

InterruptedException

Since:

1.549

createScriptFile

public FilePath createScriptFile(@Nonnull
                                 FilePath dir)
                          throws IOException,
                                 InterruptedException

Creates a script file in a temporary name in the specified directory.

Throws:

IOException

InterruptedException

buildCommandLine

public abstract String[] buildCommandLine(FilePath script)

getContents

protected abstract String getContents()

getFileExtension

protected abstract String getFileExtension()