Class GitHubChangeDetector
java.lang.Object
com.atlassian.bamboo.plugins.github.AbstractGitHubExecutor
com.atlassian.bamboo.plugins.github.GitHubChangeDetector
- All Implemented Interfaces:
IdentifyingExecutor<VcsChangeDetector>
,VcsChangeDetector
-
Field Summary
Fields inherited from class com.atlassian.bamboo.plugins.github.AbstractGitHubExecutor
vcsRepositoryManager
-
Constructor Summary
-
Method Summary
Modifier and TypeMethodDescriptioncollectChangesForInitialBuild
(@NotNull PlanKey planKey, @NotNull VcsRepositoryData repositoryData, @NotNull VcsBranch otherBranch, boolean otherBranchUnreliable) This method is used to generate the list of commits for an initial build of a plan branch.@NotNull BuildRepositoryChanges
collectChangesForRevision
(@NotNull PlanKey planKey, @NotNull VcsRepositoryData repositoryData, @NotNull String customRevision) @NotNull BuildRepositoryChanges
collectChangesSinceRevision
(@NotNull PlanKey planKey, @NotNull VcsRepositoryData repositoryData, @NotNull PlanVcsRevisionData lastRevisionData) @Nullable ContextualVcsId<VcsChangeDetector>
getVcsIdForExecutor
(@NotNull VcsRepositoryData vcsRepositoryData) Returned id has to fulfill the following: Given two VcsRepositoryData objects A and B, and executor e returning equal ContextualVcsId (in terms of equals()), for any operation foo() provided by the executor, the calls e::foo(A) and e::foo(B) should be equivalent.Methods inherited from class com.atlassian.bamboo.plugins.github.AbstractGitHubExecutor
getGitModuleDescriptor, githubToGitData
-
Constructor Details
-
GitHubChangeDetector
-
-
Method Details
-
collectChangesSinceRevision
@NotNull public @NotNull BuildRepositoryChanges collectChangesSinceRevision(@NotNull @NotNull PlanKey planKey, @NotNull @NotNull VcsRepositoryData repositoryData, @NotNull @NotNull PlanVcsRevisionData lastRevisionData) throws RepositoryException - Specified by:
collectChangesSinceRevision
in interfaceVcsChangeDetector
- Throws:
RepositoryException
-
collectChangesForRevision
@NotNull public @NotNull BuildRepositoryChanges collectChangesForRevision(@NotNull @NotNull PlanKey planKey, @NotNull @NotNull VcsRepositoryData repositoryData, @NotNull @NotNull String customRevision) throws RepositoryException - Specified by:
collectChangesForRevision
in interfaceVcsChangeDetector
- Throws:
RepositoryException
-
getVcsIdForExecutor
@Nullable public @Nullable ContextualVcsId<VcsChangeDetector> getVcsIdForExecutor(@NotNull @NotNull VcsRepositoryData vcsRepositoryData) Description copied from interface:IdentifyingExecutor
Returned id has to fulfill the following: Given two VcsRepositoryData objects A and B, and executor e returning equal ContextualVcsId (in terms of equals()), for any operation foo() provided by the executor, the calls e::foo(A) and e::foo(B) should be equivalent. To be more precise: given any time point t and any variable context v, calling a::foo(A) should yield the same results as calling e::foo(B). Given the above it follows that - calculation of the id should take into account global and plan variables. This means, that calling this method on the same object in different variable context can (possibly must) yield different results. - equal ids need not (and should not) guarantee equal call results over indefinite time. In particular, result of e:foo(A).equals(e::foo(A)) is allowed to be false, since 2 calls to e::foo(A) do not happen at the same time. Example: 2 git repositories with the same url and credentials are considered equal in context ofVcsBranchDetector
. If they also point to the same branch, they are considered equal in context ofVcsChangeDetector
- Specified by:
getVcsIdForExecutor
in interfaceIdentifyingExecutor<VcsChangeDetector>
- Returns:
- the id of repository, can be null if no feasible identification algorithm exists
-
collectChangesForInitialBuild
public BuildRepositoryChanges collectChangesForInitialBuild(@NotNull @NotNull PlanKey planKey, @NotNull @NotNull VcsRepositoryData repositoryData, @NotNull @NotNull VcsBranch otherBranch, boolean otherBranchUnreliable) throws RepositoryException Description copied from interface:VcsChangeDetector
This method is used to generate the list of commits for an initial build of a plan branch. In particular, this _can_ be the result of comparing current branch with another branch, but it's not a strict contract, i.e. depending on vcs type, there might exist better way to determine optimum commit list. Default implementations returns the last commit revision and empty commit list.- Specified by:
collectChangesForInitialBuild
in interfaceVcsChangeDetector
otherBranch
- branch that can be used as reference when generating the commit list. Guaranteed to be not null if the repository type supports branches.otherBranchUnreliable
- indicates that 'otherBranch' is not a reliable reference point- Throws:
RepositoryException
-