org.jenkinsci.plugins.gitclient

Class JGitAPIImpl

java.lang.Object

org.jenkinsci.plugins.gitclient.JGitAPIImpl

All Implemented Interfaces:

IGitAPI, Serializable, GitClient

public class JGitAPIImpl
extends Object

GitClient pure Java implementation using JGit. Goal is to eventually get a full java implementation for GitClient For internal use only, don't use directly. See Git

See Also:

Serialized Form

Field Summary

Fields

Modifier and Type	Field and Description
protected hudson.ProxyConfiguration	proxy
protected File	workspace

Fields inherited from interface org.jenkinsci.plugins.gitclient.GitClient

CREDENTIALS_MATCHER, quietRemoteBranches, verbose

Method Summary

Modifier and Type	Method and Description
void	add(String filePattern) add.
void	addCredentials(String url, com.cloudbees.plugins.credentials.common.StandardCredentials credentials) Adds credentials to be used against a specific url.
void	addDefaultCredentials(com.cloudbees.plugins.credentials.common.StandardCredentials credentials) Adds credentials to be used when there are not url specific credentials defined.
void	addNote(String note, String namespace) Adds a new git-note on the current HEAD commit.
void	addRemoteUrl(String name, String url) addRemoteUrl.
void	addSubmodule(String remoteURL, String subdir) Create a submodule in subdir child directory for remote repository
void	appendNote(String note, String namespace) Appends to an existing git-note on the current HEAD commit.
void	branch(String name) branch.
ChangelogCommand	changelog() changelog.
void	changelog(String revFrom, String revTo, OutputStream outputStream) changelog.
void	changelog(String revFrom, String revTo, Writer w) Adds the changelog entries for commits in the range revFrom..revTo.
CheckoutCommand	checkout() checkout.
void	checkout(String commit) Checks out the specified commit/tag/branch into the workspace.
void	checkout(String ref, String branch) Creates a new branch that points to the specified ref.
void	checkoutBranch(String branch, String ref) Regardless of the current state of the workspace (whether there is some dirty files, etc) and the state of the repository (whether the branch of the specified name exists or not), when this method exits the following conditions hold: The branch of the specified name branch exists and points to the specified ref HEAD points to branch.
void	clean() clean.
void	clean(boolean cleanSubmodule) clean.
void	clearCredentials() clearCredentials.
CloneCommand	clone_() clone_.
void	clone(RemoteConfig source) Deprecated.
void	clone(RemoteConfig rc, boolean useShallowClone) Deprecated.
void	clone(String url, String origin, boolean useShallowClone, String reference) Clone a remote repository
void	commit(String message) commit.
void	commit(String message, PersonIdent author, PersonIdent committer) commit.
void	deleteBranch(String name) (force) delete a branch.
void	deleteRef(String refName) Deletes a ref.
void	deleteTag(String tagName) deleteTag.
String	describe(String tip) Equivalent of "git-describe --tags".
protected String	extractBranchNameFromBranchSpec(String branchSpec) This method takes a branch specification and normalizes it get unambiguous results.
FetchCommand	fetch_() fetch_.
void	fetch() Deprecated.
void	fetch(RemoteConfig remoteRepository) Deprecated.
void	fetch(String remoteName, RefSpec... refspec) fetch.
void	fetch(String remoteName, RefSpec refspec) fetch.
void	fetch(String repository, String refspec) Deprecated.
void	fetch(URIish url, List<RefSpec> refspecs) Fetch commits from url which match any of the passed in refspecs.
void	fixSubmoduleUrls(String remote, hudson.model.TaskListener listener) Deprecated.
String	getAllLogEntries(String branch) Deprecated.
Set<Branch>	getBranches() getBranches.
List<Branch>	getBranchesContaining(String revspec) Find all the branches that include the given commit.
List<Branch>	getBranchesContaining(String revspec, boolean allBranches) Find all the branches that include the given commit.
Set<Branch>	getBranchesInternal(ListBranchCommand.ListMode mode)
String	getDefaultRemote(String _default_) Deprecated.
Map<String,ObjectId>	getHeadRev(String url) getHeadRev.
ObjectId	getHeadRev(String remoteRepoUrl, String branchSpec) getHeadRev.
Set<String>	getRefNames(String refPrefix) List refs with the given prefix.
Set<Branch>	getRemoteBranches() getRemoteBranches.
Map<String,ObjectId>	getRemoteReferences(String url, String pattern, boolean headsOnly, boolean tagsOnly) List references in a remote repository.
Map<String,String>	getRemoteSymbolicReferences(String url, String pattern) List symbolic references in a remote repository.
Set<String>	getRemoteTagNames(String tagPattern) getRemoteTagNames.
String	getRemoteUrl(String name) From a given repository, get a remote's URL
String	getRemoteUrl(String name, String GIT_DIR) Deprecated.
Repository	getRepository() getRepository.
List<IndexEntry>	getSubmodules(String treeIsh) Finds all the submodule references in this repository at the specified tree.
String	getSubmoduleUrl(String name) Deprecated.
String	getTagMessage(String tagName) getTagMessage.
Set<String>	getTagNames(String tagPattern) getTagNames.
Set<GitObject>	getTags() Return name and object ID of all tags in current repository.
List<Tag>	getTagsOnCommit(String revName) Deprecated.
hudson.FilePath	getWorkTree() getWorkTree.
boolean	hasGitModules() hasGitModules.
boolean	hasGitModules(String treeIsh) Deprecated.
boolean	hasGitRepo() hasGitRepo.
InitCommand	init_() init_.
void	init() init.
boolean	isBareRepository() isBareRepository.
boolean	isBareRepository(String GIT_DIR) Deprecated.
boolean	isCommitInRepo(ObjectId commit) isCommitInRepo.
List<IndexEntry>	lsTree(String treeIsh) This method has been implemented as non-recursive historically, but often that is not what the caller wants.
List<IndexEntry>	lsTree(String treeIsh, boolean recursive) Deprecated.
MergeCommand	merge() merge.
void	merge(ObjectId rev) merge.
void	merge(String refSpec) Deprecated.
ObjectId	mergeBase(ObjectId id1, ObjectId id2) Deprecated.
void	prune(RemoteConfig repository) Prune stale remote tracking branches with "git remote prune" on the specified remote.
PushCommand	push() push.
void	push(RemoteConfig repository, String refspec) Deprecated.
void	push(String remoteName, String refspec) Deprecated.
void	push(URIish url, String refspec) Deprecated.
RebaseCommand	rebase() rebase.
void	ref(String refName) Create (or update) a ref.
boolean	refExists(String refName) Check if a ref exists.
protected org.jenkinsci.plugins.gitclient.RemoteGitImpl	remoteProxyFor(GitClient proxy) remoteProxyFor.
void	reset() Deprecated.
void	reset(boolean hard) Deprecated.
RevListCommand	revList_() revList_.
List<ObjectId>	revList(String ref) revList.
List<ObjectId>	revListAll() revListAll.
List<ObjectId>	revListBranch(String branchId) Deprecated.
ObjectId	revParse(String revName) Retrieve commit object that is direct child for revName revision reference.
void	setAuthor(PersonIdent p) setAuthor.
void	setAuthor(String name, String email) Sets the identity of the author for future commits and merge operations.
void	setCommitter(PersonIdent p) setCommitter.
void	setCommitter(String name, String email) Sets the identity of the committer for future commits and merge operations.
void	setCredentials(com.cloudbees.plugins.credentials.common.StandardUsernameCredentials cred) setCredentials.
void	setCredentialsProvider(CredentialsProvider prov) setCredentialsProvider.
void	setProxy(hudson.ProxyConfiguration proxy) setProxy.
void	setRemoteUrl(String name, String url) For a given repository, set a remote's URL
void	setRemoteUrl(String name, String url, String GIT_DIR) Deprecated.
void	setSubmoduleUrl(String name, String url) Deprecated.
void	setupSubmoduleUrls(Revision rev, hudson.model.TaskListener listener) Deprecated.
void	setupSubmoduleUrls(String remote, hudson.model.TaskListener listener) Deprecated.
List<String>	showRevision(ObjectId r) Given a Revision, show it as if it were an entry from git whatchanged, so that it can be parsed by GitChangeLogParser.
List<String>	showRevision(ObjectId from, ObjectId to) Given a Revision, show it as if it were an entry from git whatchanged, so that it can be parsed by GitChangeLogParser.
List<String>	showRevision(ObjectId from, ObjectId to, Boolean useRawOutput) Given a Revision, show it as if it were an entry from git whatchanged, so that it can be parsed by GitChangeLogParser.
List<String>	showRevision(Revision r) Deprecated.
GitClient	subGit(String subdir) subGit.
void	submoduleClean(boolean recursive) submoduleClean.
void	submoduleInit() Deprecated.
void	submoduleSync() Deprecated.
SubmoduleUpdateCommand	submoduleUpdate() Update submodules.
void	submoduleUpdate(boolean recursive) Run submodule update optionally recursively on all submodules (equivalent of git submodule update --recursive.)
void	submoduleUpdate(boolean recursive, boolean remoteTracking) Run submodule update optionally recursively on all submodules, optionally with remoteTracking submodules (equivalent of git submodule update --recursive --remote.)
void	submoduleUpdate(boolean recursive, boolean remoteTracking, String reference) Run submodule update optionally recursively on all submodules, optionally with remoteTracking, with a specific reference passed to git clone if needing to --init.
void	submoduleUpdate(boolean recursive, String reference) Run submodule update optionally recursively on all submodules, with a specific reference passed to git clone if needing to --init.
void	tag(String name, String message) Create (or update) a tag.
boolean	tagExists(String tagName) tagExists.
<T> T	withRepository(RepositoryCallback<T> callable) Runs the computation that requires local access to Repository.
protected Object	writeReplace() When sent to remote, switch to the proxy.

