Package jenkins.model.job

Class PermalinksAction

java.lang.Object
jenkins.model.job.PermalinksAction
All Implemented Interfaces:
Action, ModelObject
@Restricted(org.kohsuke.accmod.restrictions.Beta.class) public final class PermalinksAction extends Object implements Action
App bar action that exposes the available job permalinks in a dropdown.

Only permalinks that currently resolve to a build are shown in the menu.

Since:
TODO

  • Method Details

    • 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:

    • 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:

    • getGroup

      public Group getGroup()
      Description copied from interface: Action
      Returns the group that this item belongs to. The default implementation places the item in the menu group.
      Specified by:
      getGroup in interface Action
      Returns:
      the group of this item

    • getEvent

      public Event getEvent()
      Description copied from interface: Action
      Returns the event associated with this item. By default, this creates a link event pointing to the item's URL name.
      Specified by:
      getEvent in interface Action
      Returns:
      the event representing this item

    • isVisibleInContextMenu

      public boolean isVisibleInContextMenu()
      Description copied from interface: Action
      Indicates whether this item should be visible in a context menu for an Actionable.
      Specified by:
      isVisibleInContextMenu in interface Action
      Returns:
      true if the item is shown in the context menu, false otherwise