hudson.model
Class RunParameterDefinition.DescriptorImpl

java.lang.Object
  hudson.model.Descriptor<ParameterDefinition>
      hudson.model.ParameterDefinition.ParameterDescriptor
          hudson.model.RunParameterDefinition.DescriptorImpl

All Implemented Interfaces:

Saveable

Enclosing class:

RunParameterDefinition

@Extension
public static class RunParameterDefinition.DescriptorImpl
extends ParameterDefinition.ParameterDescriptor

Nested Class Summary

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

Descriptor.FormException, Descriptor.PropertyType, Descriptor.Self

Field Summary

Fields inherited from class hudson.model.Descriptor

clazz

Fields inherited from interface hudson.model.Saveable

NOOP

Constructor Summary

RunParameterDefinition.DescriptorImpl()

Method Summary

AutoCompletionCandidates	doAutoCompleteProjectName(String value)
String	getDisplayName() Human readable name of this kind of configurable object.
String	getHelpFile() Returns the resource path to the help screen HTML, if any.
ParameterDefinition	newInstance(org.kohsuke.stapler.StaplerRequest req, net.sf.json.JSONObject formData) Creates a configured instance from the submitted form.

Methods inherited from class hudson.model.ParameterDefinition.ParameterDescriptor

getValuePage

Methods inherited from class hudson.model.Descriptor

addHelpFileRedirect, calcAutoCompleteSettings, calcFillSettings, configure, configure, doHelp, find, find, getCheckUrl, getConfigFile, getConfigPage, getCurrentDescriptorByNameUrl, getDescriptorFullUrl, getDescriptorUrl, getGlobalConfigPage, getGlobalPropertyType, getHelpFile, getHelpFile, getId, getJsonSafeClassName, getKlass, getPlugin, getPossibleViewNames, getPropertyType, getPropertyType, getPropertyTypeOrDie, getT, getViewPage, isInstance, isSubTypeOf, load, newInstance, newInstancesFromHeteroList, newInstancesFromHeteroList, save, self, toArray, toList, toMap

Methods inherited from class java.lang.Object

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

Constructor Detail

RunParameterDefinition.DescriptorImpl

public RunParameterDefinition.DescriptorImpl()

Method Detail

getDisplayName

public String getDisplayName()

Description copied from class: Descriptor

Human readable name of this kind of configurable object.

Overrides:

getDisplayName in class ParameterDefinition.ParameterDescriptor

getHelpFile

public String getHelpFile()

Description copied from class: Descriptor

Returns the resource path to the help screen HTML, if any.

Starting 1.282, this method uses "convention over configuration" — you should just put the "help.html" (and its localized versions, if any) in the same directory you put your Jelly view files, and this method will automatically does the right thing.

This value is relative to the context root of Hudson, so normally the values are something like "/plugin/emma/help.html" to refer to static resource files in a plugin, or "/publisher/EmmaPublisher/abc" to refer to Jelly script abc.jelly or a method EmmaPublisher.doAbc().

Overrides:

getHelpFile in class Descriptor<ParameterDefinition>

Returns:

null to indicate that there's no help.

newInstance

public ParameterDefinition newInstance(org.kohsuke.stapler.StaplerRequest req,
                                       net.sf.json.JSONObject formData)
                                throws Descriptor.FormException

Description copied from class: Descriptor

Creates a configured instance from the submitted form.

Hudson only invokes this method when the user wants an instance of T. So there's no need to check that in the implementation.

Starting 1.206, the default implementation of this method does the following:

 req.bindJSON(clazz,formData);
 

... which performs the databinding on the constructor of Descriptor.clazz.

For some types of Describable, such as ListViewColumn, this method can be invoked with null request object for historical reason. Such design is considered broken, but due to the compatibility reasons we cannot fix it. Because of this, the default implementation gracefully handles null request, but the contract of the method still is "request is always non-null." Extension points that need to define the "default instance" semantics should define a descriptor subtype and add the no-arg newInstance method.

Overrides:

newInstance in class Descriptor<ParameterDefinition>

Parameters:

req - Always non-null (see note above.) This object includes represents the entire submission.

formData - The JSON object that captures the configuration data for this Descriptor. See http://wiki.jenkins-ci.org/display/JENKINS/Structured+Form+Submission Always non-null.

Throws:

Descriptor.FormException - Signals a problem in the submitted form.

doAutoCompleteProjectName

public AutoCompletionCandidates doAutoCompleteProjectName(@QueryParameter
                                                          String value)