Methods inherited from class java.lang.Object

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

Methods inherited from interface hudson.plugins.git.IGitAPI

changelog, checkoutBranch

Methods inherited from interface org.jenkinsci.plugins.gitclient.GitClient

changelog, checkout, checkout, clone, commit, merge, setAuthor, setCommitter, setCredentials, setProxy, submoduleUpdate, submoduleUpdate, submoduleUpdate, submoduleUpdate, withRepository

Field Detail

workspace

protected final File workspace

proxy

protected hudson.ProxyConfiguration proxy

Method Detail

clearCredentials

public void clearCredentials()

clearCredentials.

addCredentials

public void addCredentials(String url,
                           com.cloudbees.plugins.credentials.common.StandardCredentials credentials)

Adds credentials to be used against a specific url.

Parameters:

url - the url for the credentials to be used against.

credentials - the credentials to use.

addDefaultCredentials

public void addDefaultCredentials(com.cloudbees.plugins.credentials.common.StandardCredentials credentials)

Adds credentials to be used when there are not url specific credentials defined.

Parameters:

credentials - the credentials to use.

See Also:

GitClient.addCredentials(String, com.cloudbees.plugins.credentials.common.StandardCredentials)

setCredentialsProvider

public void setCredentialsProvider(CredentialsProvider prov)

setCredentialsProvider.

Parameters:

prov - a CredentialsProvider object.

subGit

public GitClient subGit(String subdir)

subGit.

Parameters:

subdir - a String object.

Returns:

a IGitAPI implementation to manage git submodule repository

setAuthor

public void setAuthor(String name,
                      String email)
               throws GitException

Sets the identity of the author for future commits and merge operations.

Parameters:

name - a String object.

email - a String object.

Throws:

GitException - if underlying git operation fails.

setCommitter

public void setCommitter(String name,
                         String email)
                  throws GitException

Sets the identity of the committer for future commits and merge operations.

Parameters:

name - a String object.

email - a String object.

Throws:

GitException - if underlying git operation fails.

init

public void init()
          throws GitException,
                 InterruptedException

init.

Throws:

GitException - if underlying git operation fails.

InterruptedException - if interrupted.

checkout

public CheckoutCommand checkout()

checkout.

Returns:

a CheckoutCommand object.

add

public void add(String filePattern)
         throws GitException

add.

Parameters:

filePattern - a String object.

