jenkins.model

Class ParameterizedJobMixIn<JobT extends Job<JobT,RunT> & ParameterizedJobMixIn.ParameterizedJob<JobT,RunT> & Queue.Task,RunT extends Run<JobT,RunT> & Queue.Executable>

java.lang.Object

jenkins.model.ParameterizedJobMixIn<JobT,RunT>

public abstract class ParameterizedJobMixIn<JobT extends Job<JobT,RunT> & ParameterizedJobMixIn.ParameterizedJob<JobT,RunT> & Queue.Task,RunT extends Run<JobT,RunT> & Queue.Executable>
extends Object

Allows a Job to make use of ParametersDefinitionProperty and be scheduled in various ways. Stateless so there is no need to keep an instance of it in a field. Besides implementing ParameterizedJobMixIn.ParameterizedJob, you should

• override Job.makeSearchIndex() to call extendSearchIndex(hudson.search.SearchIndexBuilder)
• override AbstractItem.performDelete() to call ParameterizedJobMixIn.ParameterizedJob.makeDisabled(boolean)
• override Job.getIconColor() to call ParameterizedJobMixIn.ParameterizedJob.isDisabled()
• use <p:config-disableBuild/>
• use <p:makeDisabled/>

Since:

1.556

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static interface	ParameterizedJobMixIn.ParameterizedJob<JobT extends Job<JobT,RunT> & ParameterizedJobMixIn.ParameterizedJob<JobT,RunT> & Queue.Task,RunT extends Run<JobT,RunT> & Queue.Executable> Marker for job using this mixin, and default implementations of many methods.

Field Summary

Fields

Modifier and Type	Field and Description
static AlternativeUiTextProvider.Message<ParameterizedJobMixIn.ParameterizedJob>	BUILD_NOW_TEXT Allows customization of the human-readable display name to be rendered in the Build Now link.

Constructor Summary

Constructors

Constructor and Description
ParameterizedJobMixIn()

Method Summary

Modifier and Type	Method and Description
protected abstract JobT	asJob()
void	doBuild(org.kohsuke.stapler.StaplerRequest req, org.kohsuke.stapler.StaplerResponse rsp, TimeDuration delay) Standard implementation of ParameterizedJobMixIn.ParameterizedJob.doBuild(org.kohsuke.stapler.StaplerRequest, org.kohsuke.stapler.StaplerResponse, jenkins.util.TimeDuration).
void	doBuildWithParameters(org.kohsuke.stapler.StaplerRequest req, org.kohsuke.stapler.StaplerResponse rsp, TimeDuration delay) Standard implementation of ParameterizedJobMixIn.ParameterizedJob.doBuildWithParameters(org.kohsuke.stapler.StaplerRequest, org.kohsuke.stapler.StaplerResponse, jenkins.util.TimeDuration).
void	doCancelQueue(org.kohsuke.stapler.StaplerRequest req, org.kohsuke.stapler.StaplerResponse rsp) Standard implementation of ParameterizedJobMixIn.ParameterizedJob.doCancelQueue(org.kohsuke.stapler.StaplerRequest, org.kohsuke.stapler.StaplerResponse).
SearchIndexBuilder	extendSearchIndex(SearchIndexBuilder sib) Use from a Job.makeSearchIndex() override.
static CauseAction	getBuildCause(ParameterizedJobMixIn.ParameterizedJob job, org.kohsuke.stapler.StaplerRequest req) Computes the build cause, using RemoteCause or UserCause as appropriate.
String	getBuildNowText() Suggested implementation of ParameterizedJobMixIn.ParameterizedJob.getBuildNowText().
static <T extends Trigger<?>> T	getTrigger(Job<?,?> job, Class<T> clazz) Checks for the existence of a specific trigger on a job.
boolean	isParameterized() Standard implementation of ParameterizedJobMixIn.ParameterizedJob.isParameterized().
boolean	scheduleBuild()
boolean	scheduleBuild(Cause c)
boolean	scheduleBuild(int quietPeriod)
boolean	scheduleBuild(int quietPeriod, Cause c)
QueueTaskFuture<RunT>	scheduleBuild2(int quietPeriod, Action... actions) Standard implementation of ParameterizedJobMixIn.ParameterizedJob.scheduleBuild2(int, hudson.model.Action...).
static Queue.Item	scheduleBuild2(Job<?,?> job, int quietPeriod, Action... actions) Convenience method to schedule a build.

Methods inherited from class java.lang.Object

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

Field Detail

BUILD_NOW_TEXT

public static final AlternativeUiTextProvider.Message<ParameterizedJobMixIn.ParameterizedJob> BUILD_NOW_TEXT

Allows customization of the human-readable display name to be rendered in the Build Now link.

Since:

