com.atlassian.bamboo.plan.vcsRevision
Interface PlanVcsRevisionHistoryManager

All Known Implementing Classes:

PlanVcsRevisionHistoryManagerImpl

public interface PlanVcsRevisionHistoryManager

Method Summary

void	cleanupUnusedEntriesForPlan(PlanKey planKey) Removes history entries that are not used in change detection process.
void	clearRevisionHistoryForPlanNewTx(PlanKey planKey) Removes all history entries for the plan.
java.util.Map<java.lang.Long,PlanVcsRevisionData>	getLastVcsRevisionKeys(PlanKey planKey) Return the mapping between repository ids and strings representing the vcs revisions which were result of last performed change detection.
java.util.Map<java.lang.Long,PlanVcsRevisionData>	getLastVcsRevisionKeysBeforeBuildNumber(PlanKey planKey, int buildNumber) Return the mapping between repository ids and strings representing the vcs revisions which were result of last change detection performed before given build.
void	markBuildStartedNewTx(BuildContext buildContext) Saves the information on started build in the plan's vcs revision history.
void	markChangeDetectionCompletedNewTx(PlanKey planKey, int buildNumber, PlanVcsRevisionData vcsRevisionKey, long repositoryId) Saves the information on change detection result in the plan's vcs revision history.

Method Detail

getLastVcsRevisionKeys

@NotNull
java.util.Map<java.lang.Long,PlanVcsRevisionData> 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
java.util.Map<java.lang.Long,PlanVcsRevisionData> getLastVcsRevisionKeysBeforeBuildNumber(@NotNull
                                                                                                  PlanKey planKey,
                                                                                                  int buildNumber)

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.

markBuildStartedNewTx

void markBuildStartedNewTx(@NotNull
                           BuildContext buildContext)

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

Parameters:

buildContext -

markChangeDetectionCompletedNewTx

void markChangeDetectionCompletedNewTx(@NotNull
                                       PlanKey planKey,
                                       int buildNumber,
                                       @NotNull
                                       PlanVcsRevisionData vcsRevisionKey,
                                       long repositoryId)

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

Parameters:

planKey -

buildNumber -

vcsRevisionKey -

clearRevisionHistoryForPlanNewTx

void clearRevisionHistoryForPlanNewTx(@NotNull
                                      PlanKey planKey)

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

Parameters:

planKey -

cleanupUnusedEntriesForPlan

void cleanupUnusedEntriesForPlan(@NotNull
                                 PlanKey planKey)

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

Parameters:

planKey -