Package io.jenkins.plugins.dynamic_view_filter

Class DropdownFilterView

java.lang.Object

hudson.model.AbstractModelObject

hudson.model.View

hudson.model.ListView

io.jenkins.plugins.dynamic_view_filter.DropdownFilterView

All Implemented Interfaces:

ExtensionPoint, Describable<View>, DescriptorByNameOwner, DirectlyModifiableView, ModelObject, Saveable, SearchableModelObject, SearchItem, AccessControlled, ModelObjectWithChildren, HasWidgets

public class DropdownFilterView
extends ListView

A ListView extension that adds configurable dropdown filters at the top of the view. Each dropdown can filter jobs by a path segment of the job's full name or by a build parameter value.

Dropdown values are auto-discovered from the jobs in the view. Selecting a value in a dropdown narrows the displayed jobs. Multiple dropdowns combine with AND logic.

All standard ListView features (columns, job filters, regex) are preserved.

Nested Class Summary

Nested Classes

Modifier and Type	Class	Description
static class	DropdownFilterView.DescriptorImpl

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

ListView.Listener

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

View.PropertyList

Nested classes/interfaces inherited from interface hudson.ExtensionPoint

ExtensionPoint.LegacyInstancesAreScopedToHudson

Field Summary

Fields inherited from class hudson.model.View

CONFIGURE, CREATE, DELETE, description, filterExecutors, filterQueue, LIST, name, NEW_PRONOUN, owner, PERMISSIONS, READ, SORTER

Fields inherited from interface hudson.model.Saveable

NOOP

Constructor Summary

Constructors

Constructor	Description
DropdownFilterView(String name)
DropdownFilterView(String name, ViewGroup owner)

Method Summary

Modifier and Type	Method	Description
List<RunMatcher>	getActiveRunMatchers()	Returns dynamic RunMatcher filters derived from active build-parameter dropdown selections.
List<DropdownDefinition>	getDropdowns()
List<String>	getDropdownValues(DropdownDefinition dd)	Called from main.jelly to populate dropdown options.
String	getFilterPosition()
List<TopLevelItem>	getItems()
String	getSelectedValue(int index)	Called from main.jelly to mark the currently selected option.
void	setDropdowns(List<DropdownDefinition> dropdowns)
void	setFilterPosition(String filterPosition)
protected void	submit(org.kohsuke.stapler.StaplerRequest2 req)

Methods inherited from class hudson.model.ListView

add, contains, doAddJobToView, doCreateItem, doRemoveJobFromView, getColumns, getDefaultColumns, getIncludeRegex, getJobFilters, getJobNames, getStatusFilter, hasJobFilterExtensions, initColumns, initJobFilters, isAddToCurrentView, isRecurse, jobNamesContains, makeSearchIndex, readResolve, remove, setColumns, setIncludeRegex, setJobFilters, setJobNames, setRecurse, setStatusFilter, submit

Methods inherited from class hudson.model.View

all, allInstantiable, create, create, createViewFromXML, doCheckJobName, doChildrenContextMenu, doConfigDotXml, doConfigDotXml, doConfigSubmit, doCreateItem, doDoDelete, doItemCategories, doRssAll, doRssFailed, doRssLatest, doSubmitDescription, doSubmitDescription, getAbsoluteUrl, getACL, getActions, getAllItems, getAllProperties, getApi, getApplicablePropertyDescriptors, getApproximateQueueItemsQuickly, getBuilds, getComputers, getDescription, getDescriptor, getDisplayName, getDynamic, getIndenter, getItem, getItemCreatePermission, getJob, getNewPronoun, getOwner, getOwnerItemGroup, getOwnerPrimaryView, getOwnerViewActions, getPostConstructLandingPage, getProperties, getQueueItems, getSearchGroup, getSearchIcon, getSearchUrl, getTimeline, getUrl, getViewName, getViewUrl, getVisiblePropertyDescriptors, isAutomaticRefreshEnabled, isDefault, isEditable, isFilterExecutors, isFilterQueue, makeSearchIndex, onJobRenamed, registerPermissions, rename, save, setDescription, setFilterExecutors, setFilterQueue, toString, updateByXml, updateTransientActions, writeXml

Methods inherited from class hudson.model.AbstractModelObject

getSearch, getSearchIndex, getSearchName, requirePOST, sendError, sendError, sendError, sendError, sendError, sendError, sendError, sendError

Methods inherited from class java.lang.Object

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

Methods inherited from interface hudson.security.AccessControlled

checkAnyPermission, checkPermission, hasAnyPermission, hasPermission, hasPermission, hasPermission2

Methods inherited from interface hudson.model.DescriptorByNameOwner

getDescriptorByName

Methods inherited from interface jenkins.widgets.HasWidgets

getWidget, getWidgets

Methods inherited from interface jenkins.model.ModelObjectWithChildren

doChildrenContextMenu

Constructor Details

DropdownFilterView

@DataBoundConstructor
public DropdownFilterView(String name)

DropdownFilterView

public DropdownFilterView(String name,
 ViewGroup owner)

Method Details

getDropdowns

public List<DropdownDefinition> getDropdowns()

setDropdowns

public void setDropdowns(List<DropdownDefinition> dropdowns)

getFilterPosition

public String getFilterPosition()

setFilterPosition

public void setFilterPosition(String filterPosition)

getItems

public List<TopLevelItem> getItems()

Overrides:

getItems in class ListView

getDropdownValues

public List<String> getDropdownValues(DropdownDefinition dd)

Called from main.jelly to populate dropdown options. Uses the unfiltered list so all values are always visible.

getSelectedValue

public String getSelectedValue(int index)

Called from main.jelly to mark the currently selected option.

submit

protected void submit(org.kohsuke.stapler.StaplerRequest2 req)
               throws IOException,
jakarta.servlet.ServletException,
Descriptor.FormException

Overrides:

submit in class ListView

Throws:

IOException

jakarta.servlet.ServletException

Descriptor.FormException

getActiveRunMatchers

public List<RunMatcher> getActiveRunMatchers()

Returns dynamic RunMatcher filters derived from active build-parameter dropdown selections. Called by DynamicBuildFilterColumn to filter displayed builds based on dropdown selections.