Package com.atlassian.bamboo.plugins.bitbucket.v2

Class BitbucketCloudWorkingCopyManager

java.lang.Object

com.atlassian.bamboo.plugins.bitbucket.v2.AbstractBitbucketCloudExecutor

com.atlassian.bamboo.plugins.bitbucket.v2.BitbucketCloudWorkingCopyManager

All Implemented Interfaces:

MergingVcsWorkingCopyManager, NoContextVcsWorkingCopyManager, StatusProvidingVcsWorkingCopyManager, UpdatingVcsWorkingCopyManager, VcsExecutorWithRequirements, VcsWorkingCopyManager

public class BitbucketCloudWorkingCopyManager
extends AbstractBitbucketCloudExecutor
implements MergingVcsWorkingCopyManager, UpdatingVcsWorkingCopyManager, VcsExecutorWithRequirements, NoContextVcsWorkingCopyManager, StatusProvidingVcsWorkingCopyManager

Constructor Summary

Constructors

Constructor	Description
BitbucketCloudWorkingCopyManager()

Method Summary

Modifier and Type	Method	Description
@NotNull VcsWorkingCopy	checkoutAndMerge(@NotNull CommonContext commonContext, @NotNull VcsRepositoryData vcsRepositoryData, @NotNull VcsBranch targetBranch, @NotNull PlanVcsRevisionData revisionOnTarget, @NotNull VcsBranch sourceBranch, @NotNull PlanVcsRevisionData sourceRevision, @NotNull File targetPath)	Checks out the targetBranch and merges sourceBranch to it.
@NotNull VcsWorkingCopy	commitLocal(@NotNull VcsWorkingCopy workingCopy, @NotNull VcsRepositoryData vcsRepositoryData, @NotNull String commitMessage)	Create a local commit.
@NotNull Set<Requirement>	getRequirements(@NotNull VcsRepositoryData vcsRepositoryData)
@NotNull VcsWorkingCopy	getWorkingCopyInfo(@NotNull VcsRepositoryData repositoryData, @NotNull File checkoutPath)	Provide repository working copy information for the given checkout path.
@NotNull VcsWorkingCopy	retrieveSourceCode(@NotNull CommonContext commonContext, @NotNull VcsRepositoryData repositoryData, @NotNull PlanVcsRevisionData targetRevision, @NotNull File targetPath)	Checkout or update a working copy to a revision.
void	stageChanges(@NotNull VcsWorkingCopy workingCopy, @NotNull VcsRepositoryData repositoryData, @NotNull Collection<String> pathsToAdd)	Stage changes for committing.
@NotNull VcsWorkingCopy	updateRemote(@NotNull VcsWorkingCopy workingCopy, @NotNull VcsRepositoryData vcsRepositoryData, @NotNull String commitMessage)	Update remote repository.
@NotNull VcsWorkingCopy	updateToLatestRevision(@NotNull CommonContext commonContext, @NotNull VcsRepositoryData repositoryData, @NotNull File targetPath)	Checkout or update a working copy to the latest revision.
@NotNull VcsWorkingCopy	updateToLatestRevision(@NotNull VcsRepositoryData repositoryData, @NotNull File targetPath)	Checkout or update a working copy to the latest revision.
@NotNull VcsWorkingCopy	updateToLatestRevisionForSpecs(@NotNull VcsRepositoryData repositoryData, @NotNull File targetPath)	Checkout or update a working copy to the latest revision.

Methods inherited from class com.atlassian.bamboo.plugins.bitbucket.v2.AbstractBitbucketCloudExecutor

bitbucketCloudToUnderlyingVcsData, getUnderlyingVcsModuleDescriptor, setVcsRepositoryManager

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

Constructor Detail

BitbucketCloudWorkingCopyManager

public BitbucketCloudWorkingCopyManager()

Method Detail

getWorkingCopyInfo

@NotNull
public @NotNull VcsWorkingCopy getWorkingCopyInfo(@NotNull
                                                  @NotNull VcsRepositoryData repositoryData,
                                                  @NotNull
                                                  @NotNull File checkoutPath)
                                           throws RepositoryException

