com.atlassian.bamboo.plan.vcsRevision

Interface PlanVcsRevisionHistoryManager

All Known Implementing Classes:

PlanVcsRevisionHistoryManagerImpl

@Internal
public interface PlanVcsRevisionHistoryManager

Method Summary

Modifier and Type	Method and Description
void	cleanupUnusedEntriesForPlan(@NotNull PlanKey planKey) Removes history entries that are not used in change detection process.
void	clearRevisionHistoryForPlanNewTx(@NotNull PlanKey planKey) Removes all history entries for the plan.
@NotNull Map<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.
@NotNull Map<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.
void	markBuildStartedNewTx(@NotNull BuildContext buildContext) Saves the information on started build in the plan's vcs revision history.
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.
void	moveRevisionHistoryForPlan(@NotNull PlanKey oldPlanKey, @NotNull PlanKey newPlanKey)

Method Detail

getLastVcsRevisionKeys

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

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

Parameters:

planKey -

moveRevisionHistoryForPlan

void moveRevisionHistoryForPlan(@NotNull
                                @NotNull PlanKey oldPlanKey,
                                @NotNull
                                @NotNull PlanKey newPlanKey)

Since:

5.6