Throws:

GitException - if underlying git operation fails.

commit

public void commit(String message)
            throws GitException

commit.

Parameters:

message - a String object.

Throws:

GitException - if underlying git operation fails.

branch

public void branch(String name)
            throws GitException

branch.

Parameters:

name - a String object.

Throws:

GitException - if underlying git operation fails.

deleteBranch

public void deleteBranch(String name)
                  throws GitException

(force) delete a branch.

Parameters:

name - a String object.

Throws:

GitException - if underlying git operation fails.

getBranches

public Set<Branch> getBranches()
                        throws GitException

getBranches.

Returns:

a Set object.

Throws:

GitException - if underlying git operation fails.

getRemoteBranches

public Set<Branch> getRemoteBranches()
                              throws GitException

getRemoteBranches.

Returns:

a Set object.

Throws:

GitException - if underlying git operation fails.

getBranchesInternal

public Set<Branch> getBranchesInternal(ListBranchCommand.ListMode mode)
                                throws GitException

Throws:

GitException

tag

public void tag(String name,
                String message)
         throws GitException

Create (or update) a tag. If tag already exist it gets updated (equivalent to git tag --force)

Parameters:

name - a String object.

message - a String object.

Throws:

GitException - if underlying git operation fails.

tagExists

public boolean tagExists(String tagName)
                  throws GitException

tagExists.

Parameters:

tagName - a String object.

Returns:

true if tag exists in repository

Throws:

GitException - if underlying git operation fails.

fetch_

public FetchCommand fetch_()

fetch_.

Returns:

a FetchCommand object.

fetch

public void fetch(URIish url,
                  List<RefSpec> refspecs)
           throws GitException,
                  InterruptedException

Fetch commits from url which match any of the passed in refspecs. Assumes remote.remoteName.url has been set.

Parameters:

url - a URIish object.

refspecs - a List object.

Throws:

GitException - if any.

InterruptedException - if any.

fetch

public void fetch(String remoteName,
                  RefSpec... refspec)
           throws GitException

fetch.

Parameters:

remoteName - a String object.

refspec - a RefSpec object.

Throws:

GitException - if underlying git operation fails.

fetch

public void fetch(String remoteName,
                  RefSpec refspec)
           throws GitException

fetch.

Parameters:

remoteName - a String object.

refspec - a RefSpec object.

Throws:

GitException - if underlying git operation fails.

ref

public void ref(String refName)
         throws GitException,
                InterruptedException

Create (or update) a ref. The ref will reference HEAD (equivalent to git update-ref ... HEAD).

Parameters:

refName - the full name of the ref (e.g. "refs/myref"). Spaces will be replaced with underscores.

Throws:

GitException - if underlying git operation fails.

InterruptedException - if interrupted.

refExists

public boolean refExists(String refName)
                  throws GitException,
                         InterruptedException

Check if a ref exists. Equivalent to comparing the return code of git show-ref to zero.

Parameters:

refName - the full name of the ref (e.g. "refs/myref"). Spaces will be replaced with underscores.

Returns:

True if the ref exists, false otherwse.

Throws:

GitException - if underlying git operation fails.

InterruptedException - if interrupted.

deleteRef

public void deleteRef(String refName)
               throws GitException,
                      InterruptedException

Deletes a ref. Has no effect if the ref does not exist, equivalent to git update-ref -d.

Parameters:

refName - the full name of the ref (e.g. "refs/myref"). Spaces will be replaced with underscores.

Throws:

GitException - if underlying git operation fails.

InterruptedException - if interrupted.

getRefNames

public Set<String> getRefNames(String refPrefix)
                        throws GitException,
                               InterruptedException

List refs with the given prefix. Equivalent to git for-each-ref --format="%(refname)".

Parameters:

refPrefix - the literal prefix any ref returned will have. The empty string implies all.

Returns:

a set of refs, each beginning with the given prefix. Empty if none.

Throws:

GitException - if underlying git operation fails.

InterruptedException - if interrupted.

getHeadRev

public Map<String,ObjectId> getHeadRev(String url)
                                throws GitException,
                                       InterruptedException

getHeadRev.

Parameters:

url - a String object.

Returns:

a Map object.

Throws:

GitException - if underlying git operation fails.

InterruptedException - if interrupted.

getRemoteReferences

public Map<String,ObjectId> getRemoteReferences(String url,
                                                String pattern,
                                                boolean headsOnly,
                                                boolean tagsOnly)
                                         throws GitException,
                                                InterruptedException

List references in a remote repository. Equivalent to git ls-remote [--heads] [--tags] <repository> [<refs>].

Parameters:

url - Remote repository URL.

pattern - Only references matching the given pattern are displayed.

headsOnly - Limit to only refs/heads.

tagsOnly - Limit to only refs/tags. headsOnly and tagsOnly are not mutually exclusive; when both are true, references stored in refs/heads and refs/tags are displayed.

Returns:

a map of reference names and their commit hashes. Empty if none.

Throws:

GitException - if underlying git operation fails.

InterruptedException - if interrupted.

getRemoteSymbolicReferences

public Map<String,String> getRemoteSymbolicReferences(String url,
                                                      String pattern)
                                               throws GitException,
                                                      InterruptedException

Description copied from interface: GitClient

List symbolic references in a remote repository. Equivalent to git ls-remote --symref <repository> [<refs>]. Note: the response may be empty for multiple reasons

Parameters:

url - Remote repository URL.

pattern - Only references matching the given pattern are displayed.

Returns:

a map of reference names and their underlying references. Empty if none or if the remote does not report symbolic references (i.e. Git 1.8.4 or earlier) or if the client does not support reporting symbolic references (e.g. command line Git prior to 2.8.0).

Throws:

GitException - if underlying git operation fails.

InterruptedException - if interrupted.

getHeadRev

public ObjectId getHeadRev(String remoteRepoUrl,
                           String branchSpec)
                    throws GitException

getHeadRev.

Parameters:

remoteRepoUrl - a String object.

branchSpec - a String object.

Returns:

a ObjectId object.

Throws:

GitException - if underlying git operation fails.

getRemoteUrl

