Package com.atlassian.bamboo.plugins.git

Class JGitOperationHelper

java.lang.Object

com.atlassian.bamboo.plugins.git.AbstractGitOperationHelper

com.atlassian.bamboo.plugins.git.JGitOperationHelper

All Implemented Interfaces:

GitOperationHelper

public class JGitOperationHelper
extends AbstractGitOperationHelper

Nested Class Summary

Nested Classes

Modifier and Type	Class	Description
protected static interface	JGitOperationHelper.WithFetchConnectionCallback<E extends Throwable,T>
protected static interface	JGitOperationHelper.WithRepositoryCallback<E extends Throwable,V>
protected static interface	JGitOperationHelper.WithTransportCallback<E extends Throwable,T>

Field Summary

Fields

Modifier and Type	Field	Description
static final String	PUSH_IS_NOT_SUPPORTED

Fields inherited from class com.atlassian.bamboo.plugins.git.AbstractGitOperationHelper

accessData, buildLogger, CHANGESET_LIMIT, DEFAULT_TRANSFER_TIMEOUT, FQREF_PREFIXES, i18nResolver, trustedKeyHelper

Constructor Summary

Constructors

Constructor	Description
JGitOperationHelper(GitRepositoryAccessData accessData, @NotNull BuildLogger buildLogger, @NotNull com.atlassian.sal.api.message.I18nResolver i18nResolver, @NotNull TrustedKeyHelper trustedKeyHelper)

Method Summary

Modifier and Type	Method	Description
@NotNull String	checkout(@Nullable File cacheDirectory, @NotNull File sourceDirectory, @NotNull String targetRevision, @Nullable String previousRevision)
@NotNull String	checkout(@Nullable File cacheDirectory, @NotNull File sourceDirectory, @NotNull String targetRevision, @Nullable String previousRevision, boolean fetchLfsFiles)
boolean	checkRevisionExistsInCacheRepository(@NotNull File repositoryDirectory, @NotNull String targetRevision)
@NotNull String	commit(@NotNull File sourceDirectory, @NotNull String message, @NotNull String committerName, @NotNull String committerEmail, boolean stageModifications)
void	createBranch(@NotNull File sourceDirectory, @NotNull String branchName)
void	createLightweightTag(@NotNull File sourceDirectory, @NotNull String tagName, @NotNull String revision)
protected org.eclipse.jgit.lib.Repository	createLocalRepository(File workingDirectory, @Nullable File cacheDirectory)
BuildRepositoryChanges	extractCommits(@NotNull File directory, @Nullable String startingRevision, @Nullable String endingRevision)
BuildRepositoryChanges	extractCommits(File cacheDirectory, @NotNull String startingRevision, String endingRevision, String path)
BuildRepositoryChanges	extractCommitsBetweenBranches(File cacheDirectory, VcsBranch otherBranch, boolean limitChangeList)
void	fetch(@NotNull File sourceDirectory, @NotNull HashAndSource refAndHash, boolean useShallow)
void	fetch(@NotNull File sourceDirectory, @NotNull HashAndSource refAndHash, boolean useShallow, boolean fetchTagsByDefault)
void	fetch(@NotNull File sourceDirectory, @NotNull HashAndSource refAndHash, boolean useShallow, boolean fetchTagsByDefault, boolean fetchLfsFiles)
void	fetch(@NotNull File sourceDirectory, @NotNull String targetRevision, boolean useShallow)
void	fetch(@NotNull File sourceDirectory, @NotNull String targetRevision, boolean useShallow, boolean fetchTagsByDefault)
void	fetch(@NotNull File sourceDirectory, @NotNull String targetRevision, boolean useShallow, boolean fetchTagsByDefault, boolean fetchLfsFiles)
@NotNull Optional<String>	getBranchForSha(@NotNull File sourceDirectory, String revision, String configuredBranch)
@NotNull CommitContext	getCommit(File directory, String targetRevision)	Gets the commit for the revision, given a working directory.
String	getCurrentBranch(@NotNull File checkoutPath)
@NotNull String	getCurrentRevision(@NotNull File sourceDirectory)
@NotNull List<VcsBranch>	getOpenBranches(@NotNull GitRepositoryAccessData repositoryData, File workingDir)
protected String	getRevision(File sourceDirectory, @NotNull String revision)
@Nullable String	getShaOfRefIfExists(@NotNull File sourceDirectory, @NotNull String ref)
List<TagAndRevision>	getTagsForRepository(@NotNull GitRepositoryAccessData accessData)
boolean	isAncestor(@NotNull Path gitWorkspace, @NotNull GitHash rev1, @NotNull GitHash rev2)	Returns true if you can reach rev1 by following parent relationship starting from rev2.
boolean	isClean(@NotNull File sourceDirectory)
boolean	merge(@NotNull File workspaceDir, @NotNull String targetRevision, @NotNull String committerName, @NotNull String committerEmail)
Pair<Boolean,String>	mergeAndReturnHead(@NotNull File workspaceDir, @NotNull String currentRevision, @NotNull String targetRevision, @NotNull String committerName, @NotNull String committerEmail)
@NotNull HashAndSource	obtainLatestRevision()
Optional<GitHash>	obtainLatestRevision(@NotNull File repositoryDirectory, GitRef ref, String path)
void	pushBranchOrTag(@NotNull File sourceDirectory, @NotNull String branchName)
void	pushRevision(@NotNull File sourceDirectory, @NotNull String revision, @Nullable String currentBranch)	Pushes arbitrary revision (refspec?) back to the upstream repo.
void	stageChanges(@NotNull File sourceDirectory, @NotNull Collection<String> filePaths)
protected <E extends Throwable, T> T	withFetchConnection(@NotNull org.eclipse.jgit.lib.Repository repository, @NotNull GitRepositoryAccessData accessData, @NotNull JGitOperationHelper.WithFetchConnectionCallback<E,T> callback)
protected <E extends Throwable, T> T	withFetchConnection(@NotNull org.eclipse.jgit.transport.Transport transport, @NotNull JGitOperationHelper.WithFetchConnectionCallback<E,T> callback)
protected <E extends Throwable, T> T	withTransport(@NotNull org.eclipse.jgit.lib.Repository repository, @NotNull GitRepositoryAccessData accessData, @NotNull JGitOperationHelper.WithTransportCallback<E,T> callback)

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.plugins.git.GitOperationHelper

