Package com.atlassian.bamboo.build

Interface ConditionalBuildDetectionAction

All Superinterfaces:

BuildDetectionAction

All Known Implementing Classes:

ChangeDetectionListenerAction, PluginTriggerBuildDetectionAction

@Internal
public interface ConditionalBuildDetectionAction
extends BuildDetectionAction

Optional BuildDetectionAction interface that indicates that the action makes a decision if the build should start.

Method Summary

Modifier and Type	Method	Description
BuildDetectionResult	createBuildContext()	Actual creation of a BuildContext.
io.atlassian.fugue.Pair<Boolean,ErrorCollection>	testIfBuildShouldStart(PlanExecutionLaunchControl.ReleaseLocksActions releaseLocksActions)	Method that should test if chain should be started.

Method Details

testIfBuildShouldStart

io.atlassian.fugue.Pair<Boolean,ErrorCollection> testIfBuildShouldStart(@NotNull
 PlanExecutionLaunchControl.ReleaseLocksActions releaseLocksActions)

Method that should test if chain should be started. It's OK for this method to take some time. Example implementation is VCS change detection. The method should not produce BuildContext (even though BuildDetectionResult has such field) but it should perform all time consuming data gathering required to do so in subsequent call to createBuildContext()

Parameters:

releaseLocksActions - actions used for releasing repositories caches locks

createBuildContext

BuildDetectionResult createBuildContext()

Actual creation of a BuildContext. Should be as fast as possible. If previous call to testIfBuildShouldStart(PlanExecutionLaunchControl.ReleaseLocksActions) decided that the build should start, this method is expected to produce BuildDetectionResult containing valid BuildContext