1.624

See Also:

getBuildNowText()

Constructor Detail

ParameterizedJobMixIn

public ParameterizedJobMixIn()

Method Detail

asJob

protected abstract JobT asJob()

scheduleBuild

public final boolean scheduleBuild()

See Also:

BuildableItem.scheduleBuild()

scheduleBuild

public final boolean scheduleBuild(Cause c)

See Also:

BuildableItem.scheduleBuild(Cause)

scheduleBuild

public final boolean scheduleBuild(int quietPeriod)

See Also:

BuildableItem.scheduleBuild(int)

scheduleBuild

public final boolean scheduleBuild(int quietPeriod,
                                   Cause c)

See Also:

BuildableItem.scheduleBuild(int, Cause)

scheduleBuild2

@CheckForNull
public final QueueTaskFuture<RunT> scheduleBuild2(int quietPeriod,
                                                                Action... actions)

Standard implementation of ParameterizedJobMixIn.ParameterizedJob.scheduleBuild2(int, hudson.model.Action...).

scheduleBuild2

@CheckForNull
public static Queue.Item scheduleBuild2(Job<?,?> job,
                                                      int quietPeriod,
                                                      Action... actions)

Convenience method to schedule a build. Useful for Trigger implementations, for example. If you need to wait for the build to start (or finish), use Queue.Item#getFuture.

Parameters:

job - a job which might be schedulable

quietPeriod - seconds to wait before starting; use -1 to use the job’s default settings

actions - various actions to associate with the scheduling, such as ParametersAction or CauseAction

Returns:

a newly created, or reused, queue item if the job could be scheduled; null if it was refused for some reason (e.g., some Queue.QueueDecisionHandler rejected it), or if job is not a ParameterizedJobMixIn.ParameterizedJob or it is not Job.isBuildable())

Since:

1.621

isParameterized

public final boolean isParameterized()

Standard implementation of ParameterizedJobMixIn.ParameterizedJob.isParameterized().

doBuild

public final void doBuild(org.kohsuke.stapler.StaplerRequest req,
                          org.kohsuke.stapler.StaplerResponse rsp,
                          @QueryParameter
                          TimeDuration delay)
                   throws IOException,
                          javax.servlet.ServletException

Standard implementation of ParameterizedJobMixIn.ParameterizedJob.doBuild(org.kohsuke.stapler.StaplerRequest, org.kohsuke.stapler.StaplerResponse, jenkins.util.TimeDuration).

Throws:

IOException

javax.servlet.ServletException

doBuildWithParameters

public final void doBuildWithParameters(org.kohsuke.stapler.StaplerRequest req,
                                        org.kohsuke.stapler.StaplerResponse rsp,
                                        @QueryParameter
                                        TimeDuration delay)
                                 throws IOException,
                                        javax.servlet.ServletException

Standard implementation of ParameterizedJobMixIn.ParameterizedJob.doBuildWithParameters(org.kohsuke.stapler.StaplerRequest, org.kohsuke.stapler.StaplerResponse, jenkins.util.TimeDuration).

Throws:

IOException

javax.servlet.ServletException

doCancelQueue

public final void doCancelQueue(org.kohsuke.stapler.StaplerRequest req,
                                org.kohsuke.stapler.StaplerResponse rsp)
                         throws IOException,
                                javax.servlet.ServletException

Standard implementation of ParameterizedJobMixIn.ParameterizedJob.doCancelQueue(org.kohsuke.stapler.StaplerRequest, org.kohsuke.stapler.StaplerResponse).

Throws:

IOException

javax.servlet.ServletException

extendSearchIndex

public final SearchIndexBuilder extendSearchIndex(SearchIndexBuilder sib)

Use from a Job.makeSearchIndex() override.

Parameters:

sib - the super value

Returns:

the value to return

getBuildCause

@Restricted(value=org.kohsuke.accmod.restrictions.NoExternalUse.class)
public static final CauseAction getBuildCause(ParameterizedJobMixIn.ParameterizedJob job,
                                                                                                                     org.kohsuke.stapler.StaplerRequest req)

Computes the build cause, using RemoteCause or UserCause as appropriate.

getBuildNowText

public final String getBuildNowText()

Suggested implementation of ParameterizedJobMixIn.ParameterizedJob.getBuildNowText().

getTrigger

@CheckForNull
public static <T extends Trigger<?>> T getTrigger(Job<?,?> job,
                                                                Class<T> clazz)

Checks for the existence of a specific trigger on a job.

Type Parameters:

T - a trigger type

Parameters:

job - a job

clazz - the type of the trigger

Returns:

a configured trigger of the requested type, or null if there is none such, or job is not a ParameterizedJobMixIn.ParameterizedJob

Since:

1.621