org.eclipse.jgit.api
Class FetchCommand

java.lang.Object
  extended by org.eclipse.jgit.api.GitCommand<FetchResult>
      extended by org.eclipse.jgit.api.FetchCommand
All Implemented Interfaces:
Callable<FetchResult>

public class FetchCommand
extends GitCommand<FetchResult>

A class used to execute a Fetch command. It has setters for all supported options and arguments of this command and a call() method to finally execute the command.

See Also:
Git documentation about Fetch

Field Summary
 
Fields inherited from class org.eclipse.jgit.api.GitCommand
repo
 
Constructor Summary
protected FetchCommand(Repository repo)
           
 
Method Summary
 FetchResult call()
          Executes the fetch command with all the options and parameters collected by the setter methods of this class.
 ProgressMonitor getProgressMonitor()
           
 List<RefSpec> getRefSpecs()
           
 String getRemote()
           
 int getTimeout()
           
 boolean isCheckFetchedObjects()
           
 boolean isDryRun()
           
 boolean isRemoveDeletedRefs()
           
 boolean isThin()
           
 FetchCommand setCheckFetchedObjects(boolean checkFetchedObjects)
          If set to true, objects received will be checked for validity
 FetchCommand setCredentialsProvider(CredentialsProvider credentialsProvider)
           
 FetchCommand setDryRun(boolean dryRun)
          Sets whether the fetch operation should be a dry run
 FetchCommand setProgressMonitor(ProgressMonitor monitor)
          The progress monitor associated with the fetch operation.
 FetchCommand setRefSpecs(List<RefSpec> specs)
          The ref specs to be used in the fetch operation
 FetchCommand setRefSpecs(RefSpec... specs)
          The ref specs to be used in the fetch operation
 FetchCommand setRemote(String remote)
          The remote (uri or name) used for the fetch operation.
 FetchCommand setRemoveDeletedRefs(boolean removeDeletedRefs)
          If set to true, refs are removed which no longer exist in the source
 FetchCommand setTagOpt(TagOpt tagOpt)
          Sets the specification of annotated tag behavior during fetch
 FetchCommand setThin(boolean thin)
          Sets the thin-pack preference for fetch operation.
 FetchCommand setTimeout(int timeout)
           
 
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

FetchCommand

protected FetchCommand(Repository repo)
Parameters:
repo -
Method Detail

call

public FetchResult call()
                 throws JGitInternalException,
                        InvalidRemoteException
Executes the fetch command with all the options and parameters collected by the setter methods of this class. Each instance of this class should only be used for one invocation of the command (means: one call to call())

Returns:
a FetchResult object representing the successful fetch result
Throws:
InvalidRemoteException - when called with an invalid remote uri
JGitInternalException - a low-level exception of JGit has occurred. The original exception can be retrieved by calling Throwable.getCause().

setRemote

public FetchCommand setRemote(String remote)
The remote (uri or name) used for the fetch operation. If no remote is set, the default value of Constants.DEFAULT_REMOTE_NAME will be used.

Parameters:
remote -
Returns:
this
See Also:
Constants.DEFAULT_REMOTE_NAME

getRemote

public String getRemote()
Returns:
the remote used for the remote operation

setTimeout

public FetchCommand setTimeout(int timeout)
Parameters:
timeout - the timeout used for the fetch operation
Returns:
this

getTimeout

public int getTimeout()
Returns:
the timeout used for the fetch operation

isCheckFetchedObjects

public boolean isCheckFetchedObjects()
Returns:
whether to check received objects checked for validity

setCheckFetchedObjects

public FetchCommand setCheckFetchedObjects(boolean checkFetchedObjects)
If set to true, objects received will be checked for validity

Parameters:
checkFetchedObjects -
Returns:
this

isRemoveDeletedRefs

public boolean isRemoveDeletedRefs()
Returns:
whether or not to remove refs which no longer exist in the source

setRemoveDeletedRefs

public FetchCommand setRemoveDeletedRefs(boolean removeDeletedRefs)
If set to true, refs are removed which no longer exist in the source

Parameters:
removeDeletedRefs -
Returns:
this

getProgressMonitor

public ProgressMonitor getProgressMonitor()
Returns:
the progress monitor for the fetch operation

setProgressMonitor

public FetchCommand setProgressMonitor(ProgressMonitor monitor)
The progress monitor associated with the fetch operation. By default, this is set to NullProgressMonitor

Parameters:
monitor -
Returns:
this
See Also:
NullProgressMonitor

getRefSpecs

public List<RefSpec> getRefSpecs()
Returns:
the ref specs

setRefSpecs

public FetchCommand setRefSpecs(RefSpec... specs)
The ref specs to be used in the fetch operation

Parameters:
specs -
Returns:
this

setRefSpecs

public FetchCommand setRefSpecs(List<RefSpec> specs)
The ref specs to be used in the fetch operation

Parameters:
specs -
Returns:
this

isDryRun

public boolean isDryRun()
Returns:
the dry run preference for the fetch operation

setDryRun

public FetchCommand setDryRun(boolean dryRun)
Sets whether the fetch operation should be a dry run

Parameters:
dryRun -
Returns:
this

isThin

public boolean isThin()
Returns:
the thin-pack preference for fetch operation

setThin

public FetchCommand setThin(boolean thin)
Sets the thin-pack preference for fetch operation. Default setting is Transport.DEFAULT_FETCH_THIN

Parameters:
thin -
Returns:
this

setCredentialsProvider

public FetchCommand setCredentialsProvider(CredentialsProvider credentialsProvider)
Parameters:
credentialsProvider - the CredentialsProvider to use
Returns:
this

setTagOpt

public FetchCommand setTagOpt(TagOpt tagOpt)
Sets the specification of annotated tag behavior during fetch

Parameters:
tagOpt -
Returns:
this


Copyright © 2011. All Rights Reserved.