hudson.plugins.git.util

Class BuildChooser

java.lang.Object

hudson.plugins.git.util.BuildChooser

All Implemented Interfaces:

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

Direct Known Subclasses:

DefaultBuildChooser

public abstract class BuildChooser
extends Object
implements hudson.ExtensionPoint, hudson.model.Describable<BuildChooser>, Serializable

Interface defining an API to choose which revisions ought to be considered for building.

This object is persisted as a part of the project configuration.

Author:

magnayn, Kohsuke Kawaguchi

See Also:

Serialized Form

Nested Class Summary

Nested classes/interfaces inherited from interface hudson.ExtensionPoint

hudson.ExtensionPoint.LegacyInstancesAreScopedToHudson

Field Summary

Fields

Modifier and Type	Field and Description
GitSCM	gitSCM Refers back to the GitSCM that owns this build chooser.

Constructor Summary

Constructors

Constructor and Description
BuildChooser()

Method Summary

Methods

Modifier and Type	Method and Description
static hudson.DescriptorExtensionList<BuildChooser,BuildChooserDescriptor>	all() All the registered build choosers.
boolean	equals(Object o)
abstract Collection<Revision>	getCandidateRevisions(boolean isPollCall, String singleBranch, IGitAPI git, hudson.model.TaskListener listener, BuildData buildData) Get a list of revisions that are candidates to be built.
BuildChooserDescriptor	getDescriptor() What was the last revision to be built?
String	getDisplayName() Short-hand to get to the display name.
int	hashCode()
Build	prevBuildForChangelog(String singleBranch, BuildData data, IGitAPI git)

Methods inherited from class java.lang.Object

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

Field Detail

gitSCM

public transient GitSCM gitSCM

Refers back to the GitSCM that owns this build chooser. Do not modify from outside GitSCM.

Constructor Detail

BuildChooser

public BuildChooser()

Method Detail

getDisplayName

public final String getDisplayName()

Short-hand to get to the display name.

getCandidateRevisions

public abstract Collection<Revision> getCandidateRevisions(boolean isPollCall,
                                         String singleBranch,
                                         IGitAPI git,
                                         hudson.model.TaskListener listener,
                                         BuildData buildData)
                                                    throws GitException,
                                                           IOException

Get a list of revisions that are candidates to be built. May be an empty set.

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.

Returns:

the candidate revision.

Throws:

IOException

GitException

getDescriptor

public BuildChooserDescriptor getDescriptor()

What was the last revision to be built?

Specified by:

getDescriptor in interface hudson.model.Describable<BuildChooser>

Returns:

all

public static hudson.DescriptorExtensionList<BuildChooser,BuildChooserDescriptor> all()

All the registered build choosers.

prevBuildForChangelog

public Build prevBuildForChangelog(String singleBranch,
                          BuildData data,
                          IGitAPI git)

equals

public boolean equals(Object o)

Overrides:

equals in class Object

hashCode

public int hashCode()

Overrides:

hashCode in class Object