public String getRemoteUrl(String name)
                    throws GitException

From a given repository, get a remote's URL

Parameters:

name - The name of the remote (e.g. origin)

Returns:

a String object.

Throws:

GitException - if executing the git command fails

getRepository

@NonNull
public Repository getRepository()
                                  throws GitException

getRepository.

Returns:

a Repository object.

Throws:

GitException - if underlying git operation fails.

getWorkTree

public hudson.FilePath getWorkTree()

getWorkTree.

Returns:

a FilePath object.

setRemoteUrl

public void setRemoteUrl(String name,
                         String url)
                  throws GitException

For a given repository, set a remote's URL

Parameters:

name - The name of the remote (e.g. origin)

url - The new value of the remote's URL

Throws:

GitException - if executing the git command fails

addRemoteUrl

public void addRemoteUrl(String name,
                         String url)
                  throws GitException,
                         InterruptedException

addRemoteUrl.

Parameters:

name - a String object.

url - a String object.

Throws:

GitException - if underlying git operation fails.

InterruptedException - if interrupted.

addNote

public void addNote(String note,
                    String namespace)
             throws GitException

Adds a new git-note on the current HEAD commit.

Parameters:

note - Content of the note.

namespace - If unqualified, interpreted as "refs/notes/NAMESPACE" just like cgit.

Throws:

GitException - if underlying git operation fails.

appendNote

public void appendNote(String note,
                       String namespace)
                throws GitException

Appends to an existing git-note on the current HEAD commit. If a note doesn't exist, it works just like GitClient.addNote(String, String)

Parameters:

note - Content of the note.

namespace - If unqualified, interpreted as "refs/notes/NAMESPACE" just like cgit.

Throws:

GitException - if underlying git operation fails.

changelog

public ChangelogCommand changelog()

changelog.

Returns:

a ChangelogCommand object.

clean

public void clean(boolean cleanSubmodule)
           throws GitException

clean.

Parameters:

cleanSubmodule - flag to add extra -f

Throws:

GitException - if underlying git operation fails.

clean

public void clean()
           throws GitException

clean.

Throws:

GitException - if underlying git operation fails.

clone_

public CloneCommand clone_()

clone_.

Returns:

a CloneCommand object.

merge

public MergeCommand merge()

merge.

Returns:

a MergeCommand object.

init_

public InitCommand init_()

init_.

Returns:

a InitCommand object.

rebase

public RebaseCommand rebase()

Description copied from interface: GitClient

rebase.

Returns:

a RebaseCommand object.

deleteTag

public void deleteTag(String tagName)
               throws GitException

deleteTag.

Parameters:

tagName - a String object.

Throws:

GitException - if underlying git operation fails.

getTagMessage

public String getTagMessage(String tagName)
                     throws GitException

getTagMessage.

Parameters:

tagName - a String object.

Returns:

a String object.

Throws:

GitException - if underlying git operation fails.

getSubmodules

public List<IndexEntry> getSubmodules(String treeIsh)
                               throws GitException

Finds all the submodule references in this repository at the specified tree.

Parameters:

treeIsh - a String object.

Returns:

never null.

Throws:

GitException - if underlying git operation fails.

addSubmodule

public void addSubmodule(String remoteURL,
                         String subdir)
                  throws GitException

Create a submodule in subdir child directory for remote repository

Parameters:

remoteURL - a String object.

subdir - a String object.

Throws:

GitException - if underlying git operation fails.

getTagNames

public Set<String> getTagNames(String tagPattern)
                        throws GitException

getTagNames.

Parameters:

tagPattern - a String object.

Returns:

a Set object.

Throws:

GitException - if underlying git operation fails.

getRemoteTagNames

public Set<String> getRemoteTagNames(String tagPattern)
                              throws GitException

getRemoteTagNames.

Parameters:

tagPattern - a String object.

Returns:

a Set object.

Throws:

GitException - if underlying git operation fails.

hasGitRepo

public boolean hasGitRepo()
                   throws GitException

hasGitRepo.

Returns:

true if this workspace has a git repository

Throws:

GitException - if underlying git operation fails.

isCommitInRepo

public boolean isCommitInRepo(ObjectId commit)
                       throws GitException

isCommitInRepo.

Parameters:

commit - a ObjectId object.

Returns:

true if commit is in repository

Throws:

GitException - if underlying git operation fails.

prune

public void prune(RemoteConfig repository)
           throws GitException

Prune stale remote tracking branches with "git remote prune" on the specified remote.

Parameters:

repository - a RemoteConfig object.

Throws:

GitException - if underlying git operation fails.

push

public PushCommand push()

push.

Returns:

a PushCommand object.

revList_

public RevListCommand revList_()

revList_.

Returns:

a RevListCommand object.

revListAll

public List<ObjectId> revListAll()
                          throws GitException

revListAll.

Returns:

a List object.

Throws:

GitException - if underlying git operation fails.

revList

public List<ObjectId> revList(String ref)
                       throws GitException

revList.

Parameters:

ref - a String object.

Returns:

a List object.

Throws:

GitException - if underlying git operation fails.

revParse

public ObjectId revParse(String revName)
                  throws GitException

Retrieve commit object that is direct child for revName revision reference.

Parameters:

revName - a commit sha1 or tag/branch refname

Returns:

a ObjectId object.

Throws:

GitException - when no such commit / revName is found in repository.

showRevision

public List<String> showRevision(ObjectId from,
                                 ObjectId to)
                          throws GitException

Given a Revision, show it as if it were an entry from git whatchanged, so that it can be parsed by GitChangeLogParser.

Changes are computed on the [from..to] range. If from is null, this prints just one commit that to represents.

For merge commit, this method reports one diff per each parent. This makes this method behave differently from GitClient.changelog().

Parameters:

from - a ObjectId object.

to - a ObjectId object.

Returns:

The git whatchanged output, in raw format.

Throws:

GitException - if underlying git operation fails.

showRevision

public List<String> showRevision(ObjectId from,
                                 ObjectId to,
                                 Boolean useRawOutput)
                          throws GitException

Given a Revision, show it as if it were an entry from git whatchanged, so that it can be parsed by GitChangeLogParser.

