org.jenkinsci.plugins.github_branch_source

Class GitHubSCMSource

java.lang.Object

hudson.model.AbstractDescribableImpl<jenkins.scm.api.SCMSource>

jenkins.scm.api.SCMSource

jenkins.plugins.git.AbstractGitSCMSource

org.jenkinsci.plugins.github_branch_source.GitHubSCMSource

All Implemented Interfaces:

hudson.ExtensionPoint, hudson.model.Describable<jenkins.scm.api.SCMSource>

public class GitHubSCMSource
extends jenkins.plugins.git.AbstractGitSCMSource

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static class	GitHubSCMSource.DescriptorImpl

Nested classes/interfaces inherited from class jenkins.plugins.git.AbstractGitSCMSource

jenkins.plugins.git.AbstractGitSCMSource.SCMRevisionImpl, jenkins.plugins.git.AbstractGitSCMSource.SpecificRevisionBuildChooser

Nested classes/interfaces inherited from interface hudson.ExtensionPoint

hudson.ExtensionPoint.LegacyInstancesAreScopedToHudson

Field Summary

Fields inherited from class jenkins.scm.api.SCMSource

PRONOUN

Constructor Summary

Constructors

Constructor and Description
GitHubSCMSource(String id, String apiUri, String checkoutCredentialsId, String scanCredentialsId, String repoOwner, String repository)

Method Summary

Modifier and Type	Method and Description
hudson.scm.SCM	build(jenkins.scm.api.SCMHead head, jenkins.scm.api.SCMRevision revision)
protected jenkins.scm.api.SCMRevision	doRetrieve(jenkins.scm.api.SCMHead head, hudson.model.TaskListener listener, org.kohsuke.github.GHRepository repo)
String	getApiUri()
boolean	getBuildForkPRHead()
boolean	getBuildForkPRMerge()
boolean	getBuildOriginBranch()
boolean	getBuildOriginBranchWithPR()
boolean	getBuildOriginPRHead()
boolean	getBuildOriginPRMerge()
String	getCheckoutCredentialsId()
String	getCredentialsId() Returns the effective credentials used to check out sources: null - anonymous access SAME - represents that we want to use the same as scan credentials UUID - represents the credentials identifier
String	getExcludes()
String	getIncludes()
protected jenkins.scm.api.SCMSourceCriteria.Probe	getProbe(String branch, String thing, String ref, org.kohsuke.github.GHRepository repo, hudson.model.TaskListener listener) Returns a SCMSourceCriteria.Probe for use in doRetrieve(jenkins.scm.api.SCMHeadObserver, hudson.model.TaskListener, org.kohsuke.github.GHRepository).
String	getPronoun()
protected List<org.eclipse.jgit.transport.RefSpec>	getRefSpecs()
String	getRemote()
String	getRepoOwner()
String	getRepository()
String	getScanCredentialsId()
jenkins.scm.api.SCMRevision	getTrustedRevision(jenkins.scm.api.SCMRevision revision, hudson.model.TaskListener listener)
RepositoryUriResolver	getUriResolver() Returns a RepositoryUriResolver according to credentials configuration.
protected void	retrieve(jenkins.scm.api.SCMHeadObserver observer, hudson.model.TaskListener listener)
protected jenkins.scm.api.SCMRevision	retrieve(jenkins.scm.api.SCMHead head, hudson.model.TaskListener listener)
void	setBuildForkPRHead(boolean buildForkPRHead)
void	setBuildForkPRMerge(boolean buildForkPRMerge)
void	setBuildOriginBranch(boolean buildOriginBranch)
void	setBuildOriginBranchWithPR(boolean buildOriginBranchWithPR)
void	setBuildOriginPRHead(boolean buildOriginPRHead)
void	setBuildOriginPRMerge(boolean buildOriginPRMerge)
void	setExcludes(String excludes)
void	setIncludes(String includes)

Methods inherited from class jenkins.plugins.git.AbstractGitSCMSource

getCacheDir, getCacheEntry, getCacheLock, getCredentials, getRemoteConfigs, getRemoteName, isExcluded

Methods inherited from class jenkins.scm.api.SCMSource

build, defaultListener, equals, fetch, fetch, fetch, fetch, fetchRevisions, getCriteria, getDescriptor, getId, getOwner, hashCode, parentHeads, parentRevisions, retrieve, retrieve, retrieveRevisions, setOwner, toString

Methods inherited from class java.lang.Object

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

Constructor Detail

GitHubSCMSource

@DataBoundConstructor
public GitHubSCMSource(String id,
                                             String apiUri,
                                             String checkoutCredentialsId,
                                             String scanCredentialsId,
                                             String repoOwner,
                                             String repository)

Method Detail

getApiUri

@CheckForNull
public String getApiUri()

getCredentialsId

@CheckForNull
public String getCredentialsId()

Returns the effective credentials used to check out sources: null - anonymous access SAME - represents that we want to use the same as scan credentials UUID - represents the credentials identifier

