Package hudson.plugins.copyartifact

Class TriggeredBuildSelector

java.lang.Object

hudson.model.AbstractDescribableImpl<BuildSelector>

hudson.plugins.copyartifact.BuildSelector

hudson.plugins.copyartifact.TriggeredBuildSelector

All Implemented Interfaces:

ExtensionPoint, Describable<BuildSelector>

public class TriggeredBuildSelector
extends BuildSelector

Copy artifacts from the build that triggered this build.

Author:

Alan Harder

Nested Class Summary

Nested Classes

Modifier and Type	Class	Description
static class	TriggeredBuildSelector.DescriptorImpl
static class	TriggeredBuildSelector.UpstreamFilterStrategy	Which build should be used if triggered by multiple upstream builds.

Nested classes/interfaces inherited from interface hudson.ExtensionPoint

ExtensionPoint.LegacyInstancesAreScopedToHudson

Constructor Summary

Constructors

Constructor	Description
TriggeredBuildSelector()
TriggeredBuildSelector(boolean fallback)	Deprecated. Use TriggeredBuildSelector() instead.
TriggeredBuildSelector(boolean fallbackToLastSuccessful, TriggeredBuildSelector.UpstreamFilterStrategy upstreamFilterStrategy)	Deprecated. Use TriggeredBuildSelector() instead.
TriggeredBuildSelector(boolean fallbackToLastSuccessful, TriggeredBuildSelector.UpstreamFilterStrategy upstreamFilterStrategy, boolean allowUpstreamDependencies)	Deprecated. Use TriggeredBuildSelector() instead.

Method Summary

Modifier and Type	Method	Description
Run<?,?>	getBuild(Job<?,?> job, EnvVars env, BuildFilter filter, Run<?,?> parent)	Find a build to copy artifacts from.
TriggeredBuildSelector.UpstreamFilterStrategy	getUpstreamFilterStrategy()
boolean	isAllowUpstreamDependencies()
boolean	isFallbackToLastSuccessful()
protected boolean	isSelectable(Run<?,?> run, EnvVars env)	Should this build be selected? Override just this method to use a standard loop through completed builds, starting with the most recent.
boolean	isUseNewest()
void	setAllowUpstreamDependencies(boolean allowUpstreamDependencies)
void	setFallbackToLastSuccessful(boolean fallbackToLastSuccessful)
void	setUpstreamFilterStrategy(TriggeredBuildSelector.UpstreamFilterStrategy upstreamFilterStrategy)

Methods inherited from class hudson.plugins.copyartifact.BuildSelector

getArtifacts, getBuild, getSourceDirectory, isBuildResultBetterOrEqualTo

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

TriggeredBuildSelector

@DataBoundConstructor
public TriggeredBuildSelector()

TriggeredBuildSelector

@Deprecated
public TriggeredBuildSelector(boolean fallbackToLastSuccessful,
                              TriggeredBuildSelector.UpstreamFilterStrategy upstreamFilterStrategy,
                              boolean allowUpstreamDependencies)

Deprecated.

Use TriggeredBuildSelector() instead.

Parameters:

fallbackToLastSuccessful - true to fallback to the last successful build when no appropriate build is found.

upstreamFilterStrategy - strategy to pick the most appropriate upstream build.

allowUpstreamDependencies - true to scan upstream builds also using relation provided by fingerprints.

TriggeredBuildSelector

@Deprecated
public TriggeredBuildSelector(boolean fallbackToLastSuccessful,
                              TriggeredBuildSelector.UpstreamFilterStrategy upstreamFilterStrategy)

Deprecated.

Use TriggeredBuildSelector() instead.

Parameters:

fallbackToLastSuccessful - true to fallback to the last successful build when no appropriate build is found.

upstreamFilterStrategy - strategy to pick the most appropriate upstream build.

TriggeredBuildSelector

@Deprecated
public TriggeredBuildSelector(boolean fallback)

Deprecated.

Use TriggeredBuildSelector() instead.

Parameters:

fallback - true to fallback to the last successful build when no appropriate build is found.

Method Detail

isFallbackToLastSuccessful

public boolean isFallbackToLastSuccessful()

setFallbackToLastSuccessful

@DataBoundSetter
public void setFallbackToLastSuccessful(boolean fallbackToLastSuccessful)

Parameters:

fallbackToLastSuccessful - true to fallback to the last successful build when no appropriate build is found.

getUpstreamFilterStrategy

public TriggeredBuildSelector.UpstreamFilterStrategy getUpstreamFilterStrategy()

Returns:

Which build should be used if triggered by multiple upstream builds.

setUpstreamFilterStrategy

@DataBoundSetter
public void setUpstreamFilterStrategy(TriggeredBuildSelector.UpstreamFilterStrategy upstreamFilterStrategy)

Parameters:

upstreamFilterStrategy - strategy to pick the most appropriate upstream build.

isUseNewest

public boolean isUseNewest()

Returns:

whether to use the newest upstream or not (use the oldest) when there are multiple upstreams.

isAllowUpstreamDependencies

public boolean isAllowUpstreamDependencies()

setAllowUpstreamDependencies

@DataBoundSetter
public void setAllowUpstreamDependencies(boolean allowUpstreamDependencies)

Parameters:

allowUpstreamDependencies - true to scan upstream builds also using relation provided by fingerprints.

getBuild

public Run<?,?> getBuild(Job<?,?> job,
                               EnvVars env,
                               BuildFilter filter,
                               Run<?,?> parent)

Description copied from class: BuildSelector

Find a build to copy artifacts from.

Overrides:

getBuild in class BuildSelector

Parameters:

job - Source project

env - Environment for build that is copying artifacts

filter - Additional filter; returned result should return true (return null otherwise)

parent - Build to which artifacts are being copied

Returns:

Build to use, or null if no appropriate build was found

isSelectable

protected boolean isSelectable(Run<?,?> run,
                               EnvVars env)

Description copied from class: BuildSelector

Should this build be selected? Override just this method to use a standard loop through completed builds, starting with the most recent.

Overrides:

isSelectable in class BuildSelector

Parameters:

run - Build to check

env - Environment for build that is copying artifacts

Returns:

True to select this build