Package hudson.plugins.promoted_builds.parameters

Class PromotedBuildParameterDefinition

java.lang.Object

hudson.model.ParameterDefinition

hudson.model.SimpleParameterDefinition

hudson.plugins.promoted_builds.parameters.PromotedBuildParameterDefinition

All Implemented Interfaces:

ExtensionPoint, Describable<ParameterDefinition>, Serializable

public class PromotedBuildParameterDefinition
extends SimpleParameterDefinition

Defines a parameter that allows the user to select a promoted build from a drop down list.

Remarks on addressing: Starting from TODO, the field also supports folders and the relative addressing (JENKINS-25011). See ItemPathResolver.getByPath(java.lang.String, hudson.model.Item, java.lang.Class) for the documentation.

Author:

Pete Hayes

See Also:

• Serialized Form

Nested Class Summary

Nested Classes

Modifier and Type	Class	Description
static class	PromotedBuildParameterDefinition.DescriptorImpl

Nested classes/interfaces inherited from class hudson.model.ParameterDefinition

ParameterDefinition.ParameterDescriptor

Nested classes/interfaces inherited from interface hudson.ExtensionPoint

ExtensionPoint.LegacyInstancesAreScopedToHudson

Field Summary

Fields inherited from class hudson.model.ParameterDefinition

LIST

Constructor Summary

Constructors

Constructor	Description
PromotedBuildParameterDefinition(String name, String jobName, String process, String description)

Method Summary

Modifier and Type	Method	Description
ParameterDefinition	copyWithDefaultValue(ParameterValue defaultValue)
PromotedBuildParameterValue	createValue(String value)
PromotedBuildParameterValue	createValue(org.kohsuke.stapler.StaplerRequest2 req, net.sf.json.JSONObject jo)
List	getBuilds()	Deprecated. This method retrieves the base item for relative addressing from the StaplerRequest2.
PromotedBuildParameterValue	getDefaultParameterValue()
String	getJobName()	Absolute path to the item starting from the root element.
String	getProcess()
List<Run<?,?>>	getRuns(Item base)	Gets a list of promoted builds for the project.

Methods inherited from class hudson.model.SimpleParameterDefinition

createValue, createValue

Methods inherited from class hudson.model.ParameterDefinition

all, createValue, createValue, equals, getDescription, getDescriptor, getFormattedDescription, getName, getType, hashCode, isValid, setDescription

Methods inherited from class java.lang.Object

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

Constructor Details

PromotedBuildParameterDefinition

@DataBoundConstructor
public PromotedBuildParameterDefinition(String name,
 String jobName,
 String process,
 String description)

Method Details

createValue

public PromotedBuildParameterValue createValue(org.kohsuke.stapler.StaplerRequest2 req,
 net.sf.json.JSONObject jo)

Overrides:

createValue in class ParameterDefinition

createValue

public PromotedBuildParameterValue createValue(String value)

Specified by:

createValue in class SimpleParameterDefinition

getDefaultParameterValue

public PromotedBuildParameterValue getDefaultParameterValue()

Overrides:

getDefaultParameterValue in class ParameterDefinition

copyWithDefaultValue

public ParameterDefinition copyWithDefaultValue(ParameterValue defaultValue)

Overrides:

copyWithDefaultValue in class ParameterDefinition

getJobName

@Exported
public String getJobName()

Absolute path to the item starting from the root element.

getProcess

@Exported
public String getProcess()

getBuilds

@NonNull
@Deprecated
public List getBuilds()

Deprecated.

This method retrieves the base item for relative addressing from the StaplerRequest2. The relative addressing may be malfunctional if you use this method outside StaplerRequest2s. Use getRuns(hudson.model.Item) instead

Gets a list of promoted builds for the project.

Returns:

List of AbstractBuilds, which have been promoted

getRuns

@NonNull
public List<Run<?,?>> getRuns(@CheckForNull
 Item base)

Gets a list of promoted builds for the project.

Parameters:

base - Base item for the relative addressing

Returns:

List of AbstractBuilds, which have been promoted. May return an empty list if Jenkins instance is not ready

Since:

2.22