com.atlassian.bamboo.vcs.configuration.legacy

Class LegacyWorkingCopyManager

java.lang.Object

com.atlassian.bamboo.vcs.configuration.legacy.LegacyExecutorBase

com.atlassian.bamboo.vcs.configuration.legacy.LegacyWorkingCopyManager

All Implemented Interfaces:

MergingVcsWorkingCopyManager, UpdatingVcsWorkingCopyManager, VcsWorkingCopyManager

Direct Known Subclasses:

LegacyFixedDirectoryWorkingCopyManager

public class LegacyWorkingCopyManager
extends LegacyExecutorBase
implements VcsWorkingCopyManager, MergingVcsWorkingCopyManager, UpdatingVcsWorkingCopyManager

Field Summary

Fields inherited from class com.atlassian.bamboo.vcs.configuration.legacy.LegacyExecutorBase

repositoryModuleDescriptor

Constructor Summary

Constructors

Constructor and Description
LegacyWorkingCopyManager(RepositoryModuleDescriptor repositoryModuleDescriptor, BuildLoggerManager buildLoggerManager)

Method Summary

Modifier and Type	Method and Description
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.
VcsWorkingCopy	retrieveSourceCode(CommonContext commonContext, VcsRepositoryData repositoryData, PlanVcsRevisionData targetRevision, File targetPath) Checkout or update a working copy to a revision.
VcsWorkingCopy	updateRemote(VcsWorkingCopy workingCopy, VcsRepositoryData vcsRepositoryData, String commitMessage) Update remote repository.
VcsWorkingCopy	updateToLatestRevision(CommonContext commonContext, VcsRepositoryData repositoryData, File targetPath) Checkout or update a working copy to the latest revision.

Methods inherited from class com.atlassian.bamboo.vcs.configuration.legacy.LegacyExecutorBase

getNewRepositoryInstance, getNewRepositoryInstanceAs, getRepositoryInstance, getRepositoryInstanceAs, xmlToConfiguration

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.MergingVcsWorkingCopyManager

canDoMerge, getMergingRequirements

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

stageChanges

Constructor Detail

LegacyWorkingCopyManager

public LegacyWorkingCopyManager(RepositoryModuleDescriptor repositoryModuleDescriptor,
                                BuildLoggerManager buildLoggerManager)

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

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

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,
                                            @NotNull
                                            String commitMessage)
                                     throws RepositoryException

Description copied from interface: UpdatingVcsWorkingCopyManager

Update remote 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