org.jenkinsci.plugins.runselector.selectors

Class AbstractSpecificRunSelector

java.lang.Object

hudson.model.AbstractDescribableImpl<RunSelector>

org.jenkinsci.plugins.runselector.RunSelector

org.jenkinsci.plugins.runselector.selectors.AbstractSpecificRunSelector

All Implemented Interfaces:

hudson.ExtensionPoint, hudson.model.Describable<RunSelector>

Direct Known Subclasses:

BuildNumberRunSelector, PermalinkRunSelector

public abstract class AbstractSpecificRunSelector
extends RunSelector

RunSelector enumerates only one build. override {getBuild(Job, RunSelectorContext) instead.

Nested Class Summary

Nested classes/interfaces inherited from interface hudson.ExtensionPoint

hudson.ExtensionPoint.LegacyInstancesAreScopedToHudson

Constructor Summary

Constructors

Constructor and Description
AbstractSpecificRunSelector()

Method Summary

Modifier and Type	Method and Description
abstract hudson.model.Run<?,?>	getBuild(hudson.model.Job<?,?> job, RunSelectorContext context) Override this method to implement AbstractSpecificRunSelector.
hudson.model.Run<?,?>	getNextBuild(hudson.model.Job<?,?> job, RunSelectorContext context) Override this method to implement RunSelector.

Methods inherited from class org.jenkinsci.plugins.runselector.RunSelector

getDisplayName, select

Methods inherited from class hudson.model.AbstractDescribableImpl

getDescriptor

Methods inherited from class java.lang.Object

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

Constructor Detail

AbstractSpecificRunSelector

public AbstractSpecificRunSelector()

Method Detail

getNextBuild

@CheckForNull
public final hudson.model.Run<?,?> getNextBuild(@Nonnull
                                                              hudson.model.Job<?,?> job,
                                                              @Nonnull
                                                              RunSelectorContext context)
                                                       throws IOException,
                                                              InterruptedException

Override this method to implement RunSelector. Use RunSelectorContext.getLastMatchBuild() to continue enumerating builds. Or you can save the execution state with RunSelectorContext.addExtension(Object)

Overrides:

getNextBuild in class RunSelector

Parameters:

job - the job to pick a build from.

context - context for the current execution of runselector.

Returns:

the build matches this selector.

Throws:

IOException - if an error occurs while performing the operation.

InterruptedException - if any thread interrupts the current thread.

getBuild

@CheckForNull
public abstract hudson.model.Run<?,?> getBuild(@Nonnull
                                                             hudson.model.Job<?,?> job,
                                                             @Nonnull
                                                             RunSelectorContext context)
                                                      throws IOException,
                                                             InterruptedException

Override this method to implement AbstractSpecificRunSelector.

Parameters:

job - the job to pick a build from.

context - context for the current execution of runselector.

Returns:

the build to select

Throws:

IOException - if an error occurs while performing the operation.

InterruptedException - if any thread interrupts the current thread.