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.
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.
void	revertVcsRevisionForResultNewTx(PlanResultKey planResultKey) Removes history entry corresponding to ResultsSummary identified by the key.

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 -

revertVcsRevisionForResultNewTx

void revertVcsRevisionForResultNewTx(@NotNull
                                     PlanResultKey planResultKey)

Removes history entry corresponding to ResultsSummary identified by the key. This allows the change detection to trigger another build for the same changeset. Enforces new transaction.

Parameters:

planResultKey -

cleanupUnusedEntriesForPlan

void cleanupUnusedEntriesForPlan(@NotNull
                                 PlanKey planKey)

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

Parameters:

planKey -