hudson.matrix.listeners

Class MatrixBuildListener

java.lang.Object

hudson.matrix.listeners.MatrixBuildListener

All Implemented Interfaces:

hudson.ExtensionPoint

public abstract class MatrixBuildListener
extends Object
implements hudson.ExtensionPoint

Controls which subset of MatrixRuns to rebuild.

Plugins can implement this extension point to filter out the subset of matrix project to build. Most typically, such a plugin would add a custom Action to a build when it goes to the queue (Queue.schedule2(Task, int, List), then access this from MatrixBuild to drive the filtering logic.

See the matrix reloaded plugin for an example.

Since:

1.413

Author:

Christian Wolfgang

Nested Class Summary

Nested classes/interfaces inherited from interface hudson.ExtensionPoint

hudson.ExtensionPoint.LegacyInstancesAreScopedToHudson

Constructor Summary

Constructors

Constructor and Description
MatrixBuildListener()

Method Summary

Modifier and Type	Method and Description
static hudson.ExtensionList<MatrixBuildListener>	all() Returns all the registered MatrixBuildListener descriptors.
static boolean	buildConfiguration(MatrixBuild b, MatrixConfiguration c)
abstract boolean	doBuildConfiguration(MatrixBuild b, MatrixConfiguration c) Determine whether to build a given configuration or not

Methods inherited from class java.lang.Object

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

Constructor Detail

MatrixBuildListener

public MatrixBuildListener()

Method Detail

doBuildConfiguration

public abstract boolean doBuildConfiguration(MatrixBuild b,
                                             MatrixConfiguration c)

Determine whether to build a given configuration or not

Parameters:

b - Never null. The umbrella build.

c - The configuration whose build is being considered. If any of the MatrixBuildListener returns false, then the build for this configuration is skipped, and the previous build of this configuration will be taken as the default result.

Returns:

True to let the build happen, false to skip it.

buildConfiguration

public static boolean buildConfiguration(MatrixBuild b,
                                         MatrixConfiguration c)

all

@Nonnull
public static hudson.ExtensionList<MatrixBuildListener> all()

Returns all the registered MatrixBuildListener descriptors.