Package hudson.model

Class ManageJenkinsAction

java.lang.Object

hudson.model.ManageJenkinsAction

All Implemented Interfaces:

ExtensionPoint, Action, ModelObject, RootAction, ModelObjectWithContextMenu, org.kohsuke.stapler.StaplerFallback

@Extension(ordinal=100.0)
@Symbol("manageJenkins")
public class ManageJenkinsAction
extends Object
implements RootAction, org.kohsuke.stapler.StaplerFallback, ModelObjectWithContextMenu

Adds the "Manage Jenkins" link to the top page.

Author:

Kohsuke Kawaguchi

Nested Class Summary

Nested classes/interfaces inherited from interface hudson.ExtensionPoint

ExtensionPoint.LegacyInstancesAreScopedToHudson

Nested classes/interfaces inherited from interface jenkins.model.ModelObjectWithContextMenu

ModelObjectWithContextMenu.ContextMenu, ModelObjectWithContextMenu.ContextMenuVisibility, ModelObjectWithContextMenu.MenuItem, ModelObjectWithContextMenu.MenuItemType

Constructor Summary

Constructors

Constructor	Description
ManageJenkinsAction()

Method Summary

Modifier and Type	Method	Description
void	addContextMenuItem(ModelObjectWithContextMenu.ContextMenu menu, String url, String icon, String iconXml, String text, boolean post, boolean requiresConfirmation, Badge badge, String message)	Workaround to ensuring that links in context menus resolve correctly in the submenu of the top-level 'Dashboard' menu.
ModelObjectWithContextMenu.ContextMenu	doContextMenu(org.kohsuke.stapler.StaplerRequest request, org.kohsuke.stapler.StaplerResponse response)	Generates the context menu.
String	getDisplayName()	Gets the string to be displayed.
String	getIconFileName()	Gets the name of the icon.
Object	getStaplerFallback()
String	getUrlName()	Gets the URL path name.

Methods inherited from class java.lang.Object

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

Constructor Detail

ManageJenkinsAction

public ManageJenkinsAction()

Method Detail

getIconFileName

public String getIconFileName()

Description copied from interface: Action

Gets the name of the icon.

Specified by:

getIconFileName in interface Action

Returns:

If the icon name is prefixed with "symbol-", a Jenkins Symbol will be used.

If just a file name (like "abc.gif") is returned, it will be interpreted as a file name inside /images/24x24. This is useful for using one of the stock images.

If an absolute file name that starts from '/' is returned (like "/plugin/foo/abc.gif"), then it will be interpreted as a path from the context root of Jenkins. This is useful to pick up image files from a plugin.

Finally, return null to hide it from the task list. This is normally not very useful, but this can be used for actions that only contribute floatBox.jelly and no task list item. The other case where this is useful is to avoid showing links that require a privilege when the user is anonymous.

See Also:

Jenkins Symbols, Functions.isAnonymous(), Functions.getIconFilePath(Action)

getDisplayName

public String getDisplayName()

Description copied from interface: Action

Gets the string to be displayed. The convention is to capitalize the first letter of each word, such as "Test Result".

Specified by:

getDisplayName in interface Action

Specified by:

getDisplayName in interface ModelObject

Returns:

Can be null in case the action is hidden.

getUrlName

public String getUrlName()

Description copied from interface: Action

Gets the URL path name.

For example, if this method returns "xyz", and if the parent object (that this action is associated with) is bound to /foo/bar/zot, then this action object will be exposed to /foo/bar/zot/xyz.

This method should return a string that's unique among other Actions.

The returned string can be an absolute URL, like "http://www.sun.com/", which is useful for directly connecting to external systems.

If the returned string starts with '/', like '/foo', then it's assumed to be relative to the context path of the Jenkins webapp.

Specified by:

getUrlName in interface Action

Returns:

null if this action object doesn't need to be bound to web (when you do that, be sure to also return null from Action.getIconFileName().

See Also:

Functions.getActionUrl(String, Action)

getStaplerFallback

public Object getStaplerFallback()

Specified by:

getStaplerFallback in interface org.kohsuke.stapler.StaplerFallback

doContextMenu

public ModelObjectWithContextMenu.ContextMenu doContextMenu(org.kohsuke.stapler.StaplerRequest request,
                                                            org.kohsuke.stapler.StaplerResponse response)
                                                     throws org.apache.commons.jelly.JellyException,
                                                            IOException

Description copied from interface: ModelObjectWithContextMenu

Generates the context menu. The typical implementation is return new ContextMenu().from(this,request,response);, which implements the default behaviour. See ModelObjectWithContextMenu.ContextMenu.from(ModelObjectWithContextMenu, StaplerRequest, StaplerResponse) for more details of what it does. This should suit most implementations.

Specified by:

doContextMenu in interface ModelObjectWithContextMenu

Throws:

org.apache.commons.jelly.JellyException

IOException

addContextMenuItem

@Restricted(org.kohsuke.accmod.restrictions.NoExternalUse.class)
public void addContextMenuItem(ModelObjectWithContextMenu.ContextMenu menu,
                               String url,
                               String icon,
                               String iconXml,
                               String text,
                               boolean post,
                               boolean requiresConfirmation,
                               Badge badge,
                               String message)

Workaround to ensuring that links in context menus resolve correctly in the submenu of the top-level 'Dashboard' menu.