Package hudson.model

Class PageDecorator

java.lang.Object

hudson.model.Descriptor<PageDecorator>

hudson.model.PageDecorator

All Implemented Interfaces:

ExtensionPoint, Describable<PageDecorator>, Saveable, Loadable, OnMaster

Direct Known Subclasses:

FormElementPathPageDecorator, FrameOptionsPageDecorator, SetupWizard, UsageStatistics

public abstract class PageDecorator
extends Descriptor<PageDecorator>
implements ExtensionPoint, Describable<PageDecorator>

Participates in the rendering of HTML pages for all pages of Hudson.

This class provides a few hooks to augment the HTML generation process of Hudson, across all the HTML pages that Hudson delivers.

For example, if you'd like to add a Google Analytics stat to Hudson, then you need to inject a small script fragment to all Hudson pages. This extension point provides a means to do that.

Life-cycle

Plugins that contribute this extension point should implement a new decorator and put Extension on the class.

Associated Views

global.jelly

If this extension point needs to expose a global configuration, write this jelly page. See Descriptor for more about this. Optional.

footer.jelly

This page is added right before the </body> tag. Convenient place for adding tracking beacons, etc.

header.jelly

This page is added right before the </head> tag. Convenient place for additional stylesheet, <meta> tags, etc.

httpHeaders.jelly

This is a generalization of the X-Jenkins header that aids auto-discovery. This fragment can write additional <st:header name="…" value="…"/> tags that go along with it.

Since:

1.235

Author:

Kohsuke Kawaguchi

Nested Class Summary

Nested classes/interfaces inherited from class hudson.model.Descriptor

Descriptor.FormException, Descriptor.PropertyType, Descriptor.Self

Nested classes/interfaces inherited from interface hudson.ExtensionPoint

ExtensionPoint.LegacyInstancesAreScopedToHudson

Field Summary

Fields

Modifier and Type	Field	Description
static final List<PageDecorator>	ALL	Deprecated. as of 1.286 Use all() for read access, and use Extension for registration.

Fields inherited from class hudson.model.Descriptor

clazz

Fields inherited from interface hudson.model.Saveable

NOOP

Constructor Summary

Constructors

Modifier	Constructor	Description
protected	PageDecorator()
protected	PageDecorator(Class<? extends PageDecorator> yourClass)	Deprecated. as of 1.425 Use the default constructor that's less error prone

Method Summary

Modifier and Type	Method	Description
static ExtensionList<PageDecorator>	all()	Returns all the registered PageDecorator descriptors.
final Descriptor<PageDecorator>	getDescriptor()	Gets the descriptor for this instance.
final String	getUrl()	Obtains the URL of this object, excluding the context path.

Methods inherited from class hudson.model.Descriptor

addHelpFileRedirect, bindJSON, bindJSON, calcAutoCompleteSettings, calcFillSettings, configure, configure, configure, doHelp, doHelp, find, find, findByDescribableClassName, findById, getCategory, getCheckMethod, getCheckUrl, getConfigFile, getConfigPage, getCurrentDescriptorByNameUrl, getDescriptorFullUrl, getDescriptorUrl, getDisplayName, getGlobalConfigPage, getGlobalPropertyType, getHelpFile, getHelpFile, getHelpFile, getId, getJsonSafeClassName, getKlass, getPlugin, getPossibleViewNames, getPropertyType, getPropertyType, getPropertyTypeOrDie, getRequiredGlobalConfigPagePermission, getStaticHelpUrl, getStaticHelpUrl, getT, getViewPage, isInstance, isSubTypeOf, load, newInstance, newInstance, newInstance, newInstancesFromHeteroList, newInstancesFromHeteroList, newInstancesFromHeteroList, newInstancesFromHeteroList, save, self, toArray, toList, toMap

Methods inherited from class java.lang.Object

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

Field Details

ALL

@Deprecated
public static final List<PageDecorator> ALL

Deprecated.

as of 1.286 Use all() for read access, and use Extension for registration.

All the registered instances.

Constructor Details

PageDecorator

@Deprecated
protected PageDecorator(Class<? extends PageDecorator> yourClass)

Deprecated.

as of 1.425 Use the default constructor that's less error prone

Parameters:

yourClass - pass-in "this.getClass()" (except that the constructor parameters cannot use 'this', so you'd have to hard-code the class name.

PageDecorator

protected PageDecorator()

Method Details

getDescriptor

public final Descriptor<PageDecorator> getDescriptor()

Description copied from interface: Describable

Gets the descriptor for this instance.

Descriptor is a singleton for every concrete Describable implementation, so if a.getClass() == b.getClass() then by default a.getDescriptor() == b.getDescriptor() as well. (In rare cases a single implementation class may be used for instances with distinct descriptors.)

By default looks for a nested class (conventionally named DescriptorImpl) implementing Descriptor and marked with Extension.

Specified by:

getDescriptor in interface Describable<PageDecorator>

getUrl

public final String getUrl()

Obtains the URL of this object, excluding the context path.

Every PageDecorator is bound to URL via Jenkins.getDescriptor(). This method returns such an URL.

all

public static ExtensionList<PageDecorator> all()

Returns all the registered PageDecorator descriptors.