com.atlassian.bamboo.plugins.hg.v2

Class MercurialBranchDetector

java.lang.Object

com.atlassian.bamboo.plugins.hg.v2.AbstractMercurialExecutor

com.atlassian.bamboo.plugins.hg.v2.MercurialBranchDetector

All Implemented Interfaces:

IdentifyingExecutor<VcsBranchDetector>, VcsBranchDetector

public class MercurialBranchDetector
extends AbstractMercurialExecutor
implements VcsBranchDetector

Field Summary

Fields

Modifier and Type	Field and Description
static Pattern	branchesPattern

Fields inherited from class com.atlassian.bamboo.plugins.hg.v2.AbstractMercurialExecutor

branchIntegrationHelper, buildDirectoryManager, buildLoggerManager, capabilityContext, credentialsAccessor, customVariableContext, i18nResolver, scopedExclusionService, sshProxyService, trustedKeyHelper

Constructor Summary

Constructors

Constructor and Description
MercurialBranchDetector()

Method Summary

Modifier and Type	Method and Description
CommitContext	getFirstCommitApproximation(VcsRepositoryData repositoryData) Retrieve an old, preferably the first commit on a branch.
CommitContext	getLastCommit(VcsRepositoryData repositoryData) Retrieve last commit on the branch set on this Repository.
ContextualVcsId	getVcsIdForExecutor(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.hg.v2.AbstractMercurialExecutor

commitLocal, getAccessData, getCacheBaseDirectory, getCacheDirectory, getCacheDirectory, getHgRepoAccess, getHgRepoAccess, getMaxCommitsToReturn, getOpenBranches, getSubstitutedAccessData, getWorkingCopyInfo, getWorkingDirectory, substituteString, updateRemote, updateRemoteWithNewBranch

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Methods inherited from interface com.atlassian.bamboo.vcs.runtime.VcsBranchDetector

getFirstCommit, getOpenBranches, usePollingForBranchDetection

Field Detail

branchesPattern

public static final Pattern branchesPattern

Constructor Detail

MercurialBranchDetector

public MercurialBranchDetector()

Method Detail

getVcsIdForExecutor

@Nullable
public ContextualVcsId getVcsIdForExecutor(@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 of VcsBranchDetector. If they also point to the same branch, they are considered equal in context of VcsChangeDetector

Specified by:

getVcsIdForExecutor in interface IdentifyingExecutor<VcsBranchDetector>

Returns:

the id of repository, can be null if no feasible identification algorithm exists

getLastCommit

@NotNull
public CommitContext getLastCommit(@NotNull
                                            VcsRepositoryData repositoryData)
                                     throws RepositoryException

Description copied from interface: VcsBranchDetector

Retrieve last commit on the branch set on this Repository. Method is used by Chain Branch automatic expiry. If this method returns null Chain Branch is not expired.

Specified by:

getLastCommit in interface VcsBranchDetector

Returns:

the last commit

Throws:

RepositoryException

getFirstCommitApproximation

@NotNull
public CommitContext getFirstCommitApproximation(@NotNull
                                                          VcsRepositoryData repositoryData)
                                                   throws RepositoryException

Description copied from interface: VcsBranchDetector

Retrieve an old, preferably the first commit on a branch. Implementations must not return null. The default implementation may return null.

Specified by:

getFirstCommitApproximation in interface VcsBranchDetector

Throws:

RepositoryException