com.atlassian.bamboo.v2.trigger

Interface ChangeDetectionManager

All Known Implementing Classes:

DefaultChangeDetectionManager

@PublicApi
public interface ChangeDetectionManager

Encapsulates the detection of the changes given a repository. It provides a central point to place common change detection logic

Since:

2.7

Field Summary

Fields

Modifier and Type	Field and Description
static int	MAX_OPERATION_RETRIES Total number of retries to perform for repository operation failure

Method Summary

Modifier and Type	Method and Description
BuildChanges	collectAllChangesSinceLastBuild(ImmutableChain chain, Map<String,String> customVariableValues, String customRevision) Collect changes for a plan since the last build, regardless of whether the build triggering repositories have changes or not.
BuildRepositoryChanges	collectChangesBetween(ImmutableChain chain, PlanRepositoryDefinition repositoryDefinition, PlanVcsRevisionData fromVcsRevisionData, PlanVcsRevisionData toVcsRevisionData) Given a PlanRepositoryDefinition finds the BuildChanges object that captures all changes that occurred between the fromVcsRevisionKey to toVcsRevisionKey
BuildRepositoryChanges	collectChangesBetween(ImmutableChain chain, RepositoryDefinition repositoryDefinition, PlanVcsRevisionData fromVcsRevisionData, PlanVcsRevisionData toVcsRevisionData) Deprecated. since 5.14 use collectChangesBetween(ImmutableChain, PlanRepositoryDefinition, PlanVcsRevisionData, PlanVcsRevisionData)
BuildRepositoryChanges	collectChangesSinceLastBuild(ImmutableChain chain, PlanRepositoryDefinition repositoryDefinition, PlanVcsRevisionData lastVcsRevisionData, Map<String,String> customVariableValues, String customRevision) Given a PlanRepositoryDefinition finds the BuildRepositoryChanges object that captures all changes that occurred since the lastVcsRevisionKey to the current latest found on the repository.
BuildRepositoryChanges	collectChangesSinceLastBuild(ImmutableChain chain, RepositoryDefinition repositoryDefinition, PlanVcsRevisionData lastVcsRevisionData, Map<String,String> customVariableValues, String customRevision) Deprecated. since 5.14 use collectChangesSinceLastBuild(ImmutableChain, PlanRepositoryDefinition, PlanVcsRevisionData, Map, String)
BuildChanges	collectChangesSinceLastBuildIfTriggered(ImmutableChain chain, Map<String,String> customVariableValues, Set<Long> triggeringRepositories) Collect changes for a plan since the last build.
void	updateIntegrationRepositoryDetails(ImmutableChain chain, BuildChanges buildChanges)

Field Detail

MAX_OPERATION_RETRIES

static final int MAX_OPERATION_RETRIES

Total number of retries to perform for repository operation failure

Method Detail

collectChangesSinceLastBuildIfTriggered

@NotNull
BuildChanges collectChangesSinceLastBuildIfTriggered(@NotNull
                                                              ImmutableChain chain,
                                                              @Nullable
                                                              Map<String,String> customVariableValues,
                                                              @Nullable
                                                              Set<Long> triggeringRepositories)
                                                       throws RepositoryException

Collect changes for a plan since the last build. Returns changes only if at least one of the build triggering repositories has changes.

Parameters:

chain -

customVariableValues -

triggeringRepositories - id of repositories that trigger the build

Returns:

aggregated changes from all repositories

Throws:

RepositoryException

collectAllChangesSinceLastBuild

@NotNull
BuildChanges collectAllChangesSinceLastBuild(@NotNull
                                                      ImmutableChain chain,
                                                      @Nullable
                                                      Map<String,String> customVariableValues,
                                                      @Nullable
                                                      String customRevision)
                                               throws RepositoryException

Collect changes for a plan since the last build, regardless of whether the build triggering repositories have changes or not.

Parameters:

chain -

customVariableValues -

customRevision - specify which revision we're going to build (run customised plan dialog)

Returns:

aggregated changes from all repositories