If useRawOutput is true, the '--raw' option will include commit file information to be passed to the GitChangeLogParser.

Changes are computed on the [from..to] range. If from is null, this prints just one commit that to represents.

For merge commit, this method reports one diff per each parent. This makes this method behave differently from GitClient.changelog().

Parameters:

from - a ObjectId object.

to - a ObjectId object.

useRawOutput - a {java.lang.Boolean} object.

Returns:

The git whatchanged output, in raw format.

Throws:

GitException - if underlying git operation fails.

submoduleClean

public void submoduleClean(boolean recursive)
                    throws GitException

submoduleClean.

Parameters:

recursive - a boolean.

Throws:

GitException - if underlying git operation fails.

submoduleUpdate

public SubmoduleUpdateCommand submoduleUpdate()

Update submodules.

Returns:

a SubmoduleUpdateCommand object.

merge

@Deprecated
public void merge(String refSpec)
                       throws GitException,
                              InterruptedException

Deprecated.

Merge commits from revspec into the current branch.

Parameters:

refSpec - the revision specification to be merged (for example, origin/master)

Throws:

GitException - if underlying git operation fails.

InterruptedException - if interrupted.

push

@Deprecated
public void push(RemoteConfig repository,
                             String refspec)
                      throws GitException,
                             InterruptedException

Deprecated.

Push revspec to repository.

Parameters:

repository - git repository to receive commits

refspec - commits to be pushed

Throws:

GitException - if underlying git operating fails

InterruptedException - if interrupted

getBranchesContaining

public List<Branch> getBranchesContaining(String revspec)
                                   throws GitException,
                                          InterruptedException

Find all the branches that include the given commit.

Parameters:

revspec - substring to be searched for branch name

Returns:

list of branches containing revspec

Throws:

GitException - on failure

InterruptedException - if interrupted

getBranchesContaining

public List<Branch> getBranchesContaining(String revspec,
                                          boolean allBranches)
                                   throws GitException,
                                          InterruptedException

Find all the branches that include the given commit. "git branch --contains=X" is a pretty plain traversal. We walk the commit graph until we find the target revision we want. Doing this individually for every branch is too expensive, so we use flags to track multiple branches at once. JGit gives us 24 bits of flags, so we divide up all the branches to batches of 24, then perform a graph walk. For flags to carry correctly over from children to parents, all the children must be visited before we see the parent. This requires a topological sorting order. In addition, we want kind of a "breadth first search" to avoid going down a part of the graph that's not terribly interesting and topo sort helps with that, too (imagine the following commit graph, and compute "git branch --contains=t"; we don't want to visit all the way to c1 before visiting c.) INIT -> c1 -> c2 -> ... long history of commits --+--> c1000 --+--> branch1 | | --> t ------

Since we reuse RevWalk, it'd be nice to flag commits reachable from 't' as uninteresting and keep them across resets, but I'm not sure how to do it.

Parameters:

revspec - commit id to query for

allBranches - whether remote branches should be also queried (true) or not (false)

Returns:

list of branches the specified commit belongs to

Throws:

GitException - on Git exceptions

InterruptedException - on thread interruption

mergeBase

@Deprecated
public ObjectId mergeBase(ObjectId id1,
                                      ObjectId id2)
                               throws InterruptedException

Deprecated.

mergeBase.

Parameters:

id1 - a ObjectId object.

id2 - a ObjectId object.

Returns:

a ObjectId object.

Throws:

InterruptedException - if interrupted.

getAllLogEntries

@Deprecated
public String getAllLogEntries(String branch)
                                    throws InterruptedException

Deprecated.

This method makes no sense, in that it lists all log entries across all refs and yet it takes a meaningless 'branch' parameter. Please do not use this.

Parameters:

branch - a String object.

Returns:

a String object.

Throws:

InterruptedException - if interrupted.

submoduleInit

@Deprecated
public void submoduleInit()
                               throws GitException,
                                      InterruptedException

Deprecated.

submoduleInit.

Throws:

GitException - if underlying git operation fails.

InterruptedException - if interrupted.

submoduleSync

@Deprecated
public void submoduleSync()
                               throws GitException,
                                      InterruptedException

Deprecated.

submoduleSync.

Throws:

GitException - if underlying git operation fails.

InterruptedException - if interrupted.

getSubmoduleUrl

@Deprecated
public String getSubmoduleUrl(String name)
                                   throws GitException,
                                          InterruptedException

Deprecated.

Returns URL of the named submodule.

Parameters:

name - submodule name whose URL will be returned

Returns:

URL of the named submodule

Throws:

GitException - if underlying git operation fails.

InterruptedException - if interrupted.

setSubmoduleUrl

@Deprecated
public void setSubmoduleUrl(String name,
                                        String url)
                                 throws GitException,
                                        InterruptedException

Deprecated.

Sets URL of the named submodule.

Parameters:

name - submodule name whose URL will be set

url - URL for the named submodule

Throws:

GitException - if underlying git operation fails.

InterruptedException - if interrupted.

setupSubmoduleUrls

@Deprecated
public void setupSubmoduleUrls(Revision rev,
                                           hudson.model.TaskListener listener)
                                    throws GitException

Deprecated.

Set up submodule URLs so that they correspond to the remote pertaining to the revision that has been checked out. I don't think anyone is using this method, and I don't think we ever need to implement this. This kind of logic doesn't belong here, as it lacks generality. It should be whoever manipulating Git.

Parameters:

rev - a Revision object.

listener - a TaskListener object.

Throws:

GitException - if underlying git operation fails.

fixSubmoduleUrls

@Deprecated
public void fixSubmoduleUrls(String remote,
                                         hudson.model.TaskListener listener)
                                  throws GitException,
                                         InterruptedException

Deprecated.

fixSubmoduleUrls. I don't think anyone is using this method, and I don't think we ever need to implement this. This kind of logic doesn't belong here, as it lacks generality. It should be whoever manipulating Git.

Parameters:

remote - a String object.

listener - a TaskListener object.

Throws:

GitException - if underlying git operation fails.

InterruptedException - if interrupted.

describe

public String describe(String tip)
                throws GitException,
                       InterruptedException

