public interface

PlanVcsRevisionHistoryService

com.atlassian.bamboo.plan.vcsRevision.PlanVcsRevisionHistoryService
Known Indirect Subclasses

Class Overview

Provides access to vcs revision information of a Plan

Summary

Public Methods
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.
@NotNull PlanVcsRevisionDataSet getLastVcsRevisionKeys(PlanKey planKey)
Return the mapping between repository ids and strings representing the vcs revisions which were result of last performed change detection.
@NotNull @Deprecated PlanVcsRevisionDataSet getLastVcsRevisionKeysBeforeBuildNumber(PlanKey planKey, int buildNumber)
This method is 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.

Public Methods

public void cleanupUnusedEntriesForPlan (PlanKey planKey)

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

public void clearRevisionHistoryForPlan (PlanKey planKey)

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

@NotNull public PlanVcsRevisionDataSet getLastVcsRevisionKeys (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.

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

This method is 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.

public void markBuildStarted (BuildContext buildContext)

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

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

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