com.atlassian.bamboo.vcs.runtime

Interface FixedDirectoryWorkingCopyManager

All Superinterfaces:

VcsWorkingCopyManager

All Known Implementing Classes:

LegacyFixedDirectoryWorkingCopyManager

Deprecated.

since 5.14 the purpose of this interface is to support exotic repository types.

@Deprecated
public interface FixedDirectoryWorkingCopyManager
extends VcsWorkingCopyManager

Manages working copy in a pre-defined directory (i.e. location of the working copy is determined by a repository configuration and cannot be changed at will). Implementation should be stateless. Implementors should prefer VcsWorkingCopyManager instead, as this variant severely limits implementation's usefulness. For example, repository plugins implementing this interface cannot be used in deployment projects. Use only if you must.

Method Summary

Modifier and Type	Method and Description
File	getWorkingCopyPath(CommonContext commonContext, VcsRepositoryData repositoryData) Deprecated. Based on configuration and current context produce absolute path to the working copy.
VcsWorkingCopy	retrieveSourceCode(CommonContext commonContext, VcsRepositoryData repositoryData, PlanVcsRevisionData targetRevision) Deprecated. Checkout or update a working copy to a revision.
default VcsWorkingCopy	retrieveSourceCode(CommonContext commonContext, VcsRepositoryData repositoryData, PlanVcsRevisionData targetRevision, File targetPath) Deprecated. If you can implement this correctly using targetPath, then you should not be implementing this interface.
default VcsWorkingCopy	updateToLatestRevision(CommonContext commonContext, VcsRepositoryData repositoryData, File targetPath) Deprecated. If you can implement this, then you should not be implementing this interface.

Method Detail

retrieveSourceCode

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

Deprecated.

If you can implement this correctly using targetPath, then you should not be implementing this interface.

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
default VcsWorkingCopy updateToLatestRevision(@NotNull
                                                       CommonContext commonContext,
                                                       @NotNull
                                                       VcsRepositoryData repositoryData,
                                                       @NotNull
                                                       File targetPath)
                                                throws RepositoryException

Deprecated.

If you can implement this, then you should not be implementing this interface.

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:

UnsupportedOperationException

RepositoryException

retrieveSourceCode

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

Deprecated.

Checkout or update a working copy to a revision.

Parameters:

commonContext - - a current build or deployment context

repositoryData - - configuration of a repository to checkout/update

targetRevision - - revision to check out or update to

Returns:

object representing created/updated working copy

Throws:

RepositoryException

getWorkingCopyPath

@NotNull
File getWorkingCopyPath(@NotNull
                                 CommonContext commonContext,
                                 @NotNull
                                 VcsRepositoryData repositoryData)
                          throws RepositoryException

Deprecated.

Based on configuration and current context produce absolute path to the working copy.

Parameters:

commonContext -

repositoryData -

Returns:

Throws:

RepositoryException