hudson.model

Class TopLevelItemDescriptor

java.lang.Object

hudson.model.Descriptor<TopLevelItem>

hudson.model.TopLevelItemDescriptor

All Implemented Interfaces:

Saveable

Direct Known Subclasses:

AbstractProject.AbstractProjectDescriptor

public abstract class TopLevelItemDescriptor
extends Descriptor<TopLevelItem>

Descriptor for TopLevelItems.

Author:

Kohsuke Kawaguchi

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

Constructors

Modifier	Constructor and Description
protected	TopLevelItemDescriptor() Infers the type of the corresponding TopLevelItem from the outer class.
protected	TopLevelItemDescriptor(Class<? extends TopLevelItem> clazz)

Method Summary

Modifier and Type	Method and Description
static ExtensionList<TopLevelItemDescriptor>	all() Returns all the registered TopLevelItem descriptors.
void	checkApplicableIn(ItemGroup parent) Checks if this top level item is applicable within the specified item group.
String	getDisplayName() Human readable name of this kind of configurable object.
boolean	isApplicable(Descriptor descriptor) TopLevelItemDescriptors often uses other descriptors to decorate itself.
boolean	isApplicableIn(ItemGroup parent) TopLevelItemDescriptors often may want to limit the scope within which they can be created.
abstract TopLevelItem	newInstance(ItemGroup parent, String name) Creates a new TopLevelItem for the specified parent.
TopLevelItem	newInstance(org.kohsuke.stapler.StaplerRequest req) Deprecated. since 2007-01-19. This is not a valid operation for Items.
TopLevelItem	newInstance(String name) Deprecated. as of 1.390 Use newInstance(ItemGroup, String)
boolean	testInstance(TopLevelItem i) Tests if the given instance belongs to this descriptor, in the sense that this descriptor can produce items like the given one.

Methods inherited from class hudson.model.Descriptor

addHelpFileRedirect, calcAutoCompleteSettings, calcFillSettings, configure, configure, doHelp, find, find, findByDescribableClassName, findById, getCheckMethod, getCheckUrl, getConfigFile, getConfigPage, getCurrentDescriptorByNameUrl, getDescriptorFullUrl, getDescriptorUrl, getGlobalConfigPage, getGlobalPropertyType, getHelpFile, 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

TopLevelItemDescriptor

protected TopLevelItemDescriptor(Class<? extends TopLevelItem> clazz)

TopLevelItemDescriptor

protected TopLevelItemDescriptor()

Infers the type of the corresponding TopLevelItem from the outer class. This version works when you follow the common convention, where a descriptor is written as the static nested class of the describable class.

Since:

1.278

Method Detail

isApplicable

public boolean isApplicable(Descriptor descriptor)

TopLevelItemDescriptors often uses other descriptors to decorate itself. This method allows the subtype of TopLevelItemDescriptors to filter them out.

This is useful for a workflow/company specific item type that wants to eliminate options that the user would see.

Since:

1.294

isApplicableIn

public boolean isApplicableIn(ItemGroup parent)

TopLevelItemDescriptors often may want to limit the scope within which they can be created. This method allows the subtype of TopLevelItemDescriptors to filter them out.

Since:

1.607

checkApplicableIn

public final void checkApplicableIn(ItemGroup parent)

Checks if this top level item is applicable within the specified item group.

This is just a convenience function.

Since:

1.607

testInstance

public boolean testInstance(TopLevelItem i)

Tests if the given instance belongs to this descriptor, in the sense that this descriptor can produce items like the given one.

TopLevelItemDescriptors that act like a wizard and produces different object types than Descriptor.clazz can override this method to augment instance-descriptor relationship.

Since:

1.410

getDisplayName

public String getDisplayName()

Human readable name of this kind of configurable object. Should be overridden for most descriptors, if the display name is visible somehow. As a fallback it uses Class.getSimpleName() on Descriptor.clazz, so for example MyThing from some.pkg.MyThing.DescriptorImpl. Historically some implementations returned null as a way of hiding the descriptor from the UI, but this is generally managed by an explicit method such as isEnabled or isApplicable.

Used as the caption when the user chooses what item type to create. The descriptor implementation also needs to have newInstanceDetail.jelly script, which will be used to render the text below the caption that explains the item type.

Overrides:

getDisplayName in class Descriptor<TopLevelItem>

newInstance

@Deprecated
public TopLevelItem newInstance(org.kohsuke.stapler.StaplerRequest req)
                                     throws Descriptor.FormException

Deprecated. since 2007-01-19. This is not a valid operation for Items.

Overrides:

newInstance in class Descriptor<TopLevelItem>

Throws:

Descriptor.FormException

newInstance

@Deprecated
public TopLevelItem newInstance(String name)

Deprecated. as of 1.390 Use newInstance(ItemGroup, String)

Creates a new TopLevelItem.

newInstance

public abstract TopLevelItem newInstance(ItemGroup parent,
                                         String name)

Creates a new TopLevelItem for the specified parent.

Since:

1.390

all

public static ExtensionList<TopLevelItemDescriptor> all()

Returns all the registered TopLevelItem descriptors.