Description copied from interface: StatusProvidingVcsWorkingCopyManager

Provide repository working copy information for the given checkout path.

Specified by:

getWorkingCopyInfo in interface StatusProvidingVcsWorkingCopyManager

Parameters:

repositoryData - configuration of the repository

checkoutPath - path, where repository was checked out

Returns:

working copy information

Throws:

RepositoryException - if any error occurs, or e.g. the path is not a valid checkout path for the repository

getRequirements

@NotNull
public @NotNull Set<Requirement> getRequirements(@NotNull
                                                 @NotNull VcsRepositoryData vcsRepositoryData)

Specified by:

getRequirements in interface VcsExecutorWithRequirements

stageChanges

public void stageChanges(@NotNull
                         @NotNull VcsWorkingCopy workingCopy,
                         @NotNull
                         @NotNull VcsRepositoryData repositoryData,
                         @NotNull
                         @NotNull Collection<String> pathsToAdd)
                  throws RepositoryException

Description copied from interface: UpdatingVcsWorkingCopyManager

Stage changes for committing. If staging is not required or supported by repository, this method should do nothing.

Staging logic may differ between repository types.

Specified by:

stageChanges in interface UpdatingVcsWorkingCopyManager

Parameters:

workingCopy - workspace to perform the staging

repositoryData - configuration of repository

pathsToAdd - paths, relative to working copy directory, to stage for committing; if empty, all modified files from working copy directory should be staged

Throws:

RepositoryException

commitLocal

@NotNull
public @NotNull VcsWorkingCopy commitLocal(@NotNull
                                           @NotNull VcsWorkingCopy workingCopy,
                                           @NotNull
                                           @NotNull VcsRepositoryData vcsRepositoryData,
                                           @NotNull
                                           @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

updateToLatestRevision

@NotNull
public @NotNull VcsWorkingCopy updateToLatestRevision(@NotNull
                                                      @NotNull VcsRepositoryData repositoryData,
                                                      @NotNull
                                                      @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

updateToLatestRevisionForSpecs

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

Description copied from interface: NoContextVcsWorkingCopyManager

Checkout or update a working copy to the latest revision. The method is desired to work with Specs.

Specified by:

updateToLatestRevisionForSpecs 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

retrieveSourceCode

@NotNull
public @NotNull VcsWorkingCopy retrieveSourceCode(@NotNull
                                                  @NotNull CommonContext commonContext,
                                                  @NotNull
                                                  @NotNull VcsRepositoryData repositoryData,
                                                  @NotNull
                                                  @NotNull PlanVcsRevisionData targetRevision,
                                                  @NotNull
                                                  @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

updateRemote

@NotNull
public @NotNull VcsWorkingCopy updateRemote(@NotNull
                                            @NotNull VcsWorkingCopy workingCopy,
                                            @NotNull
                                            @NotNull VcsRepositoryData vcsRepositoryData,
                                            @NotNull
                                            @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

checkoutAndMerge

@NotNull
public @NotNull VcsWorkingCopy checkoutAndMerge(@NotNull
                                                @NotNull CommonContext commonContext,
                                                @NotNull
                                                @NotNull VcsRepositoryData vcsRepositoryData,
                                                @NotNull
                                                @NotNull VcsBranch targetBranch,
                                                @NotNull
                                                @NotNull PlanVcsRevisionData revisionOnTarget,
                                                @NotNull
                                                @NotNull VcsBranch sourceBranch,
                                                @NotNull
                                                @NotNull PlanVcsRevisionData sourceRevision,
                                                @NotNull
                                                @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

updateToLatestRevision

@NotNull
public @NotNull VcsWorkingCopy updateToLatestRevision(@NotNull
                                                      @NotNull CommonContext commonContext,
                                                      @NotNull
                                                      @NotNull VcsRepositoryData repositoryData,
                                                      @NotNull
                                                      @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