com.atlassian.bamboo.plugins.git.v2

Class GitWorkingCopyManager

java.lang.Object

com.atlassian.bamboo.plugins.git.v2.AbstractGitExecutor

com.atlassian.bamboo.plugins.git.v2.GitWorkingCopyManager

All Implemented Interfaces:

MergingVcsWorkingCopyManager, NoContextVcsWorkingCopyManager, UpdatingVcsWorkingCopyManager, VcsWorkingCopyManager

public class GitWorkingCopyManager
extends AbstractGitExecutor
implements MergingVcsWorkingCopyManager, UpdatingVcsWorkingCopyManager, NoContextVcsWorkingCopyManager

Field Summary

Fields inherited from class com.atlassian.bamboo.plugins.git.v2.AbstractGitExecutor

buildDirectoryManager, customVariableContext, DEFAULT_BRANCH, i18nResolver, sshProxyService, trustedKeyHelper

Constructor Summary

Constructors

Constructor and Description
GitWorkingCopyManager()

Method Summary

Modifier and Type	Method and Description
boolean	canDoMerge()
VcsWorkingCopy	checkoutAndMerge(CommonContext commonContext, VcsRepositoryData vcsRepositoryData, VcsBranch targetBranch, PlanVcsRevisionData revisionOnTarget, VcsBranch sourceBranch, PlanVcsRevisionData sourceRevision, File targetPath) Checks out the targetBranch and merges sourceBranch to it.
VcsWorkingCopy	commitLocal(VcsWorkingCopy workingCopy, VcsRepositoryData vcsRepositoryData, String commitMessage) Create a local commit.
Set<Requirement>	getMergingRequirements() If executing merge imposes capability requirements on top of those returned by VcsExecutorWithRequirements#getRequirements(), return them here.
VcsWorkingCopy	retrieveSourceCode(CommonContext commonContext, VcsRepositoryData repositoryData, PlanVcsRevisionData targetRevision, File targetPath) Checkout or update a working copy to a revision.
void	setBranchIntegrationHelper(VcsBranchIntegrationHelper branchIntegrationHelper)
void	setBuildLoggerManager(BuildLoggerManager buildLoggerManager)
VcsWorkingCopy	updateRemote(VcsWorkingCopy workingCopy, VcsRepositoryData vcsRepositoryData, String commitMessage) Update remoter repository.
VcsWorkingCopy	updateToLatestRevision(CommonContext commonContext, VcsRepositoryData repositoryData, File targetPath) Checkout or update a working copy to the latest revision.
VcsWorkingCopy	updateToLatestRevision(VcsRepositoryData repositoryData, File targetPath) Checkout or update a working copy to the latest revision.

Methods inherited from class com.atlassian.bamboo.plugins.git.v2.AbstractGitExecutor

getAccessData, getCacheDirectory, getCachePath, getGitCapability, getSharedCredentialsIdField, getSshCapability, getSubstitutedAccessData, getSubstitutedAccessDataBuilder, getWorkingDirectory, isUsingSharedCredentials, rethrowOrRemoveDirectory, setBuildDirectoryManager, setCapabilityContext, setCredentialsAccessor, setCustomVariableContext, setI18nResolver, setSshProxyService, setTrustedKeyHelper, substituteString

Methods inherited from class java.lang.Object

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

Constructor Detail

GitWorkingCopyManager

public GitWorkingCopyManager()

Method Detail

retrieveSourceCode

@NotNull
public VcsWorkingCopy retrieveSourceCode(@NotNull
                                                  CommonContext commonContext,
                                                  @NotNull
                                                  VcsRepositoryData repositoryData,
                                                  @NotNull
                                                  PlanVcsRevisionData targetRevision,
                                                  @NotNull
                                                  File targetPath)
                                           throws RepositoryException

Description copied from interface: VcsWorkingCopyManager

Checkout or update a working copy to a revision.

Specified by:

retrieveSourceCode in interface VcsWorkingCopyManager

Parameters:

commonContext - - a current build or deployment context

repositoryData - - configuration of a repository to checkout/update

targetRevision - - revision to check out or update to

targetPath - - workings copy's path. Note that some legacy implementation may ignore this parameter. (see FixedDirectoryWorkingCopyManager)

Returns:

object representing created/updated working copy

Throws:

RepositoryException

updateToLatestRevision

@NotNull
public VcsWorkingCopy updateToLatestRevision(@NotNull
                                                      CommonContext commonContext,
                                                      @NotNull
                                                      VcsRepositoryData repositoryData,
                                                      @NotNull
                                                      File targetPath)
                                               throws RepositoryException

Description copied from interface: VcsWorkingCopyManager

