com.atlassian.bamboo.plan.vcsRevision
Interface PlanVcsRevisionHistoryService

All Known Implementing Classes:

PlanVcsRevisionHistoryServiceImpl

public interface PlanVcsRevisionHistoryService

Provides access to vcs revision information of a Plan

Method Summary

void	cleanupUnusedEntriesForPlan(PlanKey planKey) Removes history entries that are not used in change detection process.
void	clearRevisionHistoryForPlan(PlanKey planKey) Removes all history entries for the plan.
PlanVcsRevisionDataSet	getLastVcsRevisionKeys(PlanKey planKey) Return the mapping between repository ids and strings representing the vcs revisions which were result of last performed change detection.
PlanVcsRevisionDataSet	getLastVcsRevisionKeysBeforeBuildNumber(PlanKey planKey, int buildNumber) Deprecated. since 3.3 we should no longer do change detection on Jobs
void	markBuildStarted(BuildContext buildContext) Saves the information on started build in the plan's vcs revision history.
void	markChangeDetectionCompleted(PlanKey planKey, int buildNumber, PlanVcsRevisionData revisionData, long repositoryId) Saves the information on change detection result in the plan's vcs revision history.

Method Detail

getLastVcsRevisionKeys

@NotNull
PlanVcsRevisionDataSet getLastVcsRevisionKeys(@NotNull
                                                      PlanKey planKey)

Return the mapping between repository ids and strings representing the vcs revisions which were result of last performed change detection. Will be empty if nothing has been built. The values are parseable by the individual repositories.

Returns:

mapping between repository id and corresponding revision key.

getLastVcsRevisionKeysBeforeBuildNumber

@NotNull
@Deprecated
PlanVcsRevisionDataSet getLastVcsRevisionKeysBeforeBuildNumber(@NotNull
                                                                                  PlanKey planKey,
                                                                                  int buildNumber)

Deprecated. since 3.3 we should no longer do change detection on Jobs

Return the mapping between repository ids and strings representing the vcs revisions which were result of last change detection performed before given build. The value is parseable by the individual repositories.

Returns:

mapping between repository id and corresponding revision key.

markChangeDetectionCompleted

void markChangeDetectionCompleted(@NotNull
                                  PlanKey planKey,
                                  int buildNumber,
                                  @NotNull
                                  PlanVcsRevisionData revisionData,
                                  long repositoryId)

Saves the information on change detection result in the plan's vcs revision history.

Parameters:

planKey -

buildNumber -

vcsRevisionKey -

markBuildStarted

void markBuildStarted(@NotNull
                      BuildContext buildContext)

Saves the information on started build in the plan's vcs revision history. Updates previousVcsRevisionKey in BuildContext

Parameters:

buildContext -

clearRevisionHistoryForPlan

void clearRevisionHistoryForPlan(@NotNull
                                 PlanKey planKey)

Removes all history entries for the plan. In effect the next build will behave similar to initial build.

Parameters:

planKey -

cleanupUnusedEntriesForPlan

void cleanupUnusedEntriesForPlan(@NotNull
                                 PlanKey planKey)

Removes history entries that are not used in change detection process.

Parameters:

planKey -