Equivalent of "git-describe --tags". Find a nearby tag (including unannotated ones) and come up with a short identifier to describe the tag. This implementation is based on my reading of the cgit source code at https://github.com/git/git/blob/master/builtin/describe.c

The basic structure of the algorithm is as follows. We walk the commit graph, find tags, and mark commits that are reachable from those tags. The marking uses flags given by JGit, so there's a fairly small upper bound in the number of tags we can keep track of.

As we walk commits, we count commits that each tag doesn't contain. We call it "depth", following the variable name in C Git. As we walk further and find enough tags, we go into wind-down mode and only walk to the point of accurately determining all the depths.

Parameters:

tip - a String object.

Returns:

a String object.

Throws:

GitException - if underlying git operation fails.

InterruptedException - if interrupted.

lsTree

@Deprecated
public List<IndexEntry> lsTree(String treeIsh,
                                           boolean recursive)
                                    throws GitException,
                                           InterruptedException

Deprecated.

lsTree.

Parameters:

treeIsh - a String object.

recursive - a boolean.

Returns:

a List object.

Throws:

GitException - if underlying git operation fails.

InterruptedException - if interrupted.

reset

@Deprecated
public void reset(boolean hard)
                       throws GitException,
                              InterruptedException

Deprecated.

Reset the contents of the working directory of this repository. Refer to git reset documentation.

Parameters:

hard - reset as though "--hard" were passed to "git reset"

Throws:

GitException - if underlying git operation fails.

InterruptedException - if interrupted.

isBareRepository

@Deprecated
public boolean isBareRepository(String GIT_DIR)
                                     throws GitException,
                                            InterruptedException

Deprecated.

Detect whether a repository at the given path is bare or not.

Parameters:

GIT_DIR - The path to the repository (must be to .git dir).

Returns:

true if this repository is bare

Throws:

GitException - on failure

InterruptedException - if interrupted

getDefaultRemote

@Deprecated
public String getDefaultRemote(String _default_)
                                    throws GitException,
                                           InterruptedException

Deprecated.

Returns name of default remote.

Parameters:

_default_ - value to return if no remote is defined in this repository

Returns:

name of default remote

Throws:

GitException - if underlying git operation fails.

InterruptedException - if interrupted.

setRemoteUrl

@Deprecated
public void setRemoteUrl(String name,
                                     String url,
                                     String GIT_DIR)
                              throws GitException,
                                     InterruptedException

Deprecated.

Set remote repository name and URL.

Parameters:

name - name for the remote repository, for examnple, "origin"

url - URL for the remote repository, for example git://github.com/jenkinsci/git-client-plugin.git

GIT_DIR - directory containing git repository

Throws:

GitException - if underlying git operation fails.

InterruptedException - if interrupted.

getRemoteUrl

@Deprecated
public String getRemoteUrl(String name,
                                       String GIT_DIR)
                                throws GitException,
                                       InterruptedException

Deprecated.

Returns URL of remote name in repository GIT_DIR.

Parameters:

name - name for the remote repository, for examnple, "origin"

GIT_DIR - directory containing git repository

Returns:

URL of remote "name" in repository GIT_DIR.

Throws:

GitException - if underlying git operation fails.

InterruptedException - if interrupted.

getTags

public Set<GitObject> getTags()
                       throws GitException,
                              InterruptedException

Return name and object ID of all tags in current repository.

Returns:

set of tags in current repository

Throws:

GitException - on Git exceptions

InterruptedException - on thread interruption

isBareRepository

public boolean isBareRepository()
                         throws GitException,
                                InterruptedException

isBareRepository.

Specified by:

isBareRepository in interface IGitAPI

Returns:

true if this repository is a bare repository

Throws:

GitException - if underlying git operation fails.

InterruptedException - if interrupted.

hasGitModules

@Deprecated
public boolean hasGitModules(String treeIsh)
                                  throws GitException

Deprecated.

Returns true if this repository has submodules.

Specified by:

hasGitModules in interface IGitAPI

Parameters:

treeIsh - an ignored argument, kept for compatibility

Returns:

true if this repository has submodules (git modules file)

Throws:

GitException - if underlying git operation fails.

See Also:

GitClient.hasGitModules()

setupSubmoduleUrls

@Deprecated
public void setupSubmoduleUrls(String remote,
                                           hudson.model.TaskListener listener)
                                    throws GitException,
                                           InterruptedException

Deprecated.

Specified by:

setupSubmoduleUrls in interface IGitAPI

Throws:

GitException

InterruptedException

fetch

@Deprecated
public void fetch(String repository,
                              String refspec)
                       throws GitException,
                              InterruptedException

Deprecated.

Retrieve commits based on refspec from repository.

Specified by:

fetch in interface IGitAPI

Parameters:

repository - URL of the repository to be retrieved

refspec - definition of mapping from remote refs to local refs

Throws:

GitException - if underlying git operation fails.

InterruptedException - if interrupted.

fetch

@Deprecated
public void fetch(RemoteConfig remoteRepository)
                       throws InterruptedException

Deprecated.

Retrieve commits from RemoteConfig.

Specified by:

fetch in interface IGitAPI

Parameters:

remoteRepository - remote configuration from which refs will be retrieved

Throws:

InterruptedException - if interrupted.

fetch

@Deprecated
public void fetch()
                       throws GitException,
                              InterruptedException

Deprecated.

fetch.

Specified by:

fetch in interface IGitAPI

Throws:

GitException - if underlying git operation fails.

InterruptedException - if interrupted.

reset

@Deprecated
public void reset()
                       throws GitException,
                              InterruptedException

Deprecated.

reset.

Specified by:

reset in interface IGitAPI

Throws:

GitException - if underlying git operation fails.

InterruptedException - if interrupted.

push

@Deprecated
public void push(URIish url,
                             String refspec)
                      throws GitException,
                             InterruptedException

Deprecated.

push.

Specified by:

push in interface GitClient

Parameters:

url - a URIish object.

refspec - a String object.

Throws:

GitException - if underlying git operation fails.

InterruptedException - if interrupted.

push

