Package hudson.model

Class ListView.Listener

java.lang.Object

hudson.model.listeners.ItemListener

hudson.model.ListView.Listener

All Implemented Interfaces:

ExtensionPoint

Enclosing class:

ListView

@Restricted(org.kohsuke.accmod.restrictions.NoExternalUse.class)
@Extension
public static final class ListView.Listener
extends ItemListener

Nested Class Summary

Nested classes/interfaces inherited from interface hudson.ExtensionPoint

ExtensionPoint.LegacyInstancesAreScopedToHudson

Constructor Summary

Constructors

Constructor	Description
Listener()

Method Summary

Modifier and Type	Method	Description
void	onDeleted(Item item)	Called right before a job is going to be deleted.
void	onLocationChanged(Item item, String oldFullName, String newFullName)	Called after an item’s fully-qualified location has changed.

Methods inherited from class hudson.model.listeners.ItemListener

all, checkBeforeCopy, checkBeforeDelete, fireLocationChange, fireOnCopied, fireOnCreated, fireOnDeleted, fireOnUpdated, onBeforeShutdown, onCheckCopy, onCheckDelete, onCopied, onCreated, onLoaded, onRenamed, onUpdated, register

Methods inherited from class java.lang.Object

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

Constructor Details

Listener

public Listener()

Method Details

onLocationChanged

public void onLocationChanged(Item item,
 String oldFullName,
 String newFullName)

Description copied from class: ItemListener

Called after an item’s fully-qualified location has changed. This might be because:

• This item was renamed.
• Some ancestor folder was renamed.
• This item was moved between folders (or from a folder to Jenkins root or vice-versa).
• Some ancestor folder was moved.

Where applicable, ItemListener.onRenamed(hudson.model.Item, java.lang.String, java.lang.String) will already have been called on this item or an ancestor. And where applicable, ItemListener.onLocationChanged(hudson.model.Item, java.lang.String, java.lang.String) will already have been called on its ancestors.

This method should be used (instead of ItemListener.onRenamed(hudson.model.Item, java.lang.String, java.lang.String)) by any code which seeks to keep (absolute) references to items up to date: if a persisted reference matches oldFullName, replace it with newFullName.

Overrides:

onLocationChanged in class ItemListener

Parameters:

item - an item whose absolute position is now different

oldFullName - the former Item.getFullName()

newFullName - the current Item.getFullName()

See Also:

• Items.computeRelativeNamesAfterRenaming(java.lang.String, java.lang.String, java.lang.String, hudson.model.ItemGroup)

onDeleted

public void onDeleted(Item item)

Description copied from class: ItemListener

Called right before a job is going to be deleted. At this point the data files of the job is already gone.

Overrides:

onDeleted in class ItemListener