hudson.plugins.git.extensions.impl

Class SubmoduleOption

java.lang.Object

hudson.model.AbstractDescribableImpl<GitSCMExtension>

hudson.plugins.git.extensions.GitSCMExtension

hudson.plugins.git.extensions.impl.SubmoduleOption

All Implemented Interfaces:

Describable<GitSCMExtension>

public class SubmoduleOption
extends GitSCMExtension

Further tweak the behaviour of git-submodule.

Historically, the submodule support was on by default, and given the clear marker file in the source tree, I think keeping this default behaviour is sensible. So when we split out GitSCMExtensions, we decided to keep the git-submodule handling enabled by default, and this extension controls the recursiveness and the option to switch it off.

Author:

Yury V. Zaytsev, Andrew Bayer, Kohsuke Kawaguchi

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static class	SubmoduleOption.DescriptorImpl

Constructor Summary

Constructors

Constructor and Description
SubmoduleOption(boolean disableSubmodules, boolean recursiveSubmodules, boolean trackingSubmodules, String reference, Integer timeout, boolean parentCredentials)

Method Summary

Modifier and Type	Method and Description
void	determineSupportForJGit(GitSCM scm, org.jenkinsci.plugins.gitclient.UnsupportedCommand cmd) Called when support of JGit for a particular or multiple extensions is to be determined
boolean	equals(Object o)
Integer	getDepth()
String	getReference()
boolean	getShallow()
Integer	getThreads()
Integer	getTimeout()
int	hashCode()
boolean	isDisableSubmodules()
boolean	isParentCredentials()
boolean	isRecursiveSubmodules()
boolean	isTrackingSubmodules()
void	onCheckoutCompleted(GitSCM scm, Run<?,?> build, org.jenkinsci.plugins.gitclient.GitClient git, TaskListener listener) Called when the checkout was completed and the working directory is filled with files.
void	onClean(GitSCM scm, org.jenkinsci.plugins.gitclient.GitClient git) Signals when "git-clean" runs.
void	setDepth(Integer depth)
void	setShallow(boolean shallow)
void	setThreads(Integer threads)
String	toString()

Methods inherited from class hudson.plugins.git.extensions.GitSCMExtension

beforeCheckout, beforeCheckout, decorate, decorateCheckoutCommand, decorateCheckoutCommand, decorateCloneCommand, decorateCloneCommand, decorateFetchCommand, decorateFetchCommand, decorateMergeCommand, decorateMergeCommand, decorateRevisionToBuild, decorateRevisionToBuild, enableMultipleRevisionDetection, getDescriptor, getRequiredClient, getWorkingDirectory, getWorkingDirectory, isRevExcluded, onCheckoutCompleted, populateEnvironmentVariables, requiresWorkspaceForPolling

Methods inherited from class java.lang.Object

clone, finalize, getClass, notify, notifyAll, wait, wait, wait

Constructor Detail

SubmoduleOption

@DataBoundConstructor
public SubmoduleOption(boolean disableSubmodules,
                                             boolean recursiveSubmodules,
                                             boolean trackingSubmodules,
                                             String reference,
                                             Integer timeout,
                                             boolean parentCredentials)

Method Detail

isDisableSubmodules

public boolean isDisableSubmodules()

isRecursiveSubmodules

public boolean isRecursiveSubmodules()

isTrackingSubmodules

public boolean isTrackingSubmodules()

isParentCredentials

public boolean isParentCredentials()

getReference

public String getReference()

getTimeout

public Integer getTimeout()

setShallow

@DataBoundSetter
public void setShallow(boolean shallow)

getShallow

public boolean getShallow()

setDepth

@DataBoundSetter
public void setDepth(Integer depth)

getDepth

public Integer getDepth()

getThreads

public Integer getThreads()

setThreads

@DataBoundSetter
public void setThreads(Integer threads)

onClean

public void onClean(GitSCM scm,
                    org.jenkinsci.plugins.gitclient.GitClient git)
             throws IOException,
                    InterruptedException,
                    hudson.plugins.git.GitException

Signals when "git-clean" runs. Primarily for running "git submodule clean" TODO: revisit the abstraction

Overrides:

onClean in class GitSCMExtension

Parameters:

scm - GitSCM object

git - GitClient

Throws:

IOException - on input or output error

InterruptedException - when interrupted

hudson.plugins.git.GitException - on git error

onCheckoutCompleted

public void onCheckoutCompleted(GitSCM scm,
                                Run<?,?> build,
                                org.jenkinsci.plugins.gitclient.GitClient git,
                                TaskListener listener)
                         throws IOException,
                                InterruptedException,
                                hudson.plugins.git.GitException

Called when the checkout was completed and the working directory is filled with files. See SCM.checkout(Run, Launcher, FilePath, TaskListener, File, SCMRevisionState) for the available parameters, except workingDirectory Do not move the HEAD to another commit, as by this point the commit to be built is already determined and recorded (such as changelog.)

Overrides:

onCheckoutCompleted in class GitSCMExtension

Parameters:

scm - GitSCM object

build - run context

git - GitClient

listener - build log

Throws:

IOException - on input or output error

InterruptedException - when interrupted

hudson.plugins.git.GitException - on git error

determineSupportForJGit

public void determineSupportForJGit(GitSCM scm,
                                    @NonNull
                                    org.jenkinsci.plugins.gitclient.UnsupportedCommand cmd)

Description copied from class: GitSCMExtension

Called when support of JGit for a particular or multiple extensions is to be determined

Overrides:

determineSupportForJGit in class GitSCMExtension

Parameters:

scm - GitSCM object

cmd - UnsupportedCommand object

equals

public boolean equals(Object o)

Overrides:

equals in class Object

hashCode

public int hashCode()

Overrides:

hashCode in class Object

toString

public String toString()

Overrides:

toString in class Object