@Deprecated
public void push(String remoteName,
                             String refspec)
                      throws GitException,
                             InterruptedException

Deprecated.

push.

Specified by:

push in interface GitClient

Parameters:

remoteName - a String object.

refspec - a String object.

Throws:

GitException - if underlying git operation fails.

InterruptedException - if interrupted.

clone

@Deprecated
public void clone(RemoteConfig source)
                       throws GitException,
                              InterruptedException

Deprecated.

Clone repository from source to this repository.

Specified by:

clone in interface IGitAPI

Parameters:

source - remote repository to be cloned

Throws:

GitException - if underlying git operation fails.

InterruptedException - if interrupted.

clone

@Deprecated
public void clone(RemoteConfig rc,
                              boolean useShallowClone)
                       throws GitException,
                              InterruptedException

Deprecated.

Clone repository from RemoteConfig rc to this repository.

Specified by:

clone in interface IGitAPI

Parameters:

rc - the remote config for the remote repository

useShallowClone - if true, use a shallow clone

Throws:

GitException - if underlying git operation fails.

InterruptedException - if interrupted.

revListBranch

@Deprecated
public List<ObjectId> revListBranch(String branchId)
                                         throws GitException,
                                                InterruptedException

Deprecated.

revListBranch.

Specified by:

revListBranch in interface IGitAPI

Parameters:

branchId - a String object.

Returns:

a List object.

Throws:

GitException - if underlying git operation fails.

InterruptedException - if interrupted.

showRevision

@Deprecated
public List<String> showRevision(Revision r)
                                      throws GitException,
                                             InterruptedException

Deprecated.

showRevision.

Specified by:

showRevision in interface IGitAPI

Parameters:

r - a Revision object.

Returns:

a List object.

Throws:

GitException - if underlying git operation fails.

InterruptedException - if interrupted.

getTagsOnCommit

@Deprecated
public List<Tag> getTagsOnCommit(String revName)
                                      throws GitException,
                                             IOException

Deprecated.

getTagsOnCommit.

Specified by:

getTagsOnCommit in interface IGitAPI

Parameters:

revName - a String object.

Returns:

a List object.

Throws:

GitException - if underlying git operation fails.

IOException - if any IO failure

lsTree

public final List<IndexEntry> lsTree(String treeIsh)
                              throws GitException,
                                     InterruptedException

This method has been implemented as non-recursive historically, but often that is not what the caller wants.

Specified by:

lsTree in interface IGitAPI

Parameters:

treeIsh - string representation of a treeIsh item

Returns:

list of IndexEntry items starting at treeIsh

Throws:

GitException - on failure

InterruptedException - if interrupted

writeReplace

protected Object writeReplace()
                       throws ObjectStreamException

When sent to remote, switch to the proxy.

Returns:

a Object object.

Throws:

ObjectStreamException - if current channel is null

hasGitModules

public boolean hasGitModules()
                      throws GitException

hasGitModules.

Specified by:

hasGitModules in interface GitClient

Returns:

true if this repositor has one or more submodules

Throws:

GitException - if underlying git operation fails.

showRevision

public List<String> showRevision(ObjectId r)
                          throws GitException,
                                 InterruptedException

Given a Revision, show it as if it were an entry from git whatchanged, so that it can be parsed by GitChangeLogParser.

Changes are computed on the [from..to] range. If from is null, this prints just one commit that to represents.

For merge commit, this method reports one diff per each parent. This makes this method behave differently from GitClient.changelog().

Specified by:

showRevision in interface GitClient

Parameters:

r - a ObjectId object.

Returns:

The git whatchanged output, in raw format.

Throws:

GitException - if underlying git operation fails.

InterruptedException - if interrupted.

extractBranchNameFromBranchSpec

protected String extractBranchNameFromBranchSpec(String branchSpec)

This method takes a branch specification and normalizes it get unambiguous results. This is the case when using "refs/heads/"

TODO: Currently only for specs starting with "refs/heads/" the implementation is correct. All others branch specs should also be normalized to "refs/heads/" in order to get unambiguous results. To achieve this it is necessary to identify remote names in the branch spec and to discuss how to handle clashes (e.g. "remoteName/master" for branch "master" (refs/heads/master) in remote "remoteName" and branch "remoteName/master" (refs/heads/remoteName/master)).

Existing behavior is intentionally being retained so that current use cases are not disrupted by a behavioral change.

E.g.

Branch Spec Normalization Examples

branch spec	normalized
master	master*
feature1	feature1*
feature1/master	master feature1/master*
origin/master	master*
repo2/feature1	feature1*
refs/heads/feature1	refs/heads/feature1
origin/namespaceA/fix15	fix15 namespaceA/fix15*
refs/heads/namespaceA/fix15	refs/heads/namespaceA/fix15
remotes/origin/namespaceA/fix15	refs/heads/namespaceA/fix15

*) TODO: Normalize to "refs/heads/"

Parameters:

branchSpec - a String object.

Returns:

normalized branch name

withRepository

public <T> T withRepository(RepositoryCallback<T> callable)
                     throws IOException,
                            InterruptedException

Runs the computation that requires local access to Repository.

Specified by:

withRepository in interface GitClient

Type Parameters:

T - type for the repository callback

Parameters:

callable - the repository callback used as closure to instance

Returns:

a T object.

Throws:

IOException - in case of IO error

InterruptedException - if interrupted

commit

public void commit(String message,
                   PersonIdent author,
                   PersonIdent committer)
            throws GitException,
                   InterruptedException

commit.

Specified by:

commit in interface GitClient

Parameters:

message - a String object.

author - a PersonIdent object.

committer - a PersonIdent object.

Throws:

GitException - if underlying git operation fails.

InterruptedException - if interrupted.

setAuthor

public void setAuthor(PersonIdent p)

setAuthor.

Specified by:

setAuthor in interface GitClient

Parameters:

p - a PersonIdent object.

setCommitter

public void setCommitter(PersonIdent p)

setCommitter.

Specified by:

setCommitter in interface GitClient

Parameters:

p - a PersonIdent object.

changelog

public void changelog(String revFrom,
                      String revTo,
                      OutputStream outputStream)
               throws GitException,
                      InterruptedException

