hudson.model

Class ListView

java.lang.Object

hudson.model.AbstractModelObject

hudson.model.View

hudson.model.ListView

All Implemented Interfaces:

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

public class ListView
extends View
implements DirectlyModifiableView

Displays Jobs in a flat list view.

Author:

Kohsuke Kawaguchi

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static class	ListView.DescriptorImpl
static class	ListView.Listener

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

View.AsynchPeople, View.People, View.PropertyList, View.UserInfo

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, transientActions

Fields inherited from interface hudson.model.Saveable

NOOP

Constructor Summary

Constructors

Constructor and Description
ListView(String name)
ListView(String name, ViewGroup owner)

Method Summary

Modifier and Type	Method and Description
void	add(TopLevelItem item) Adds the given item to this view.
boolean	contains(TopLevelItem item) Checks if the job is in this collection.
org.kohsuke.stapler.HttpResponse	doAddJobToView(String name) Handle addJobToView web method.
Item	doCreateItem(org.kohsuke.stapler.StaplerRequest req, org.kohsuke.stapler.StaplerResponse rsp) Creates a new Item in this collection.
org.kohsuke.stapler.HttpResponse	doRemoveJobFromView(String name) Handle removeJobFromView web method.
DescribableList<ListViewColumn,Descriptor<ListViewColumn>>	getColumns() If this view uses <t:projectView> for rendering, this method returns columns to be displayed.
static List<ListViewColumn>	getDefaultColumns() Deprecated. as of 1.391 Use ListViewColumn.createDefaultInitialColumnList()
String	getIncludeRegex()
List<TopLevelItem>	getItems() Returns a read-only view of all Jobs in this view.
DescribableList<ViewJobFilter,Descriptor<ViewJobFilter>>	getJobFilters()
Boolean	getStatusFilter() Filter by enabled/disabled status of jobs.
boolean	hasJobFilterExtensions() Used to determine if we want to display the Add button.
protected void	initColumns()
protected void	initJobFilters()
boolean	isRecurse()
boolean	jobNamesContains(TopLevelItem item)
boolean	remove(TopLevelItem item) Removes given item from this view.
void	setIncludeRegex(String includeRegex)
void	setRecurse(boolean recurse)
protected void	submit(org.kohsuke.stapler.StaplerRequest req) Handles the configuration submission.

Methods inherited from class hudson.model.View

all, allInstantiable, checkPermission, create, createViewFromXML, doChildrenContextMenu, doConfigDotXml, doConfigSubmit, doDoDelete, doRssAll, doRssFailed, doRssLatest, doSubmitDescription, getAbsoluteUrl, getACL, getActions, getAllItems, getAllProperties, getApi, getApplicablePropertyDescriptors, getApproximateQueueItemsQuickly, getAsynchPeople, getBuilds, getComputers, getDescription, getDescriptor, getDisplayName, getDynamic, getIndenter, getItem, getItemCreatePermission, getJob, getNewPronoun, getOwner, getOwnerItemGroup, getOwnerPrimaryView, getOwnerViewActions, getPeople, getPostConstructLandingPage, getProperties, getQueueItems, getSearchUrl, getTimeline, getUrl, getViewName, getViewUrl, getWidgets, hasPeople, hasPermission, isAutomaticRefreshEnabled, isDefault, isEditable, isFilterExecutors, isFilterQueue, makeSearchIndex, onJobRenamed, rename, save, toString, updateByXml, updateTransientActions, writeXml

Methods inherited from class hudson.model.AbstractModelObject

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

Methods inherited from class java.lang.Object

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

Constructor Detail

ListView

@DataBoundConstructor
public ListView(String name)

ListView

public ListView(String name,
                ViewGroup owner)

Method Detail

initColumns

protected void initColumns()

initJobFilters

protected void initJobFilters()

hasJobFilterExtensions

public boolean hasJobFilterExtensions()

Used to determine if we want to display the Add button.

getJobFilters

public DescribableList<ViewJobFilter,Descriptor<ViewJobFilter>> getJobFilters()

getColumns

public DescribableList<ListViewColumn,Descriptor<ListViewColumn>> getColumns()

Description copied from class: View

If this view uses <t:projectView> for rendering, this method returns columns to be displayed.

Overrides:

getColumns in class View

getItems

public List<TopLevelItem> getItems()

Returns a read-only view of all Jobs in this view.

This method returns a separate copy each time to avoid concurrent modification issue.

Specified by:

getItems in class View

contains

public boolean contains(TopLevelItem item)

Description copied from class: View

Checks if the job is in this collection.

Specified by:

contains in class View

jobNamesContains

public boolean jobNamesContains(TopLevelItem item)

add

public void add(TopLevelItem item)
         throws IOException

Adds the given item to this view.

Specified by:

add in interface DirectlyModifiableView

Throws:

IOException - Adding failed.

Since:

1.389

remove

public boolean remove(TopLevelItem item)
               throws IOException

Removes given item from this view.

Specified by:

remove in interface DirectlyModifiableView

Returns:

false if item not present in view, true if removed.

Throws:

IOException - Removal failed.

Since:

1.566

getIncludeRegex

public String getIncludeRegex()

isRecurse

public boolean isRecurse()

setRecurse

public void setRecurse(boolean recurse)

Since:

1.568

getStatusFilter

public Boolean getStatusFilter()

Filter by enabled/disabled status of jobs. Null for no filter, true for enabled-only, false for disabled-only.

doCreateItem

public Item doCreateItem(org.kohsuke.stapler.StaplerRequest req,
                         org.kohsuke.stapler.StaplerResponse rsp)
                  throws IOException,
                         javax.servlet.ServletException

Description copied from class: View

Creates a new Item in this collection.

This method should call ModifiableItemGroup.doCreateItem(StaplerRequest, StaplerResponse) and then add the newly created item to this view.

Specified by:

doCreateItem in class View

Returns:

null if fails.

Throws:

IOException

javax.servlet.ServletException

doAddJobToView

public org.kohsuke.stapler.HttpResponse doAddJobToView(@QueryParameter
                                                       String name)
                                                throws IOException,
                                                       javax.servlet.ServletException

Description copied from interface: DirectlyModifiableView

Handle addJobToView web method. This method should RequirePOST.

Specified by:

doAddJobToView in interface DirectlyModifiableView

Parameters:

name - Item name. This can be either full name relative to owner item group or full item name prefixed with '/'.

Throws:

IOException

javax.servlet.ServletException

doRemoveJobFromView

public org.kohsuke.stapler.HttpResponse doRemoveJobFromView(@QueryParameter
                                                            String name)
                                                     throws IOException,
                                                            javax.servlet.ServletException

Description copied from interface: DirectlyModifiableView

Handle removeJobFromView web method. This method should RequirePOST.

Specified by:

doRemoveJobFromView in interface DirectlyModifiableView

Parameters:

name - Item name. This can be either full name relative to owner item group or full item name prefixed with '/'.

Throws:

IOException

javax.servlet.ServletException

submit

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

Handles the configuration submission. Load view-specific properties here.

Specified by:

submit in class View

Throws:

javax.servlet.ServletException

Descriptor.FormException

IOException

setIncludeRegex

public void setIncludeRegex(String includeRegex)

Since:

1.526

getDefaultColumns

@Deprecated
public static List<ListViewColumn> getDefaultColumns()

Deprecated. as of 1.391 Use ListViewColumn.createDefaultInitialColumnList()