Package hudson.util

Class DescriptorList<T extends Describable<T>>

java.lang.Object

java.util.AbstractCollection<E>

java.util.AbstractList<Descriptor<T>>

hudson.util.DescriptorList<T>

All Implemented Interfaces:

Iterable<Descriptor<T>>, Collection<Descriptor<T>>, List<Descriptor<T>>

public final class DescriptorList<T extends Describable<T>>
extends AbstractList<Descriptor<T>>

List of Descriptors.

Before Hudson 1.286, this class stored Descriptors directly, but since 1.286, this class works in two modes that are rather different.

One is the compatibility mode, where it works just like pre 1.286 and store everything locally, disconnected from any of the additions of 1.286. This is necessary for situations where DescriptorList is owned by pre-1.286 plugins where this class doesn't know 'T'. In this mode, legacy is non-null but type is null.

The other mode is the new mode, where the Descriptors are actually stored in ExtensionList (see Jenkins.getDescriptorList(Class)) and this class acts as a view to it. This enables bi-directional interoperability — both descriptors registered automatically and descriptors registered manually are visible from both DescriptorList and ExtensionList. In this mode, legacy is null but type is non-null.

The number of plugins that define extension points are limited, so we expect to be able to remove this dual behavior first, then when everyone stops using DescriptorList, we can remove this class altogether.

Since:

1.161

Author:

Kohsuke Kawaguchi

Field Summary

Fields inherited from class java.util.AbstractList

modCount

Constructor Summary

Constructors

Constructor	Description
DescriptorList(Descriptor<T>... descriptors)	Deprecated. As of 1.286.
DescriptorList(Class<T> type)	Creates a DescriptorList backed by ExtensionList.

Method Summary

Modifier and Type	Method	Description
void	add(int index, Descriptor<T> element)	Deprecated. As of 1.286.
boolean	add(Descriptor<T> d)	Deprecated. As of 1.286.
Descriptor<T>	find(String fqcn)	Deprecated. Underspecified what the parameter is.
Descriptor<T>	findByName(String id)	Finds a descriptor by their Descriptor.getId().
Descriptor<T>	get(int index)
Iterator<Descriptor<T>>	iterator()
void	load(Class<? extends Describable> c)	No-op method used to force the class initialization of the given class.
T	newInstanceFromRadioList(net.sf.json.JSONObject config)	Creates a new instance of a Describable from the structured form submission data posted by a radio button group.
T	newInstanceFromRadioList(net.sf.json.JSONObject parent, String name)	Creates a new instance of a Describable from the structured form submission data posted by a radio button group.
boolean	remove(Object o)
int	size()

Methods inherited from class java.util.AbstractList

addAll, clear, equals, hashCode, indexOf, lastIndexOf, listIterator, listIterator, remove, removeRange, set, subList

Methods inherited from class java.util.AbstractCollection

addAll, contains, containsAll, isEmpty, removeAll, retainAll, toArray, toArray, toString

Methods inherited from class java.lang.Object

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

Methods inherited from interface java.util.Collection

parallelStream, removeIf, stream

Methods inherited from interface java.lang.Iterable

forEach

Methods inherited from interface java.util.List

addAll, contains, containsAll, isEmpty, removeAll, replaceAll, retainAll, sort, spliterator, toArray, toArray

Constructor Detail

DescriptorList

@Deprecated
public DescriptorList(Descriptor<T>... descriptors)

Deprecated.

As of 1.286. Use DescriptorList(Class) instead.

This will create a legacy DescriptorList that is disconnected from ExtensionList.

DescriptorList

public DescriptorList(Class<T> type)

Creates a DescriptorList backed by ExtensionList.

Method Detail

get

public Descriptor<T> get(int index)

Specified by:

get in interface List<T extends Describable<T>>

Specified by:

get in class AbstractList<Descriptor<T extends Describable<T>>>

size

public int size()

Specified by:

size in interface Collection<T extends Describable<T>>

Specified by:

size in interface List<T extends Describable<T>>

Specified by:

size in class AbstractCollection<Descriptor<T extends Describable<T>>>

iterator

public Iterator<Descriptor<T>> iterator()

Specified by:

iterator in interface Collection<T extends Describable<T>>

Specified by:

iterator in interface Iterable<T extends Describable<T>>

Specified by:

iterator in interface List<T extends Describable<T>>

Overrides:

iterator in class AbstractList<Descriptor<T extends Describable<T>>>

add

@Deprecated
public boolean add(Descriptor<T> d)

Deprecated.

As of 1.286. Put Extension on your descriptor to have it auto-registered, instead of registering a descriptor manually.

Specified by:

add in interface Collection<T extends Describable<T>>

Specified by:

add in interface List<T extends Describable<T>>

Overrides:

add in class AbstractList<Descriptor<T extends Describable<T>>>

add

@Deprecated
public void add(int index,
                Descriptor<T> element)

Deprecated.

As of 1.286. Put Extension on your descriptor to have it auto-registered, instead of registering a descriptor manually.

Specified by:

add in interface List<T extends Describable<T>>

Overrides:

add in class AbstractList<Descriptor<T extends Describable<T>>>

remove

public boolean remove(Object o)

Specified by:

remove in interface Collection<T extends Describable<T>>

Specified by:

remove in interface List<T extends Describable<T>>

Overrides:

remove in class AbstractCollection<Descriptor<T extends Describable<T>>>

newInstanceFromRadioList

@CheckForNull
public T newInstanceFromRadioList(net.sf.json.JSONObject config)
                           throws Descriptor.FormException

Creates a new instance of a Describable from the structured form submission data posted by a radio button group.

Parameters:

config - Submitted configuration for Radio List

Returns:

New instance. null if none was selected in the radio list or if the value is filtered by a DescriptorVisibilityFilter

Throws:

Descriptor.FormException - Data submission error

newInstanceFromRadioList

@CheckForNull
public T newInstanceFromRadioList(net.sf.json.JSONObject parent,
                                  String name)
                           throws Descriptor.FormException

Creates a new instance of a Describable from the structured form submission data posted by a radio button group.

Parameters:

parent - JSON, which contains the configuration entry for the radio list

name - Name of the configuration entry for the radio list

Returns:

New instance. null if none was selected in the radio list or if the value is filtered by a DescriptorVisibilityFilter

Throws:

Descriptor.FormException - Data submission error

findByName

@CheckForNull
public Descriptor<T> findByName(String id)

Finds a descriptor by their Descriptor.getId().

Parameters:

id - Descriptor ID

Returns:

If none is found, null is returned.

load

public void load(Class<? extends Describable> c)

No-op method used to force the class initialization of the given class. The class initialization in turn is expected to put the descriptor into the DescriptorList.

This is necessary to resolve the class initialization order problem. Often a DescriptorList is defined in the base class, and when it tries to initialize itself by listing up descriptors of known sub-classes, they might not be available in time.

Since:

1.162

find

@Deprecated
@CheckForNull
public Descriptor<T> find(String fqcn)

Deprecated.

Underspecified what the parameter is. Descriptor.getId()? A Describable class name?

Finds the descriptor that has the matching fully-qualified class name.