public interface Action extends ModelObject
Actionableobjects, which most interesting
Actions added to a model object creates additional URL subspace
under the parent model object, through which it can interact with users.
Actions are also capable of exposing themselves to the left hand side
menu of a
ModelObject (for example to
Some actions use the latter without the former (for example, to add a link to an external website), while others do the former without the latter (for example, to just draw some graphs in floatingBox.jelly), and still some others do both.
If an action has a view named floatingBox.jelly, it will be
displayed as a floating box on the top page of the target
ModelObject. (For example, this is how the JUnit test result trend
shows up in the project top page. See
If an absolute file name that starts from '/' is returned (like "/plugin/foo/abc.png'), then it will be interpreted as a path from the context root of Hudson. 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.
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
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 Hudson webapp.
Copyright © 2004-2015 Hudson. All Rights Reserved.