changelog.

Specified by:

changelog in interface GitClient

Parameters:

revFrom - a String object.

revTo - a String object.

outputStream - a OutputStream object.

Throws:

GitException - if underlying git operation fails.

InterruptedException - if interrupted.

changelog

public void changelog(String revFrom,
                      String revTo,
                      Writer w)
               throws GitException,
                      InterruptedException

Adds the changelog entries for commits in the range revFrom..revTo. This is just a short cut for calling GitClient.changelog() with appropriate parameters.

Specified by:

changelog in interface GitClient

Parameters:

revFrom - a String object.

revTo - a String object.

w - a Writer object.

Throws:

GitException - if underlying git operation fails.

InterruptedException - if interrupted.

clone

public void clone(String url,
                  String origin,
                  boolean useShallowClone,
                  String reference)
           throws GitException,
                  InterruptedException

Clone a remote repository

Specified by:

clone in interface GitClient

Parameters:

url - URL for remote repository to clone

origin - upstream track name, defaults to origin by convention

useShallowClone - option to create a shallow clone, that has some restriction but will make clone operation

reference - (optional) reference to a local clone for faster clone operations (reduce network and local storage costs)

Throws:

GitException - if underlying git operation fails.

InterruptedException - if interrupted.

checkout

public void checkout(String commit)
              throws GitException,
                     InterruptedException

Checks out the specified commit/tag/branch into the workspace. (equivalent of git checkout branch.)

Specified by:

checkout in interface GitClient

Parameters:

commit - A git object references expression (either a sha1, tag or branch)

Throws:

GitException - if underlying git operation fails.

InterruptedException - if interrupted.

checkout

public void checkout(String ref,
                     String branch)
              throws GitException,
                     InterruptedException

Creates a new branch that points to the specified ref. (equivalent to git checkout -b branch commit) This will fail if the branch already exists.

Specified by:

checkout in interface GitClient

Parameters:

ref - A git object references expression. For backward compatibility, null will checkout current HEAD

branch - name of the branch to create from reference

Throws:

GitException - if underlying git operation fails.

InterruptedException - if interrupted.

checkoutBranch

public void checkoutBranch(String branch,
                           String ref)
                    throws GitException,
                           InterruptedException

Regardless of the current state of the workspace (whether there is some dirty files, etc) and the state of the repository (whether the branch of the specified name exists or not), when this method exits the following conditions hold:

• The branch of the specified name branch exists and points to the specified ref
• HEAD points to branch. In other words, the workspace is on the specified branch.
• Both index and workspace are the same tree with ref. (no dirty files and no staged changes, although this method will not touch untracked files in the workspace.)

This method is preferred over the GitClient.checkout(String, String) family of methods, as this method is affected far less by the current state of the repository. The checkout methods, in their attempt to emulate the "git checkout" command line behaviour, have too many side effects. In Jenkins, where you care a lot less about throwing away local changes and care a lot more about resetting the workspace into a known state, methods like this is more useful.

For compatibility reasons, the order of the parameter is different from GitClient.checkout(String, String).

Specified by:

checkoutBranch in interface GitClient

Parameters:

branch - a String object.

ref - a String object.

Throws:

GitException - if underlying git operation fails.

InterruptedException - if interrupted.

merge

public void merge(ObjectId rev)
           throws GitException,
                  InterruptedException

merge.

Specified by:

merge in interface GitClient

Parameters:

rev - a ObjectId object.

Throws:

GitException - if underlying git operation fails.

InterruptedException - if interrupted.

remoteProxyFor

protected org.jenkinsci.plugins.gitclient.RemoteGitImpl remoteProxyFor(GitClient proxy)

remoteProxyFor.

Parameters:

proxy - a GitClient object.

Returns:

a RemoteGitImpl object.

setCredentials

public void setCredentials(com.cloudbees.plugins.credentials.common.StandardUsernameCredentials cred)

setCredentials.

Specified by:

setCredentials in interface GitClient

Parameters:

cred - a StandardUsernameCredentials object.

setProxy

public void setProxy(hudson.ProxyConfiguration proxy)

setProxy.

Specified by:

setProxy in interface GitClient

Parameters:

proxy - a ProxyConfiguration object.

submoduleUpdate

public void submoduleUpdate(boolean recursive)
                     throws GitException,
                            InterruptedException

Run submodule update optionally recursively on all submodules (equivalent of git submodule update --recursive.)

Specified by:

submoduleUpdate in interface GitClient

Parameters:

recursive - a boolean.

Throws:

GitException - if underlying git operation fails.

InterruptedException - if interrupted.

submoduleUpdate

public void submoduleUpdate(boolean recursive,
                            String reference)
                     throws GitException,
                            InterruptedException

Run submodule update optionally recursively on all submodules, with a specific reference passed to git clone if needing to --init. (equivalent of git submodule update --recursive --reference 'reference'.)

Specified by:

submoduleUpdate in interface GitClient

Parameters:

recursive - a boolean.

reference - a String object.

Throws:

GitException - if underlying git operation fails.

InterruptedException - if interrupted.

submoduleUpdate

public void submoduleUpdate(boolean recursive,
                            boolean remoteTracking)
                     throws GitException,
                            InterruptedException

Run submodule update optionally recursively on all submodules, optionally with remoteTracking submodules (equivalent of git submodule update --recursive --remote.)

Specified by:

submoduleUpdate in interface GitClient

Parameters:

recursive - a boolean.

remoteTracking - a boolean.

Throws:

GitException - if underlying git operation fails.

InterruptedException - if interrupted.

submoduleUpdate

public void submoduleUpdate(boolean recursive,
                            boolean remoteTracking,
                            String reference)
                     throws GitException,
                            InterruptedException

Run submodule update optionally recursively on all submodules, optionally with remoteTracking, with a specific reference passed to git clone if needing to --init. (equivalent of git submodule update --recursive --remote --reference 'reference'.)

Specified by:

submoduleUpdate in interface GitClient

Parameters:

recursive - a boolean.

remoteTracking - a boolean.

reference - a String object.

Throws:

GitException - if underlying git operation fails.

InterruptedException - if interrupted.