commit

Field Details

PUSH_IS_NOT_SUPPORTED

@VisibleForTesting
public static final String PUSH_IS_NOT_SUPPORTED

See Also:

• Constant Field Values

Constructor Details

JGitOperationHelper

public JGitOperationHelper(GitRepositoryAccessData accessData,
 @NotNull
 @NotNull BuildLogger buildLogger,
 @NotNull
 @NotNull com.atlassian.sal.api.message.I18nResolver i18nResolver,
 @NotNull
 @NotNull TrustedKeyHelper trustedKeyHelper)

Method Details

commit

@NotNull
public @NotNull String commit(@NotNull
 @NotNull File sourceDirectory,
 @NotNull
 @NotNull String message,
 @NotNull
 @NotNull String committerName,
 @NotNull
 @NotNull String committerEmail,
 boolean stageModifications)
                       throws RepositoryException

Throws:

RepositoryException

stageChanges

public void stageChanges(@NotNull
 @NotNull File sourceDirectory,
 @NotNull
 @NotNull Collection<String> filePaths)
                  throws RepositoryException

Throws:

RepositoryException

merge

public boolean merge(@NotNull
 @NotNull File workspaceDir,
 @NotNull
 @NotNull String targetRevision,
 @NotNull
 @NotNull String committerName,
 @NotNull
 @NotNull String committerEmail)

mergeAndReturnHead

public Pair<Boolean,String> mergeAndReturnHead(@NotNull
 @NotNull File workspaceDir,
 @NotNull
 @NotNull String currentRevision,
 @NotNull
 @NotNull String targetRevision,
 @NotNull
 @NotNull String committerName,
 @NotNull
 @NotNull String committerEmail)
                                        throws RepositoryException

Throws:

RepositoryException

pushRevision

public void pushRevision(@NotNull
 @NotNull File sourceDirectory,
 @NotNull
 @NotNull String revision,
 @Nullable
 @Nullable String currentBranch)
                  throws RepositoryException

Pushes arbitrary revision (refspec?) back to the upstream repo.

Throws:

RepositoryException

