Package jenkins.tools

Class GlobalToolConfiguration

java.lang.Object
hudson.model.ManagementLink
jenkins.tools.GlobalToolConfiguration
All Implemented Interfaces:
ExtensionPoint, Action, ModelObject
@Extension(ordinal=2.147483427E9) @Restricted(org.kohsuke.accmod.restrictions.NoExternalUse.class) public class GlobalToolConfiguration extends ManagementLink

  • Field Details

  • Constructor Details

    • GlobalToolConfiguration

      public GlobalToolConfiguration()

  • Method Details

    • getIconFileName

      public String getIconFileName()
      Description copied from class: ManagementLink
      Mostly works like Action.getIconFileName(), except that the expected icon format is SVG. So if you give just a file name, "/images/svgs" will be assumed.
      Specified by:
      getIconFileName in interface Action
      Specified by:
      getIconFileName in class ManagementLink
      Returns:
      As a special case, return null to exclude this object from the management link. This is useful for defining ManagementLink that only shows up under certain circumstances.
      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".
      Returns:
      Can be null in case the action is hidden.

    • getDescription

      public String getDescription()
      Description copied from class: ManagementLink
      Returns a short description of what this link does. This text is the one that's displayed in grey. This can include HTML, although the use of block tags is highly discouraged. Optional.
      Overrides:
      getDescription in class ManagementLink

    • getUrlName

      public String getUrlName()
      Description copied from class: ManagementLink
      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.

      In case of ManagementLink, this value is put straight into the href attribute, so relative paths are interpreted against the root Jenkins object.

      Specified by:
      getUrlName in interface Action
      Specified by:
      getUrlName in class ManagementLink
      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:

    • getRequiredPermission

      public Permission getRequiredPermission()
      Description copied from class: ManagementLink
      Returns the permission required for user to see this management link on the "Manage Jenkins" page (ManageJenkinsAction). Historically, this returned null, which amounted to the same behavior, as Jenkins.ADMINISTER was required to access the page.
      Overrides:
      getRequiredPermission in class ManagementLink
      Returns:
      the permission required for the link to be shown on "Manage Jenkins".

    • getCategory

      @NonNull public ManagementLink.Category getCategory()
      Description copied from class: ManagementLink
      Category for management link, uses String so it can be done with core dependency pre-dating the version this feature was added.
      Overrides:
      getCategory in class ManagementLink
      Returns:
      An enum value of ManagementLink.Category.

    • doConfigure

      @POST public void doConfigure(org.kohsuke.stapler.StaplerRequest2 req, org.kohsuke.stapler.StaplerResponse2 rsp) throws IOException, jakarta.servlet.ServletException, Descriptor.FormException
      Throws:
      IOException
      jakarta.servlet.ServletException
      Descriptor.FormException