org.eclipse.jgit.api

Class PullCommand

java.lang.Object

org.eclipse.jgit.api.GitCommand<T>

org.eclipse.jgit.api.TransportCommand<PullCommand,PullResult>

org.eclipse.jgit.api.PullCommand

All Implemented Interfaces:

Callable<PullResult>

public class PullCommand
extends TransportCommand<PullCommand,PullResult>

The Pull command

See Also:

Git documentation about Pull

Field Summary

Fields inherited from class org.eclipse.jgit.api.TransportCommand

credentialsProvider, timeout, transportConfigCallback

Fields inherited from class org.eclipse.jgit.api.GitCommand

repo

Constructor Summary

Constructors

Modifier	Constructor and Description
protected	PullCommand(Repository repo)

Method Summary

Modifier and Type	Method and Description
PullResult	call() Executes the Pull command with all the options and parameters collected by the setter methods (e.g.
static BranchConfig.BranchRebaseMode	getRebaseMode(String branchName, Config config) Reads the rebase mode to use for a pull command from the repository configuration.
String	getRemote()
String	getRemoteBranchName()
PullCommand	setProgressMonitor(ProgressMonitor monitor)
PullCommand	setRebase(boolean useRebase) Set if rebase should be used after fetching.
PullCommand	setRebase(BranchConfig.BranchRebaseMode rebaseMode) Sets the BranchConfig.BranchRebaseMode to use after fetching.
PullCommand	setRecurseSubmodules(SubmoduleConfig.FetchRecurseSubmodulesMode recurse) Set the mode to be used for recursing into submodules.
PullCommand	setRemote(String remote) The remote (uri or name) to be used for the pull operation.
PullCommand	setRemoteBranchName(String remoteBranchName) The remote branch name to be used for the pull operation.
PullCommand	setStrategy(MergeStrategy strategy)
PullCommand	setTagOpt(TagOpt tagOpt) Sets the specification of annotated tag behavior during fetch

Methods inherited from class org.eclipse.jgit.api.TransportCommand

configure, configure, self, setCredentialsProvider, setTimeout, setTransportConfigCallback

Methods inherited from class org.eclipse.jgit.api.GitCommand

checkCallable, getRepository, setCallable

Methods inherited from class java.lang.Object

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

Constructor Detail

PullCommand

protected PullCommand(Repository repo)

Parameters:

repo -

Method Detail

setProgressMonitor

public PullCommand setProgressMonitor(ProgressMonitor monitor)

Parameters:

monitor - a progress monitor

Returns:

this instance

setRebase

public PullCommand setRebase(boolean useRebase)

Set if rebase should be used after fetching. If set to true, rebase is used instead of merge. This is equivalent to --rebase on the command line.

If set to false, merge is used after fetching, overriding the configuration file. This is equivalent to --no-rebase on the command line.

This setting overrides the settings in the configuration file. By default, the setting in the repository configuration file is used.

A branch can be configured to use rebase by default. See branch.[name].rebase and branch.autosetuprebase.

Parameters:

useRebase -

Returns:

this

setRebase

public PullCommand setRebase(BranchConfig.BranchRebaseMode rebaseMode)

Sets the BranchConfig.BranchRebaseMode to use after fetching.

BranchRebaseMode.REBASE

Equivalent to --rebase on the command line: use rebase instead of merge after fetching.

BranchRebaseMode.PRESERVE

Equivalent to --preserve-merges on the command line: rebase preserving local merge commits.

BranchRebaseMode.INTERACTIVE

Equivalent to --interactive on the command line: use interactive rebase.

BranchRebaseMode.NONE

Equivalent to --no-rebase: merge instead of rebasing.

null

Use the setting defined in the git configuration, either branch.[name].rebase or, if not set, pull.rebase

This setting overrides the settings in the configuration file. By default, the setting in the repository configuration file is used.

A branch can be configured to use rebase by default. See branch.[name].rebase, branch.autosetuprebase, and pull.rebase.

Parameters:

rebaseMode - the BranchConfig.BranchRebaseMode to use

Returns:

this

Since:

4.5

call

public PullResult call()
                throws GitAPIException,
                       WrongRepositoryStateException,
                       InvalidConfigurationException,
                       DetachedHeadException,
                       InvalidRemoteException,
                       CanceledException,
                       RefNotFoundException,
                       RefNotAdvertisedException,
                       NoHeadException,
                       TransportException

Executes the Pull command with all the options and parameters collected by the setter methods (e.g. setProgressMonitor(ProgressMonitor)) of this class. Each instance of this class should only be used for one invocation of the command. Don't call this method twice on an instance.

Specified by:

call in interface Callable<PullResult>

Specified by:

call in class GitCommand<PullResult>

Returns:

the result of the pull

Throws:

WrongRepositoryStateException

InvalidConfigurationException

DetachedHeadException

InvalidRemoteException

CanceledException

RefNotFoundException

RefNotAdvertisedException

NoHeadException

TransportException

GitAPIException

setRemote

public PullCommand setRemote(String remote)

The remote (uri or name) to be used for the pull operation. If no remote is set, the branch's configuration will be used. If the branch configuration is missing the default value of Constants.DEFAULT_REMOTE_NAME will be used.

Parameters:

remote -

Returns:

this

Since:

3.3

See Also:

Constants.DEFAULT_REMOTE_NAME

setRemoteBranchName

public PullCommand setRemoteBranchName(String remoteBranchName)

The remote branch name to be used for the pull operation. If no remoteBranchName is set, the branch's configuration will be used. If the branch configuration is missing the remote branch with the same name as the current branch is used.

Parameters:

remoteBranchName -

Returns:

this

Since:

3.3

getRemote

public String getRemote()

Returns:

the remote used for the pull operation if it was set explicitly

Since:

3.3

getRemoteBranchName

public String getRemoteBranchName()

Returns:

the remote branch name used for the pull operation if it was set explicitly

Since:

3.3

setStrategy

public PullCommand setStrategy(MergeStrategy strategy)

Parameters:

strategy - The merge strategy to use during this pull operation.

Returns:

this

Since:

3.4

setTagOpt

public PullCommand setTagOpt(TagOpt tagOpt)

Sets the specification of annotated tag behavior during fetch

Parameters:

tagOpt -

Returns:

this

Since:

4.7

setRecurseSubmodules

public PullCommand setRecurseSubmodules(SubmoduleConfig.FetchRecurseSubmodulesMode recurse)

Set the mode to be used for recursing into submodules.

Parameters:

recurse -

Returns:

this

Since:

4.7

getRebaseMode

public static BranchConfig.BranchRebaseMode getRebaseMode(String branchName,
                                                          Config config)

Reads the rebase mode to use for a pull command from the repository configuration. This is the value defined for the configurations branch.[branchName].rebase, or,if not set, pull.rebase. If neither is set, yields BranchConfig.BranchRebaseMode.NONE.

Parameters:

branchName - name of the local branch

config - the Config to read the value from

Returns:

the BranchConfig.BranchRebaseMode

Since:

4.5