pushBranchOrTag

public void pushBranchOrTag(@NotNull
 @NotNull File sourceDirectory,
 @NotNull
 @NotNull String branchName)
                     throws RepositoryException

Throws:

RepositoryException

checkout

@NotNull
public @NotNull String checkout(@Nullable
 @Nullable File cacheDirectory,
 @NotNull
 @NotNull File sourceDirectory,
 @NotNull
 @NotNull String targetRevision,
 @Nullable
 @Nullable String previousRevision,
 boolean fetchLfsFiles)
                         throws RepositoryException

Throws:

RepositoryException

checkout

@NotNull
public @NotNull String checkout(@Nullable
 @Nullable File cacheDirectory,
 @NotNull
 @NotNull File sourceDirectory,
 @NotNull
 @NotNull String targetRevision,
 @Nullable
 @Nullable String previousRevision)
                         throws RepositoryException

Throws:

RepositoryException

fetch

public void fetch(@NotNull
 @NotNull File sourceDirectory,
 @NotNull
 @NotNull String targetRevision,
 boolean useShallow,
 boolean fetchTagsByDefault)
           throws RepositoryException

Throws:

RepositoryException

fetch

public void fetch(@NotNull
 @NotNull File sourceDirectory,
 @NotNull
 @NotNull String targetRevision,
 boolean useShallow,
 boolean fetchTagsByDefault,
 boolean fetchLfsFiles)
           throws RepositoryException

Throws:

RepositoryException

fetch

public void fetch(@NotNull
 @NotNull File sourceDirectory,
 @NotNull
 @NotNull HashAndSource refAndHash,
 boolean useShallow,
 boolean fetchTagsByDefault)
           throws RepositoryException

Throws:

RepositoryException

fetch

public void fetch(@NotNull
 @NotNull File sourceDirectory,
 @NotNull
 @NotNull String targetRevision,
 boolean useShallow)
           throws RepositoryException

Throws:

RepositoryException

fetch

public void fetch(@NotNull
 @NotNull File sourceDirectory,
 @NotNull
 @NotNull HashAndSource refAndHash,
 boolean useShallow)
           throws RepositoryException

Throws:

RepositoryException

fetch

public void fetch(@NotNull
 @NotNull File sourceDirectory,
 @NotNull
 @NotNull HashAndSource refAndHash,
 boolean useShallow,
 boolean fetchTagsByDefault,
 boolean fetchLfsFiles)
           throws RepositoryException

Throws:

RepositoryException

getCurrentRevision

@NotNull
public @NotNull String getCurrentRevision(@NotNull
 @NotNull File sourceDirectory)
                                   throws RepositoryException

Throws:

RepositoryException

getTagsForRepository

public List<TagAndRevision> getTagsForRepository(@NotNull
 @NotNull GitRepositoryAccessData accessData)
                                          throws RepositoryException

Throws:

RepositoryException

getCurrentBranch

public String getCurrentBranch(@NotNull
 @NotNull File checkoutPath)
                        throws RepositoryException

Throws:

RepositoryException

isClean

public boolean isClean(@NotNull
 @NotNull File sourceDirectory)
                throws RepositoryException

Throws:

RepositoryException

getRevision

protected String getRevision(File sourceDirectory,
 @NotNull
 @NotNull String revision)
                      throws RepositoryException

Throws:

RepositoryException

getShaOfRefIfExists

@Nullable
public @Nullable String getShaOfRefIfExists(@NotNull
 @NotNull File sourceDirectory,
 @NotNull
 @NotNull String ref)

obtainLatestRevision

@NotNull
public @NotNull HashAndSource obtainLatestRevision()
                                            throws RepositoryException

Throws:

RepositoryException

getOpenBranches

@NotNull
public @NotNull List<VcsBranch> getOpenBranches(@NotNull
 @NotNull GitRepositoryAccessData repositoryData,
 File workingDir)
                                         throws RepositoryException

Throws:

RepositoryException

checkRevisionExistsInCacheRepository

public boolean checkRevisionExistsInCacheRepository(@NotNull
 @NotNull File repositoryDirectory,
 @NotNull
 @NotNull String targetRevision)
                                             throws IOException,
RepositoryException

Parameters:

repositoryDirectory - directory where repository is fetched

