jenkins.plugins.git

Class AbstractGitSCMSource.SpecificRevisionBuildChooser

java.lang.Object

hudson.plugins.git.util.BuildChooser

jenkins.plugins.git.AbstractGitSCMSource.SpecificRevisionBuildChooser

All Implemented Interfaces:

hudson.ExtensionPoint, hudson.model.Describable<BuildChooser>, Serializable

Enclosing class:

AbstractGitSCMSource

public static class AbstractGitSCMSource.SpecificRevisionBuildChooser
extends BuildChooser

See Also:

Serialized Form

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static class	AbstractGitSCMSource.SpecificRevisionBuildChooser.DescriptorImpl

Nested classes/interfaces inherited from interface hudson.ExtensionPoint

hudson.ExtensionPoint.LegacyInstancesAreScopedToHudson

Field Summary

Fields inherited from class hudson.plugins.git.util.BuildChooser

gitSCM

Constructor Summary

Constructors

Constructor and Description
AbstractGitSCMSource.SpecificRevisionBuildChooser(AbstractGitSCMSource.SCMRevisionImpl revision)

Method Summary

Methods

Modifier and Type	Method and Description
Collection<hudson.plugins.git.Revision>	getCandidateRevisions(boolean isPollCall, String singleBranch, org.jenkinsci.plugins.gitclient.GitClient git, hudson.model.TaskListener listener, BuildData buildData, BuildChooserContext context) Get a list of revisions that are candidates to be built.
Build	prevBuildForChangelog(String branch, BuildData data, org.jenkinsci.plugins.gitclient.GitClient git, BuildChooserContext context) Determines the baseline to compute the changelog against.

Methods inherited from class hudson.plugins.git.util.BuildChooser

all, allApplicableTo, getCandidateRevisions, getCandidateRevisions, getDescriptor, getDisplayName, prepareWorkingTree, prevBuildForChangelog, prevBuildForChangelog

Methods inherited from class java.lang.Object

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

Constructor Detail

AbstractGitSCMSource.SpecificRevisionBuildChooser

public AbstractGitSCMSource.SpecificRevisionBuildChooser(AbstractGitSCMSource.SCMRevisionImpl revision)

Method Detail

getCandidateRevisions

public Collection<hudson.plugins.git.Revision> getCandidateRevisions(boolean isPollCall,
                                                            String singleBranch,
                                                            org.jenkinsci.plugins.gitclient.GitClient git,
                                                            hudson.model.TaskListener listener,
                                                            BuildData buildData,
                                                            BuildChooserContext context)
                                                              throws hudson.plugins.git.GitException,
                                                                     IOException,
                                                                     InterruptedException

Description copied from class: BuildChooser

Get a list of revisions that are candidates to be built.

This method is invoked on the node where the workspace exists, which may not be the master.

Overrides:

getCandidateRevisions in class BuildChooser

Parameters:

isPollCall - true if this method is called from pollChanges.

singleBranch - contains the name of a single branch to be built this will be non-null only in the simple case, in advanced cases with multiple repositories and/or branches specified then this value will be null.

git - Used for invoking Git

listener - build log

buildData - information about prior build

context - Object that provides access back to the model object. This is because the build chooser can be invoked on a slave where there's no direct access to the build/project for which this is invoked. If isPollCall is false, then call back to both project and build are available. If isPollCall is true, then only the callback to the project is available as there's no contextual build object.

Returns:

the candidate revision. Can be an empty set to indicate that there's nothing to build.

Throws:

hudson.plugins.git.GitException - on git error

IOException - on I/O error

InterruptedException - if interrupted

prevBuildForChangelog

public Build prevBuildForChangelog(String branch,
                          @Nullable
                          BuildData data,
                          org.jenkinsci.plugins.gitclient.GitClient git,
                          BuildChooserContext context)
                            throws IOException,
                                   InterruptedException

Description copied from class: BuildChooser

Determines the baseline to compute the changelog against.

BuildChooser.getCandidateRevisions(boolean, String, IGitAPI, TaskListener, BuildData, BuildChooserContext) determine what commits can be subject for a build, and for each commit it determines the branches that contribute to them.

Once GitSCM picks up a specific Revision to build, for each branch, in that revision, this method is called to compute the changelog.

Overrides:

prevBuildForChangelog in class BuildChooser

Parameters:

branch - The branch name.

data - Information that captures what we did during the last build.

git - Used for invoking Git

context - Object that provides access back to the model object. This is because the build chooser can be invoked on a slave where there's no direct access to the build/project for which this is invoked.

Returns:

the candidate revision. Can be an empty set to indicate that there's nothing to build.

Throws:

IOException - on I/O error

InterruptedException - if interrupted