public interface ReconfigurableDescribable<T extends ReconfigurableDescribable<T>> extends Describable<T>
Describables that allow the current instances to pass information down to the next instance when the configuration is submitted.
As the generics signature implies, it isn't up to individual
Describable implementation to
implement this. Rather, it is up to the designer of an extension point to mark the extension point
ReconfigurableDescribable, as it requires coordination at the owner of the extension point.
This mechanism can be used to create an entirely invisible
Describable, which is handy
JobProperty, etc. To do so, define a descriptor with null
display name and empty config.jelly to prevent it from
showing up in the config UI, then implement
and simply return
Describable object may have some expensive objects that you might want to
hand over to the next instance. This hook lets you do that.
|Modifier and Type||Method and Description|
When a parent/owner object of a Describable gets a config form submission and instances are recreated, this method is invoked on the existing instance (meaning the 'this' reference points to the existing instance) to create a new instance to be added to the parent/owner object.
@CheckForNull T reconfigure(@Nonnull org.kohsuke.stapler.StaplerRequest req, @CheckForNull net.sf.json.JSONObject form) throws Descriptor.FormException
The default implementation of this should be the following:
return form==null ? null : getDescriptor().newInstance(req, form);
req- The current HTTP request being processed.
form- JSON fragment that corresponds to this describable object. If the newly submitted form doesn't include a fragment for this describable (meaning the user has de-selected your descriptor), then this argument is null.
Copyright © 2004–2017. All rights reserved.