targetRevision - revision to find in repository

Returns:

true if revision found

Throws:

IOException - thrown when revision not found (MissingObjectException)

RepositoryException

extractCommitsBetweenBranches

public BuildRepositoryChanges extractCommitsBetweenBranches(File cacheDirectory,
 VcsBranch otherBranch,
 boolean limitChangeList)

createLocalRepository

protected org.eclipse.jgit.lib.Repository createLocalRepository(File workingDirectory,
 @Nullable
 @Nullable File cacheDirectory)
                                                         throws IOException

Throws:

IOException

extractCommits

public BuildRepositoryChanges extractCommits(@NotNull
 @NotNull File directory,
 @Nullable
 @Nullable String startingRevision,
 @Nullable
 @Nullable String endingRevision)
                                      throws RepositoryException

Throws:

RepositoryException

extractCommits

public BuildRepositoryChanges extractCommits(File cacheDirectory,
 @NotNull
 @NotNull String startingRevision,
 String endingRevision,
 String path)
                                      throws RepositoryException

Throws:

RepositoryException

getBranchForSha

@NotNull
public @NotNull Optional<String> getBranchForSha(@NotNull
 @NotNull File sourceDirectory,
 String revision,
 String configuredBranch)
                                          throws RepositoryException

Returns:

branch that contains sha and matches the name of configuredBranch

Throws:

RepositoryException

obtainLatestRevision

public Optional<GitHash> obtainLatestRevision(@NotNull
 @NotNull File repositoryDirectory,
 GitRef ref,
 String path)

isAncestor

public boolean isAncestor(@NotNull
 @NotNull Path gitWorkspace,
 @NotNull
 @NotNull GitHash rev1,
 @NotNull
 @NotNull GitHash rev2)
                   throws RepositoryException

Description copied from interface: GitOperationHelper

Returns true if you can reach rev1 by following parent relationship starting from rev2.

Throws:

RepositoryException

createBranch

public void createBranch(@NotNull
 @NotNull File sourceDirectory,
 @NotNull
 @NotNull String branchName)
                  throws RepositoryException

Throws:

RepositoryException

createLightweightTag

public void createLightweightTag(@NotNull
 @NotNull File sourceDirectory,
 @NotNull
 @NotNull String tagName,
 @NotNull
 @NotNull String revision)
                          throws RepositoryException

Throws:

RepositoryException

getCommit

@NotNull
public @NotNull CommitContext getCommit(File directory,
 String targetRevision)
                                 throws RepositoryException

Description copied from interface: GitOperationHelper

Gets the commit for the revision, given a working directory.

Throws:

RepositoryException - if the revision can't be found

withTransport

@Nullable
protected <E extends Throwable,
T> T withTransport(@NotNull
 @NotNull org.eclipse.jgit.lib.Repository repository,
 @NotNull
 @NotNull GitRepositoryAccessData accessData,
 @NotNull
 @NotNull JGitOperationHelper.WithTransportCallback<E,T> callback)
                                           throws E,
RepositoryException

Throws:

E extends Throwable

RepositoryException

withFetchConnection

protected <E extends Throwable,
T> T withFetchConnection(@NotNull
 @NotNull org.eclipse.jgit.transport.Transport transport,
 @NotNull
 @NotNull JGitOperationHelper.WithFetchConnectionCallback<E,T> callback)
                                                 throws E,
org.eclipse.jgit.errors.NotSupportedException,
org.eclipse.jgit.errors.TransportException

Throws:

E extends Throwable

org.eclipse.jgit.errors.NotSupportedException

org.eclipse.jgit.errors.TransportException

withFetchConnection

protected <E extends Throwable,
T> T withFetchConnection(@NotNull
 @NotNull org.eclipse.jgit.lib.Repository repository,
 @NotNull
 @NotNull GitRepositoryAccessData accessData,
 @NotNull
 @NotNull JGitOperationHelper.WithFetchConnectionCallback<E,T> callback)
                                                 throws E,
RepositoryException,
org.eclipse.jgit.errors.NotSupportedException,
org.eclipse.jgit.errors.TransportException

Throws:

E extends Throwable

RepositoryException

org.eclipse.jgit.errors.NotSupportedException

org.eclipse.jgit.errors.TransportException