Package hudson.diagnosis

Class TooManyJobsButNoView

java.lang.Object

hudson.model.AbstractModelObject

hudson.model.AdministrativeMonitor

hudson.diagnosis.TooManyJobsButNoView

All Implemented Interfaces:

ExtensionPoint, ModelObject, SearchableModelObject, SearchItem, org.kohsuke.stapler.StaplerProxy

@Extension
@Symbol("tooManyJobsButNoView")
public class TooManyJobsButNoView
extends AdministrativeMonitor

If Hudson is run with a lot of jobs but no views, suggest the user that they can create views.

I noticed at an user visit that some users didn't notice the '+' icon in the tab bar.

Author:

Kohsuke Kawaguchi

Nested Class Summary

Nested classes/interfaces inherited from interface hudson.ExtensionPoint

ExtensionPoint.LegacyInstancesAreScopedToHudson

Field Summary

Fields

Modifier and Type	Field	Description
static final int	THRESHOLD

Fields inherited from class hudson.model.AdministrativeMonitor

id

Constructor Summary

Constructors

Constructor	Description
TooManyJobsButNoView()

Method Summary

Modifier and Type	Method	Description
void	doAct(org.kohsuke.stapler.StaplerRequest2 req, org.kohsuke.stapler.StaplerResponse2 rsp)	Depending on whether the user said "yes" or "no", send him to the right place.
String	getDisplayName()
Permission	getRequiredPermission()	Required permission to view this admin monitor.
boolean	isActivated()	Returns true if this monitor is activated and wants to produce a warning message.

Methods inherited from class hudson.model.AdministrativeMonitor

all, checkRequiredPermission, disable, doDisable, getSearchUrl, getTarget, getUrl, hasPermissionToDisplay, hasRequiredPermission, isEnabled, isSecurity

Methods inherited from class hudson.model.AbstractModelObject

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

Methods inherited from class java.lang.Object

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

Methods inherited from interface hudson.search.SearchItem

getSearchGroup, getSearchIcon

Field Details

THRESHOLD

public static final int THRESHOLD

See Also:

• Constant Field Values

Constructor Details

TooManyJobsButNoView

public TooManyJobsButNoView()

Method Details

getDisplayName

public String getDisplayName()

Specified by:

getDisplayName in interface ModelObject

Overrides:

getDisplayName in class AdministrativeMonitor

isActivated

public boolean isActivated()

Description copied from class: AdministrativeMonitor

Returns true if this monitor is activated and wants to produce a warning message.

This method is called from the HTML rendering thread, so it should run efficiently.

Specified by:

isActivated in class AdministrativeMonitor

doAct

public void doAct(org.kohsuke.stapler.StaplerRequest2 req,
 org.kohsuke.stapler.StaplerResponse2 rsp)
           throws IOException

Depending on whether the user said "yes" or "no", send him to the right place.

Throws:

IOException

getRequiredPermission

public Permission getRequiredPermission()

Description copied from class: AdministrativeMonitor

Required permission to view this admin monitor. By default Jenkins.ADMINISTER, but Jenkins.SYSTEM_READ or Jenkins.MANAGE are also supported.

Changing this permission check to return Jenkins.SYSTEM_READ will make the active administrative monitor appear on manage.jelly and on the globally visible AdministrativeMonitorsDecorator to users without Administer permission. AdministrativeMonitor.doDisable(StaplerRequest2, StaplerResponse2) will still always require Administer permission.

This method only allows for a single permission to be returned. If more complex permission checks are required, override AdministrativeMonitor.checkRequiredPermission() and AdministrativeMonitor.hasRequiredPermission() instead.

Implementers need to ensure that doAct and other web methods perform necessary permission checks: Users with System Read permissions are expected to be limited to read-only access. Form UI elements that change system state, e.g. toggling a feature on or off, need to be hidden from users lacking Administer permission.

Overrides:

getRequiredPermission in class AdministrativeMonitor