Package org.jenkinsci.plugins.workflow.libs

Class SCMSourceRetriever

java.lang.Object

hudson.model.AbstractDescribableImpl<LibraryRetriever>

org.jenkinsci.plugins.workflow.libs.LibraryRetriever

org.jenkinsci.plugins.workflow.libs.SCMBasedRetriever

org.jenkinsci.plugins.workflow.libs.SCMSourceRetriever

All Implemented Interfaces:

ExtensionPoint, Describable<LibraryRetriever>

public class SCMSourceRetriever
extends SCMBasedRetriever

Uses SCMSource.fetch(String, TaskListener) to retrieve a specific revision.

Nested Class Summary

Nested Classes

Modifier and Type	Class	Description
static class	SCMSourceRetriever.DescriptorImpl
static class	SCMSourceRetriever.Hider

Nested classes/interfaces inherited from class org.jenkinsci.plugins.workflow.libs.SCMBasedRetriever

SCMBasedRetriever.SCMBasedRetrieverDescriptor, SCMBasedRetriever.WorkspaceListener

Nested classes/interfaces inherited from interface hudson.ExtensionPoint

ExtensionPoint.LegacyInstancesAreScopedToHudson

Field Summary

Fields inherited from class org.jenkinsci.plugins.workflow.libs.SCMBasedRetriever

INCLUDE_SRC_TEST_IN_LIBRARIES

Constructor Summary

Constructors

Constructor	Description
SCMSourceRetriever(jenkins.scm.api.SCMSource scm)

Method Summary

Modifier and Type	Method	Description
jenkins.scm.api.SCMSource	getScm()	A source of SCM checkouts.
protected void	retrieve3(LibraryRecord record, boolean changelog, FilePath target, Run<?,?> run, TaskListener listener)	Obtains library sources.
FormValidation	validateVersion(String name, String version, Item context)	Offer to validate a proposed version for LibraryRetriever.retrieve(java.lang.String, java.lang.String, boolean, hudson.FilePath, hudson.model.Run<?, ?>, hudson.model.TaskListener).

Methods inherited from class org.jenkinsci.plugins.workflow.libs.SCMBasedRetriever

doRetrieve, doRetrieve, getLibraryPath, isClone, retrySCMOperation, setClone, setLibraryPath

Methods inherited from class org.jenkinsci.plugins.workflow.libs.LibraryRetriever

getDescriptor, retrieve, retrieve, validateVersion

Methods inherited from class java.lang.Object

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

Constructor Details

SCMSourceRetriever

@DataBoundConstructor
public SCMSourceRetriever(jenkins.scm.api.SCMSource scm)

Method Details

getScm

public jenkins.scm.api.SCMSource getScm()

A source of SCM checkouts.

retrieve3

protected void retrieve3(LibraryRecord record,
 boolean changelog,
 FilePath target,
 Run<?,?> run,
 TaskListener listener)
                  throws Exception

Description copied from class: LibraryRetriever

Obtains library sources. New implementations should override this method; the default delegates to LibraryRetriever.retrieve(String, String, boolean, FilePath, Run, TaskListener) for backward compatibility with third-party retrievers that have not yet been updated.

Overrides:

retrieve3 in class LibraryRetriever

Parameters:

record - full record of this library's configuration for this build; use LibraryRecord.getName() and LibraryRecord.getVersion() in place of the former name and version parameters

changelog - whether to include changesets in the library in jobs using it from LibraryConfiguration.getIncludeInChangesets()

target - a directory in which to check out sources; should create src/**/*.groovy and/or vars/*.groovy, and optionally also resources/

run - a build which will use the library

listener - a way to report progress

Throws:

Exception - if there is any problem (use AbortException for user errors)

validateVersion

public FormValidation validateVersion(String name,
 String version,
 Item context)

Description copied from class: LibraryRetriever

Offer to validate a proposed version for LibraryRetriever.retrieve(java.lang.String, java.lang.String, boolean, hudson.FilePath, hudson.model.Run<?, ?>, hudson.model.TaskListener).

Overrides:

validateVersion in class LibraryRetriever

Parameters:

name - the proposed library name

version - a proposed version

context - optional context in which this runs

Returns:

by default, OK