Specified by:

getCredentialsId in class jenkins.plugins.git.AbstractGitSCMSource

Returns:

A string or null.

getScanCredentialsId

@CheckForNull
public String getScanCredentialsId()

getCheckoutCredentialsId

@CheckForNull
public String getCheckoutCredentialsId()

getRepoOwner

public String getRepoOwner()

getRepository

public String getRepository()

getPronoun

public String getPronoun()

Overrides:

getPronoun in class jenkins.scm.api.SCMSource

getRefSpecs

protected List<org.eclipse.jgit.transport.RefSpec> getRefSpecs()

Specified by:

getRefSpecs in class jenkins.plugins.git.AbstractGitSCMSource

getUriResolver

public RepositoryUriResolver getUriResolver()

Returns a RepositoryUriResolver according to credentials configuration.

Returns:

a RepositoryUriResolver

getIncludes

@Nonnull
public String getIncludes()

Specified by:

getIncludes in class jenkins.plugins.git.AbstractGitSCMSource

setIncludes

@DataBoundSetter
public void setIncludes(@Nonnull
                                         String includes)

getExcludes

@Nonnull
public String getExcludes()

Specified by:

getExcludes in class jenkins.plugins.git.AbstractGitSCMSource

setExcludes

@DataBoundSetter
public void setExcludes(@Nonnull
                                         String excludes)

getBuildOriginBranch

public boolean getBuildOriginBranch()

setBuildOriginBranch

@DataBoundSetter
public void setBuildOriginBranch(boolean buildOriginBranch)

getBuildOriginBranchWithPR

public boolean getBuildOriginBranchWithPR()

setBuildOriginBranchWithPR

@DataBoundSetter
public void setBuildOriginBranchWithPR(boolean buildOriginBranchWithPR)

getBuildOriginPRMerge

public boolean getBuildOriginPRMerge()

setBuildOriginPRMerge

@DataBoundSetter
public void setBuildOriginPRMerge(boolean buildOriginPRMerge)

getBuildOriginPRHead

public boolean getBuildOriginPRHead()

setBuildOriginPRHead

@DataBoundSetter
public void setBuildOriginPRHead(boolean buildOriginPRHead)

getBuildForkPRMerge

public boolean getBuildForkPRMerge()

setBuildForkPRMerge

@DataBoundSetter
public void setBuildForkPRMerge(boolean buildForkPRMerge)

getBuildForkPRHead

public boolean getBuildForkPRHead()

setBuildForkPRHead

@DataBoundSetter
public void setBuildForkPRHead(boolean buildForkPRHead)

getRemote

public String getRemote()

Specified by:

getRemote in class jenkins.plugins.git.AbstractGitSCMSource

retrieve

protected final void retrieve(jenkins.scm.api.SCMHeadObserver observer,
                              hudson.model.TaskListener listener)
                       throws IOException,
                              InterruptedException

Overrides:

retrieve in class jenkins.plugins.git.AbstractGitSCMSource

Throws:

IOException

InterruptedException

getProbe

protected jenkins.scm.api.SCMSourceCriteria.Probe getProbe(String branch,
                                                           String thing,
                                                           String ref,
                                                           org.kohsuke.github.GHRepository repo,
                                                           hudson.model.TaskListener listener)

Returns a SCMSourceCriteria.Probe for use in doRetrieve(jenkins.scm.api.SCMHeadObserver, hudson.model.TaskListener, org.kohsuke.github.GHRepository).

Parameters:

branch - branch name

thing - readable name of what this is, e.g. branch

ref - the refspec, e.g. refs/heads/myproduct-stable

repo - A repository on GitHub.

listener - A TaskListener to log useful information

Returns:

A SCMSourceCriteria.Probe

retrieve

@CheckForNull
protected jenkins.scm.api.SCMRevision retrieve(jenkins.scm.api.SCMHead head,
                                                             hudson.model.TaskListener listener)
                                                      throws IOException,
                                                             InterruptedException

Overrides:

retrieve in class jenkins.plugins.git.AbstractGitSCMSource

Throws:

IOException

InterruptedException

doRetrieve

protected jenkins.scm.api.SCMRevision doRetrieve(jenkins.scm.api.SCMHead head,
                                                 hudson.model.TaskListener listener,
                                                 org.kohsuke.github.GHRepository repo)
                                          throws IOException,
                                                 InterruptedException

Throws:

IOException

InterruptedException

build

public hudson.scm.SCM build(jenkins.scm.api.SCMHead head,
                            jenkins.scm.api.SCMRevision revision)

Overrides:

build in class jenkins.plugins.git.AbstractGitSCMSource

getTrustedRevision

public jenkins.scm.api.SCMRevision getTrustedRevision(jenkins.scm.api.SCMRevision revision,
                                                      hudson.model.TaskListener listener)
                                               throws IOException,
                                                      InterruptedException

Overrides:

getTrustedRevision in class jenkins.scm.api.SCMSource

Throws:

IOException

InterruptedException