Throws:

RepositoryException

collectChangesSinceLastBuild

@Deprecated
 @NotNull
BuildRepositoryChanges collectChangesSinceLastBuild(@NotNull
                                                                          ImmutableChain chain,
                                                                          @NotNull
                                                                          RepositoryDefinition repositoryDefinition,
                                                                          @NotNull
                                                                          PlanVcsRevisionData lastVcsRevisionData,
                                                                          @Nullable
                                                                          Map<String,String> customVariableValues,
                                                                          @Nullable
                                                                          String customRevision)
                                                                   throws RepositoryException

Deprecated. since 5.14 use collectChangesSinceLastBuild(ImmutableChain, PlanRepositoryDefinition, PlanVcsRevisionData, Map, String)

Given a RepositoryDefinition finds the BuildRepositoryChanges object that captures all changes that occurred since the lastVcsRevisionKey to the current latest found on the repository. Method provides manually set variables collection for evaluation during change detection

Parameters:

chain -

repositoryDefinition -

lastVcsRevisionData -

customVariableValues -

customRevision - - override target revision for default repository definition - used by 'run customised build'

Returns:

Throws:

RepositoryException

collectChangesSinceLastBuild

@NotNull
BuildRepositoryChanges collectChangesSinceLastBuild(@NotNull
                                                             ImmutableChain chain,
                                                             @NotNull
                                                             PlanRepositoryDefinition repositoryDefinition,
                                                             @NotNull
                                                             PlanVcsRevisionData lastVcsRevisionData,
                                                             @Nullable
                                                             Map<String,String> customVariableValues,
                                                             @Nullable
                                                             String customRevision)
                                                      throws RepositoryException

Given a PlanRepositoryDefinition finds the BuildRepositoryChanges object that captures all changes that occurred since the lastVcsRevisionKey to the current latest found on the repository. Method provides manually set variables collection for evaluation during change detection

Parameters:

chain -

repositoryDefinition -

lastVcsRevisionData -

customVariableValues -

customRevision - - override target revision for default repository definition - used by 'run customised build'

Returns:

Throws:

RepositoryException

collectChangesBetween

@NotNull
 @Deprecated
BuildRepositoryChanges collectChangesBetween(@NotNull
                                                                   ImmutableChain chain,
                                                                   @NotNull
                                                                   RepositoryDefinition repositoryDefinition,
                                                                   @Nullable
                                                                   PlanVcsRevisionData fromVcsRevisionData,
                                                                   @NotNull
                                                                   PlanVcsRevisionData toVcsRevisionData)
                                                            throws RepositoryException

Deprecated. since 5.14 use collectChangesBetween(ImmutableChain, PlanRepositoryDefinition, PlanVcsRevisionData, PlanVcsRevisionData)

Given a RepositoryV2 finds the BuildChanges object that captures all changes that occurred between the fromVcsRevisionKey to toVcsRevisionKey

Parameters:

chain -

repositoryDefinition -

fromVcsRevisionData -

toVcsRevisionData -

Returns:

Throws:

RepositoryException

collectChangesBetween

@NotNull
BuildRepositoryChanges collectChangesBetween(@NotNull
                                                      ImmutableChain chain,
                                                      @NotNull
                                                      PlanRepositoryDefinition repositoryDefinition,
                                                      @Nullable
                                                      PlanVcsRevisionData fromVcsRevisionData,
                                                      @NotNull
                                                      PlanVcsRevisionData toVcsRevisionData)
                                               throws RepositoryException

Given a PlanRepositoryDefinition finds the BuildChanges object that captures all changes that occurred between the fromVcsRevisionKey to toVcsRevisionKey

Parameters:

chain -

repositoryDefinition -

fromVcsRevisionData -

toVcsRevisionData -

Returns:

Throws:

RepositoryException

updateIntegrationRepositoryDetails

void updateIntegrationRepositoryDetails(ImmutableChain chain,
                                        BuildChanges buildChanges)
                                 throws RepositoryException

Throws:

RepositoryException