hudson.widgets

Class HistoryWidget<O extends ModelObject,T>

java.lang.Object

hudson.widgets.Widget

hudson.widgets.HistoryWidget<O,T>

Type Parameters:

O - Owner of the widget.

T - Type individual record.

All Implemented Interfaces:

ExtensionPoint

Direct Known Subclasses:

BuildHistoryWidget

public class HistoryWidget<O extends ModelObject,T>
extends Widget

Displays the history of records (normally Runs) on the side panel.

Author:

Kohsuke Kawaguchi

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static interface	HistoryWidget.Adapter<T>

Nested classes/interfaces inherited from interface hudson.ExtensionPoint

ExtensionPoint.LegacyInstancesAreScopedToHudson

Field Summary

Fields

Modifier and Type	Field and Description
HistoryWidget.Adapter<? super T>	adapter
Iterable<T>	baseList The given data model of records.
String	baseUrl URL of the owner.
O	owner

Constructor Summary

Constructors

Constructor and Description
HistoryWidget(O owner, Iterable<T> baseList, HistoryWidget.Adapter<? super T> adapter)

Method Summary

Modifier and Type	Method and Description
void	doAjax(org.kohsuke.stapler.StaplerRequest req, org.kohsuke.stapler.StaplerResponse rsp, String n) Handles AJAX requests from browsers to update build history.
String	getDisplayName() Title of the widget.
String	getFirstTransientBuildKey()
HistoryPageFilter	getHistoryPageFilter() Get a HistoryPageFilter for rendering a page of queue items.
String	getNextBuildNumberToFetch()
Iterable<HistoryPageEntry<T>>	getRenderList() The records to be rendered this time.
String	getUrlName() Gets the URL path name.
boolean	isTrimmed()
protected HistoryPageFilter<T>	newPageFilter()
void	setNextBuildNumberToFetch(String nextBuildNumberToFetch)
void	setTrimmed(boolean trimmed)
protected HistoryPageFilter	updateFirstTransientBuildKey(HistoryPageFilter historyPageFilter) Calculates the first transient build record.

Methods inherited from class java.lang.Object

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

Field Detail

baseList

public Iterable<T> baseList

The given data model of records. Newer ones first.

baseUrl

public final String baseUrl

URL of the owner.

owner

public final O extends ModelObject owner

adapter

public final HistoryWidget.Adapter<? super T> adapter

Constructor Detail

HistoryWidget

public HistoryWidget(O owner,
                     Iterable<T> baseList,
                     HistoryWidget.Adapter<? super T> adapter)

Parameters:

owner - The parent model object that owns this widget.

Method Detail

getDisplayName

public String getDisplayName()

Title of the widget.

getUrlName

public String getUrlName()

Description copied from class: Widget

Gets the URL path name.

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

This method is useful when the widget needs to expose additional URLs, for example for serving AJAX requests.

This method should return a string that's unique among other Widgets. The default implementation returns the unqualified class name.

Overrides:

getUrlName in class Widget

getFirstTransientBuildKey

public String getFirstTransientBuildKey()

updateFirstTransientBuildKey

protected HistoryPageFilter updateFirstTransientBuildKey(HistoryPageFilter historyPageFilter)

Calculates the first transient build record. Everything ≥ this will be discarded when AJAX call is made.

Parameters:

historyPageFilter - The history page filter containing the list of builds.

Returns:

The history page filter that was passed in.

getRenderList

public Iterable<HistoryPageEntry<T>> getRenderList()

The records to be rendered this time.

getHistoryPageFilter

public HistoryPageFilter getHistoryPageFilter()

Get a HistoryPageFilter for rendering a page of queue items.

newPageFilter

protected HistoryPageFilter<T> newPageFilter()

isTrimmed

public boolean isTrimmed()

setTrimmed

public void setTrimmed(boolean trimmed)

doAjax

public void doAjax(org.kohsuke.stapler.StaplerRequest req,
                   org.kohsuke.stapler.StaplerResponse rsp,
                   @Header(value="n")
                   String n)
            throws IOException,
                   javax.servlet.ServletException

Handles AJAX requests from browsers to update build history.

Parameters:

n - The build 'number' to fetch. This is string because various variants uses non-numbers as the build key.

Throws:

IOException

javax.servlet.ServletException

getNextBuildNumberToFetch

public String getNextBuildNumberToFetch()

setNextBuildNumberToFetch

public void setNextBuildNumberToFetch(String nextBuildNumberToFetch)