com.atlassian.bamboo.chains

Interface ChainResultManager

All Known Implementing Classes:

ChainResultManagerImpl

@Internal
public interface ChainResultManager

Chain specific result manager Not for use by plugin developers

Method Summary

Modifier and Type	Method and Description
ChainStateResult	create(BuildContext chainBuildContext, Map<ImmutableChainStage,Map<ImmutableJob,BuildContext>> jobBuildContexts, Collection<? extends ImmutableChainStage> stageToExecute) Creates a ChainState from Chain and BuildContext and reports any errors
void	createRepositorySpecFailedResult(ImmutableChain plan, VcsRepositoryData repositoryData, BuildChanges buildChanges, int buildNumber, VcsLocationBambooSpecsState specsState) Create and save chain result for plan which was not updated when Repository stored specs execution was failed
void	createRepositorySpecSuccessResult(ImmutableChain plan, VcsRepositoryData repositoryData, BuildChanges buildChanges, int buildNumber) Create and save chain result for plan which was updated when Repository stored specs executed
long	getAverageProgressDurationForStages(PlanIdentifier chain, Collection<ChainStageResult> stageStates, int numberOfResults) Calculates average duration of provided stages execution
ChainStateResult	updateForContinuedBuild(BuildContext chainBuildContext, Collection<BuildContext> jobBuildContexts, PlanExecutionConfig planExecutionConfig) Creates a ChainState for build already executed and stopped on manual stage of failed
ChainStateResult	updateForRerunBuild(BuildContext chainBuildContext, Map<ImmutableChainStage,Map<ImmutableJob,BuildContext>> jobBuildContexts, PlanExecutionConfig planExecutionConfig) Creates a ChainState for build already executed and being rerun.
void	updateStateToInProgress(PlanResultKey chainResultKey, Date startDate)

Method Detail

create

@NotNull
ChainStateResult create(@NotNull
                                 BuildContext chainBuildContext,
                                 @NotNull
                                 Map<ImmutableChainStage,Map<ImmutableJob,BuildContext>> jobBuildContexts,
                                 @NotNull
                                 Collection<? extends ImmutableChainStage> stageToExecute)

Creates a ChainState from Chain and BuildContext and reports any errors

Parameters:

chainBuildContext -

jobBuildContexts -

stageToExecute -

Returns:

chainResultState

updateStateToInProgress

void updateStateToInProgress(@NotNull
                             PlanResultKey chainResultKey,
                             @NotNull
                             Date startDate)

Parameters:

chainResultKey -

startDate -

updateForContinuedBuild

@NotNull
ChainStateResult updateForContinuedBuild(@NotNull
                                                  BuildContext chainBuildContext,
                                                  @NotNull
                                                  Collection<BuildContext> jobBuildContexts,
                                                  @NotNull
                                                  PlanExecutionConfig planExecutionConfig)
                                           throws IOException

Creates a ChainState for build already executed and stopped on manual stage of failed

Parameters:

chainBuildContext -

jobBuildContexts -

planExecutionConfig - - controls the continue/restart execution

Returns:

Throws:

IOException

updateForRerunBuild

@NotNull
ChainStateResult updateForRerunBuild(@NotNull
                                              BuildContext chainBuildContext,
                                              @NotNull
                                              Map<ImmutableChainStage,Map<ImmutableJob,BuildContext>> jobBuildContexts,
                                              PlanExecutionConfig planExecutionConfig)
                                       throws IOException

Creates a ChainState for build already executed and being rerun. This means all succeeding manual stages that won't be executed should have their results wiped out.

Parameters:

chainBuildContext -

jobBuildContexts -

planExecutionConfig - - controls the continue/restart execution

Returns:

Throws:

IOException

getAverageProgressDurationForStages

long getAverageProgressDurationForStages(@NotNull
                                         PlanIdentifier chain,
                                         @NotNull
                                         Collection<ChainStageResult> stageStates,
                                         int numberOfResults)

Calculates average duration of provided stages execution

Parameters:

chain -

stageStates - stages for current execution of plan included in calculation

numberOfResults - number of previous executions included in calculations

Returns:

createRepositorySpecFailedResult

void createRepositorySpecFailedResult(@NotNull
                                      ImmutableChain plan,
                                      @NotNull
                                      VcsRepositoryData repositoryData,
                                      @NotNull
                                      BuildChanges buildChanges,
                                      int buildNumber,
                                      @NotNull
                                      VcsLocationBambooSpecsState specsState)

Create and save chain result for plan which was not updated when Repository stored specs execution was failed

createRepositorySpecSuccessResult

void createRepositorySpecSuccessResult(@NotNull
                                       ImmutableChain plan,
                                       @NotNull
                                       VcsRepositoryData repositoryData,
                                       @NotNull
                                       BuildChanges buildChanges,
                                       int buildNumber)

Create and save chain result for plan which was updated when Repository stored specs executed