org.jenkinsci.plugins.runselector.context

Class RunSelectorContext

java.lang.Object

org.jenkinsci.plugins.runselector.context.RunSelectorContext

All Implemented Interfaces:

Cloneable

public class RunSelectorContext
extends Object
implements Cloneable

Context for an execution of runselector. This allows us to adding new fields without affecting existing plugins.

You can manage plugin specific information using addExtension(Object) and getExtension(Class).

Constructor Summary

Constructors

Constructor and Description
RunSelectorContext(jenkins.model.Jenkins jenkins, hudson.model.Run<?,?> build, hudson.model.TaskListener listener) Creates a new RunSelectorContext with NoRunFilter.
RunSelectorContext(jenkins.model.Jenkins jenkins, hudson.model.Run<?,?> build, hudson.model.TaskListener listener, RunFilter runFilter) Creates a new RunSelectorContext.

Method Summary

Modifier and Type	Method and Description
void	addExtension(Object extension) Add an object to hold plugin specific information.
RunSelectorContext	clone()
hudson.model.Run<?,?>	getBuild()
PrintStream	getConsole() Shortcut for getListener().getLogger()
hudson.EnvVars	getEnvVars()
<T> T	getExtension(Class<T> clazz) Extract an extension object of the specified class.
List<Object>	getExtensionList()
jenkins.model.Jenkins	getJenkins()
hudson.model.Run<?,?>	getLastMatchBuild() The build picked at the last time (but not matched with the filter).
hudson.model.TaskListener	getListener()
RunFilter	getRunFilter()
boolean	isVerbose()
void	logDebug(String message) Outputs a log message if isVerbose() is true
void	logDebug(String pattern, Object... arguments) Outputs a log message in MessageFormat formats if isVerbose() is true
void	logException(String string, Throwable t) Outputs a log message with an exception
void	logInfo(String message) Outputs a log message
void	logInfo(String pattern, Object... arguments) Outputs a log message in MessageFormat formats.
boolean	removeExtension(Object extension)
boolean	replaceExtension(Object extension) Removes extensions with the same class type before adding.
void	setLastMatchBuild(hudson.model.Run<?,?> lastMatchBuild)
void	setRunFilter(RunFilter runFilter)
void	setVerbose(boolean verbose)

Methods inherited from class java.lang.Object

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

Constructor Detail

RunSelectorContext

public RunSelectorContext(@Nonnull
                          jenkins.model.Jenkins jenkins,
                          @Nonnull
                          hudson.model.Run<?,?> build,
                          @Nonnull
                          hudson.model.TaskListener listener)
                   throws IOException,
                          InterruptedException

Creates a new RunSelectorContext with NoRunFilter.

Parameters:

jenkins - the Jenkins instance

build - the build running runselector

listener - listener for the build running runselector

Throws:

IOException

InterruptedException

RunSelectorContext

public RunSelectorContext(@Nonnull
                          jenkins.model.Jenkins jenkins,
                          @Nonnull
                          hudson.model.Run<?,?> build,
                          @Nonnull
                          hudson.model.TaskListener listener,
                          @Nonnull
                          RunFilter runFilter)
                   throws IOException,
                          InterruptedException

Creates a new RunSelectorContext.

Parameters:

jenkins - the Jenkins instance

build - the build running runselector

listener - listener for the build running runselector

Throws:

IOException

InterruptedException

Method Detail

getJenkins

@Nonnull
public jenkins.model.Jenkins getJenkins()

Returns:

the Jenkins instance

getBuild

@Nonnull
public hudson.model.Run<?,?> getBuild()

Returns:

the build running runselector

getListener

@Nonnull
public hudson.model.TaskListener getListener()

Returns:

the listener for the build running runselector

getEnvVars

@Nonnull
public hudson.EnvVars getEnvVars()

Returns:

environment variables for the current build

getConsole

@Nonnull
public PrintStream getConsole()

Shortcut for getListener().getLogger()

Returns:

stream to output logs

setVerbose

public void setVerbose(boolean verbose)

Parameters:

verbose - whether output verbose (for diagnostics) logs

isVerbose

public boolean isVerbose()

Returns:

whether output verbose (for diagnostics) logs

setRunFilter

public void setRunFilter(@Nonnull
                         RunFilter runFilter)

Parameters:

runFilter - the filter for builds

getRunFilter

@Nonnull
public RunFilter getRunFilter()

Returns:

a filter for builds

setLastMatchBuild

public void setLastMatchBuild(hudson.model.Run<?,?> lastMatchBuild)

Parameters:

lastMatchBuild - build picked at the last time

getLastMatchBuild

@CheckForNull
public hudson.model.Run<?,?> getLastMatchBuild()

The build picked at the last time (but not matched with the filter). RunSelectors should continue the enumeration from this.

Returns:

build picked at the last time

getExtensionList

@Nonnull
public List<Object> getExtensionList()

Returns:

additional information by plugins

addExtension

public void addExtension(@Nonnull
                         Object extension)

Add an object to hold plugin specific information.

Parameters:

extension - extension object

removeExtension

public boolean removeExtension(@Nonnull
                               Object extension)

Parameters:

extension - extension object to remove

Returns:

true if the extension is contained

replaceExtension

public boolean replaceExtension(@Nonnull
                                Object extension)

Removes extensions with the same class type before adding.

Parameters:

extension - extension object to replace with

Returns:

true if an extension object of the same class class is contained

getExtension

@CheckForNull
public <T> T getExtension(@Nonnull
                                        Class<T> clazz)

Extract an extension object of the specified class.

Type Parameters:

T - specified with clazz

Parameters:

clazz - class of the extension to extract

Returns:

extension of the class

logInfo

public void logInfo(@Nonnull
                    String message)

Outputs a log message

Parameters:

message - message to log

logInfo

public void logInfo(@Nonnull
                    String pattern,
                    Object... arguments)

Outputs a log message in MessageFormat formats.

Parameters:

pattern - pattern for MessageFormat

arguments - values to format

logDebug

public void logDebug(@Nonnull
                     String message)

Outputs a log message if isVerbose() is true

Parameters:

message - message to log

logDebug

public void logDebug(@Nonnull
                     String pattern,
                     Object... arguments)

Outputs a log message in MessageFormat formats if isVerbose() is true

Parameters:

pattern - pattern for MessageFormat

arguments - values to format

logException

public void logException(@Nonnull
                         String string,
                         @Nonnull
                         Throwable t)

Outputs a log message with an exception

Parameters:

string - message to log

t - exception to log

clone

public RunSelectorContext clone()

Overrides:

clone in class Object