Checkout or update a working copy to the latest revision.

Specified by:

updateToLatestRevision in interface VcsWorkingCopyManager

Parameters:

commonContext - - a current build or deployment context

repositoryData - - configuration of a repository to checkout/update

targetPath - - workings copy's path. Note that some legacy implementation may ignore this parameter. (see FixedDirectoryWorkingCopyManager)

Returns:

object representing created/updated working copy

Throws:

RepositoryException

updateToLatestRevision

@NotNull
public VcsWorkingCopy updateToLatestRevision(@NotNull
                                                      VcsRepositoryData repositoryData,
                                                      @NotNull
                                                      File targetPath)
                                               throws RepositoryException

Description copied from interface: NoContextVcsWorkingCopyManager

Checkout or update a working copy to the latest revision.

Specified by:

updateToLatestRevision in interface NoContextVcsWorkingCopyManager

Parameters:

repositoryData - - configuration of a repository to checkout/update

targetPath - - workings copy's path. Note that some legacy implementation may ignore this parameter. (see FixedDirectoryWorkingCopyManager)

Returns:

object representing created/updated working copy

Throws:

RepositoryException

checkoutAndMerge

@NotNull
public VcsWorkingCopy checkoutAndMerge(@NotNull
                                                CommonContext commonContext,
                                                @NotNull
                                                VcsRepositoryData vcsRepositoryData,
                                                @NotNull
                                                VcsBranch targetBranch,
                                                @NotNull
                                                PlanVcsRevisionData revisionOnTarget,
                                                @NotNull
                                                VcsBranch sourceBranch,
                                                @NotNull
                                                PlanVcsRevisionData sourceRevision,
                                                @NotNull
                                                File targetPath)
                                         throws RepositoryException

Description copied from interface: MergingVcsWorkingCopyManager

Checks out the targetBranch and merges sourceBranch to it. Depending on the vcs type, this can create local commit.

Specified by:

checkoutAndMerge in interface MergingVcsWorkingCopyManager

vcsRepositoryData - configuration of the repository. Note that the following parameters override branch stored in repository data.

targetBranch - - target branch (branch to checkout and merge to)

revisionOnTarget - - revision to checkout and merge to

sourceBranch - - branch to merge from

sourceRevision - - revision to merge from

targetPath - - workings copy's path

Returns:

state of the working copy, including new revision if applicable

Throws:

RepositoryException

canDoMerge

public boolean canDoMerge()

Specified by:

canDoMerge in interface MergingVcsWorkingCopyManager

Returns:

true if merges are possible (i.e. required capabilities are present)

getMergingRequirements

@NotNull
public Set<Requirement> getMergingRequirements()

Description copied from interface: MergingVcsWorkingCopyManager

If executing merge imposes capability requirements on top of those returned by VcsExecutorWithRequirements#getRequirements(), return them here.

Specified by:

getMergingRequirements in interface MergingVcsWorkingCopyManager

commitLocal

@NotNull
public VcsWorkingCopy commitLocal(@NotNull
                                           VcsWorkingCopy workingCopy,
                                           @NotNull
                                           VcsRepositoryData vcsRepositoryData,
                                           @NotNull
                                           String commitMessage)
                                    throws RepositoryException

Description copied from interface: UpdatingVcsWorkingCopyManager

Create a local commit. The exact meaning of this operation depends on repository type. In particular, it can be no-op for certain repository types, for example SVN. Intended use: creating a private revision that can be used later in the build.

Specified by:

commitLocal in interface UpdatingVcsWorkingCopyManager

Returns:

updated state of local working copy

Throws:

RepositoryException

updateRemote

@NotNull
public VcsWorkingCopy updateRemote(@NotNull
                                            VcsWorkingCopy workingCopy,
                                            @NotNull
                                            VcsRepositoryData vcsRepositoryData,
                                            @Nullable
                                            String commitMessage)
                                     throws RepositoryException

Description copied from interface: UpdatingVcsWorkingCopyManager

Update remoter repository. The exact meaning of this operation depends on repository type. In DVCS case this should push pre-existing local commit to remote repository. In traditional vcs, like Subversion, this should execute commit operation. Intended use: publishing changes to the world.

Specified by:

updateRemote in interface UpdatingVcsWorkingCopyManager

commitMessage - - implementors are free to ignore this parameter.

Returns:

updated state of local working copy

Throws:

RepositoryException

setBuildLoggerManager

public void setBuildLoggerManager(BuildLoggerManager buildLoggerManager)

setBranchIntegrationHelper

public void setBranchIntegrationHelper(VcsBranchIntegrationHelper branchIntegrationHelper)