com.cloudbees.jenkins.plugins.customtools

Class CustomTool

java.lang.Object

hudson.model.AbstractDescribableImpl<hudson.tools.ToolInstallation>

hudson.tools.ToolInstallation

com.cloudbees.jenkins.plugins.customtools.CustomTool

All Implemented Interfaces:

hudson.ExtensionPoint, hudson.model.Describable<hudson.tools.ToolInstallation>, hudson.model.EnvironmentSpecific<CustomTool>, hudson.slaves.NodeSpecific<CustomTool>, Serializable

public class CustomTool
extends hudson.tools.ToolInstallation
implements hudson.slaves.NodeSpecific<CustomTool>, hudson.model.EnvironmentSpecific<CustomTool>

An arbitrary tool, which can add directories to the build's PATH.

Author:

rcampbell, Oleg Nenashev

See Also:

Serialized Form

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static class	CustomTool.DescriptorImpl

Nested classes/interfaces inherited from class hudson.tools.ToolInstallation

hudson.tools.ToolInstallation.ToolConverter

Nested classes/interfaces inherited from interface hudson.ExtensionPoint

hudson.ExtensionPoint.LegacyInstancesAreScopedToHudson

Constructor Summary

Constructors

Constructor and Description
CustomTool(String name, String home, List properties, String exportedPaths, LabelSpecifics[] labelSpecifics, ToolVersionConfig toolVersion, String additionalVariables)

Method Summary

Methods

Modifier and Type	Method and Description
void	check() Checks the tool consistency.
void	correctHome(PathsList pathList)
CustomTool	forBuildProperties(Map<hudson.model.JobPropertyDescriptor,hudson.model.JobProperty> properties) Deprecated.
CustomTool	forEnvironment(hudson.EnvVars environment)
CustomTool	forNode(hudson.model.Node node, hudson.model.TaskListener log)
String	getAdditionalVariables()
List<LabelSpecifics>	getAppliedSpecifics(hudson.model.Node node) Get list of label specifics, which apply to the specified node.
String	getExportedPaths()
String	getHome()
LabelSpecifics[]	getLabelSpecifics()
protected PathsList	getPaths(hudson.model.Node node) Finds the directories to add to the path, for the given node.
ToolVersionConfig	getToolVersion() Gets the tool version configuration.
boolean	hasAdditionalVariables() Check if the tool has additional environment variables set.
boolean	hasVersions()

Methods inherited from class hudson.tools.ToolInstallation

all, buildEnvVars, getName, getProperties, readResolve, translate, translate, translateFor

Methods inherited from class hudson.model.AbstractDescribableImpl

getDescriptor

Methods inherited from class java.lang.Object

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

Constructor Detail

CustomTool

@DataBoundConstructor
public CustomTool(@Nonnull
                               String name,
                               @Nonnull
                               String home,
                               @CheckForNull
                               List properties,
                               @CheckForNull
                               String exportedPaths,
                               @CheckForNull
                               LabelSpecifics[] labelSpecifics,
                               @CheckForNull
                               ToolVersionConfig toolVersion,
                               @CheckForNull
                               String additionalVariables)

Method Detail

getExportedPaths

@CheckForNull
public String getExportedPaths()

getToolVersion

@CheckForNull
public ToolVersionConfig getToolVersion()

Gets the tool version configuration.

Returns:

Tool version configuration or null if it is not configured.

hasVersions

public boolean hasVersions()

getHome

@Nonnull
public String getHome()

Overrides:

getHome in class hudson.tools.ToolInstallation

correctHome

public void correctHome(@Nonnull
               PathsList pathList)

getLabelSpecifics

@Nonnull
public LabelSpecifics[] getLabelSpecifics()

hasAdditionalVariables

public boolean hasAdditionalVariables()

Check if the tool has additional environment variables set.

Returns:

true when the tool injects additional environment variables.

getAdditionalVariables

@CheckForNull
public String getAdditionalVariables()

forEnvironment

public CustomTool forEnvironment(hudson.EnvVars environment)

Specified by:

forEnvironment in interface hudson.model.EnvironmentSpecific<CustomTool>

forNode

@Nonnull
public CustomTool forNode(hudson.model.Node node,
                         hudson.model.TaskListener log)
                   throws IOException,
                          InterruptedException

Specified by:

forNode in interface hudson.slaves.NodeSpecific<CustomTool>

Throws:

IOException

InterruptedException

forBuildProperties

@Deprecated
public CustomTool forBuildProperties(Map<hudson.model.JobPropertyDescriptor,hudson.model.JobProperty> properties)

Deprecated.

check

public void check()
           throws CustomToolException

Checks the tool consistency.

Throws:

CustomToolException - Validation error

getAppliedSpecifics

@Nonnull
public List<LabelSpecifics> getAppliedSpecifics(@Nonnull
                                               hudson.model.Node node)

Get list of label specifics, which apply to the specified node.

Parameters:

node - Node to be checked

Returns:

List of the specifics to be applied

Since:

0.3

getPaths

@Nonnull
protected PathsList getPaths(@Nonnull
                         hudson.model.Node node)
                      throws IOException,
                             InterruptedException

Finds the directories to add to the path, for the given node. Uses Ant filesets to expand the patterns in the exportedPaths field.

Parameters:

node - where the tool has been installed

Returns:

a list of directories to add to the $PATH

Throws:

IOException

InterruptedException - Operation has been interrupted