com.cloudbees.hudson.plugins.folder.computed

Class ComputedFolder<I extends hudson.model.TopLevelItem>

java.lang.Object

hudson.model.AbstractModelObject

hudson.model.Actionable

hudson.model.AbstractItem

com.cloudbees.hudson.plugins.folder.AbstractFolder<I>

com.cloudbees.hudson.plugins.folder.computed.ComputedFolder<I>

Type Parameters:

I - the child item type

All Implemented Interfaces:

hudson.ExtensionPoint, hudson.model.BuildableItem, hudson.model.Describable<hudson.model.TopLevelItem>, hudson.model.DescriptorByNameOwner, hudson.model.Item, hudson.model.ItemGroup<I>, hudson.model.ModelObject, hudson.model.ModifiableViewGroup, hudson.model.PersistenceRoot, hudson.model.Queue.FlyweightTask, hudson.model.queue.SubTask, hudson.model.Queue.Task, hudson.model.ResourceActivity, hudson.model.Saveable, hudson.model.TopLevelItem, hudson.model.ViewGroup, hudson.search.SearchableModelObject, hudson.search.SearchItem, hudson.security.AccessControlled, jenkins.model.ModelObjectWithChildren, jenkins.model.ModelObjectWithContextMenu, org.kohsuke.stapler.HttpDeletable, org.kohsuke.stapler.StaplerFallback, org.kohsuke.stapler.StaplerOverridable

public abstract class ComputedFolder<I extends hudson.model.TopLevelItem>
extends AbstractFolder<I>
implements hudson.model.BuildableItem, hudson.model.Queue.FlyweightTask

A folder-like item whose children are computed. Users cannot directly add or remove (or rename) children. The children should also not offer Item.CONFIGURE to anyone.

Since:

4.11-beta-1

Nested Class Summary

Nested classes/interfaces inherited from class com.cloudbees.hudson.plugins.folder.AbstractFolder

AbstractFolder.ItemListenerImpl, AbstractFolder.RunListenerImpl

Nested classes/interfaces inherited from interface hudson.ExtensionPoint

hudson.ExtensionPoint.LegacyInstancesAreScopedToHudson

Nested classes/interfaces inherited from interface jenkins.model.ModelObjectWithContextMenu

jenkins.model.ModelObjectWithContextMenu.ContextMenu, jenkins.model.ModelObjectWithContextMenu.ContextMenuVisibility, jenkins.model.ModelObjectWithContextMenu.MenuItem

Field Summary

Fields inherited from class com.cloudbees.hudson.plugins.folder.AbstractFolder

items

Fields inherited from class hudson.model.AbstractItem

description, displayName, name, PRONOUN

Fields inherited from interface hudson.model.Item

BUILD, CANCEL, CONFIGURE, CREATE, DELETE, DISCOVER, EXTENDED_READ, PERMISSIONS, READ, WIPEOUT, WORKSPACE

Fields inherited from interface hudson.model.Saveable

NOOP

Constructor Summary

Constructors

Modifier	Constructor and Description
protected	ComputedFolder(hudson.model.ItemGroup parent, String name)

Method Summary

Modifier and Type	Method and Description
void	addTrigger(hudson.triggers.Trigger trigger)
void	checkAbortPermission()
protected abstract void	computeChildren(ChildObserver<I> observer, hudson.model.TaskListener listener) Called to (re-)compute the set of children of this folder.
protected FolderComputation<I>	createComputation(FolderComputation<I> previous)
protected ChildObserver<I>	createEventsChildObserver() Deprecated. use openEventsChildObserver()
FolderComputation<I>	createExecutable()
org.kohsuke.stapler.HttpResponse	doBuild(jenkins.util.TimeDuration delay)
void	doConfigSubmit(org.kohsuke.stapler.StaplerRequest req, org.kohsuke.stapler.StaplerResponse rsp)
List<hudson.model.Action>	getActions()
hudson.model.Label	getAssignedLabel()
hudson.model.queue.CauseOfBlockage	getCauseOfBlockage()
FolderComputation<I>	getComputation() URL binding and other purposes.
protected File	getComputationDir()
org.acegisecurity.Authentication	getDefaultAuthentication()
org.acegisecurity.Authentication	getDefaultAuthentication(hudson.model.Queue.Item item)
long	getEstimatedDuration()
hudson.model.Node	getLastBuiltOn()
PseudoRun<I>	getLastFailedBuild()
PseudoRun<I>	getLastStableBuild()
PseudoRun<I>	getLastSuccessfulBuild()
OrphanedItemStrategy	getOrphanedItemStrategy()
List<OrphanedItemStrategyDescriptor>	getOrphanedItemStrategyDescriptors() Gets the OrphanedItemStrategyDescriptors applicable to this folder.
hudson.model.Queue.Task	getOwnerTask()
hudson.model.ResourceList	getResourceList()
Object	getSameNodeConstraint()
Collection<? extends hudson.model.queue.SubTask>	getSubTasks()
protected String	getSuccessfulDestination() Where user will be redirected after creating or reconfiguring a AbstractFolder.
List<hudson.triggers.TriggerDescriptor>	getTriggerDescriptors()
Map<hudson.triggers.TriggerDescriptor,hudson.triggers.Trigger<?>>	getTriggers()
String	getWhyBlocked() Deprecated.
boolean	hasAbortPermission()
protected void	init()
boolean	isBuildable() Whether it is permissible to recompute this folder at this time.
boolean	isBuildBlocked()
boolean	isConcurrentBuild()
boolean	isDisabled() Is this folder disabled.
boolean	isHasEvents() Identifies if this ComputedFolder has a separate out of band events log.
void	onCreatedFromScratch()
void	onLoad(hudson.model.ItemGroup<? extends hudson.model.Item> parent, String name)
protected ChildObserver<I>	openEventsChildObserver() Opens a new ChildObserver that subclasses can use when handling events that might create new / update existing child items.
protected Collection<I>	orphanedItems(Collection<I> orphaned, hudson.model.TaskListener listener) Hook called when some items are no longer in the list.
protected void	recalculateAfterSubmitted(boolean recalculate) Method for child classes to use if they want to suppress/confirm the automatic recalculation provided in doConfigSubmit(StaplerRequest, StaplerResponse).
protected String	renameBlocker() Allows a subclass to block renames under dynamic conditions.
boolean	scheduleBuild()
boolean	scheduleBuild(hudson.model.Cause c)
boolean	scheduleBuild(int quietPeriod)
boolean	scheduleBuild(int quietPeriod, hudson.model.Cause c)
hudson.model.Queue.Item	scheduleBuild2(int quietPeriod, hudson.model.Action... actions) Duck-types ParameterizedJobMixIn.scheduleBuild2(int, Action...).
protected void	setDisabled(boolean disabled) Sets the folder as disabled.
void	setOrphanedItemStrategy(OrphanedItemStrategy strategy)
protected void	submit(org.kohsuke.stapler.StaplerRequest req, org.kohsuke.stapler.StaplerResponse rsp)
protected boolean	supportsMakeDisabled() Determines whether the folder supports being made disabled.

Methods inherited from class com.cloudbees.hudson.plugins.folder.AbstractFolder

addAction, addOrReplaceAction, addProperty, addView, canDelete, delete, deleteView, doChildrenContextMenu, doCreateView, doDisable, doDoRename, doEnable, doLastBuild, doSubmitDescription, doViewExistsCheck, getAllJobs, getBuildHealth, getBuildHealthReports, getDescriptor, getFolderViews, getHealthMetrics, getIcon, getIconColor, getItem, getItemGroup, getItems, getJob, getJobsDir, getOverrides, getPrimaryView, getPronoun, getProperties, getRootDirFor, getRootDirFor, getStaplerFallback, getUrlChildPrefix, getView, getViewActions, getViews, getViewsTabBar, initViews, invalidateBuildHealthReports, itemsPut, loadChildren, loadJobTotal, makeDisabled, makeSearchIndex, newDefaultFolderIcon, newDefaultViewsTabBar, newFolderViewHolder, onDeleted, onRenamed, onViewRenamed, removeAction, removeActions, renameTo, replaceAction, replaceActions, resetFolderViews, save, setIcon, setPrimaryView

Methods inherited from class hudson.model.AbstractItem

checkPermission, delete, doConfigDotXml, doDoDelete, doReload, doSetName, getAbsoluteUrl, getACL, getApi, getConfigFile, getDescription, getDescriptorByName, getDisplayName, getDisplayNameOrNull, getFullDisplayName, getFullName, getName, getParent, getRelativeDisplayNameFrom, getRelativeNameFrom, getRelativeNameFrom, getRelativeNameFromGroup, getRootDir, getSearchName, getSearchUrl, getShortUrl, getUrl, hasPermission, movedTo, onCopiedFrom, performDelete, resolveForCLI, setDescription, setDisplayName, setDisplayNameOrNull, toString, updateByXml, updateByXml

Methods inherited from class hudson.model.Actionable

doContextMenu, getAction, getAction, getActions, getAllActions, getDynamic

Methods inherited from class hudson.model.AbstractModelObject

getSearch, getSearchIndex, requirePOST, sendError, sendError, sendError, sendError, sendError

Methods inherited from class java.lang.Object

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

Methods inherited from interface hudson.model.Item

delete, getAbsoluteUrl, getAllJobs, getDisplayName, getFullDisplayName, getFullName, getName, getParent, getRelativeNameFrom, getRelativeNameFrom, getShortUrl, getUrl, onCopiedFrom, save

Methods inherited from interface hudson.model.PersistenceRoot

getRootDir

Methods inherited from interface hudson.search.SearchableModelObject

getSearch

Methods inherited from interface hudson.search.SearchItem

getSearchIndex, getSearchName, getSearchUrl

Methods inherited from interface hudson.security.AccessControlled

checkPermission, getACL, hasPermission

Methods inherited from interface hudson.model.Queue.Task

getFullDisplayName, getName, getUrl

Methods inherited from interface hudson.model.ResourceActivity

getDisplayName

Methods inherited from interface hudson.model.ItemGroup

getFullDisplayName, getFullName, getUrl

Methods inherited from interface hudson.model.ViewGroup

getUrl

Constructor Detail

ComputedFolder

protected ComputedFolder(hudson.model.ItemGroup parent,
                         String name)

Method Detail

init

protected final void init()

Overrides:

init in class AbstractFolder<I extends hudson.model.TopLevelItem>

onCreatedFromScratch

public void onCreatedFromScratch()

Specified by:

onCreatedFromScratch in interface hudson.model.Item

Overrides:

onCreatedFromScratch in class hudson.model.AbstractItem

onLoad

public void onLoad(hudson.model.ItemGroup<? extends hudson.model.Item> parent,
                   String name)
            throws IOException

Description copied from class: AbstractFolder

Specified by:

onLoad in interface hudson.model.Item

Overrides:

onLoad in class AbstractFolder<I extends hudson.model.TopLevelItem>

Throws:

IOException

computeChildren

protected abstract void computeChildren(ChildObserver<I> observer,
                                        hudson.model.TaskListener listener)
                                 throws IOException,
                                        InterruptedException

Called to (re-)compute the set of children of this folder. It is recommended that the computation checks the Thread.interrupted() status and throws a InterruptedException if set at least once every 5 seconds to allow the user to interrupt a computation..

Parameters:

observer - how to indicate which children should be seen

listener - a way to report progress

Throws:

IOException - if there was an IOException during the computation.

InterruptedException - if the computation was interrupted.

orphanedItems

protected Collection<I> orphanedItems(Collection<I> orphaned,
                                      hudson.model.TaskListener listener)
                               throws IOException,
                                      InterruptedException

Hook called when some items are no longer in the list. Do not call Item.delete() or ItemGroup.onDeleted(T) or ItemListener.fireOnDeleted(hudson.model.Item) yourself. By default, uses getOrphanedItemStrategy().

Parameters:

orphaned - a nonempty set of items which no longer are supposed to be here

listener - the listener to report decisions to.

Returns:

any subset of orphaned, representing those children which ought to be removed from the folder now; items not listed will be left alone for the time

Throws:

IOException - if there was an I/O issue processing the items.

InterruptedException - if interrupted while processing the items.

setOrphanedItemStrategy

public void setOrphanedItemStrategy(@Nonnull
                                    OrphanedItemStrategy strategy)

createEventsChildObserver

@Deprecated
 @Restricted(value=org.kohsuke.accmod.restrictions.NoExternalUse.class)
protected final ChildObserver<I> createEventsChildObserver()

Deprecated. use openEventsChildObserver()

Creates a ChildObserver that subclasses can use when handling events that might create new / update existing child items. The handling of orphaned items is a responsibility of the OrphanedItemStrategy which is only applied as part of a full computation.

Returns:

a ChildObserver for event handling.

openEventsChildObserver

protected final ChildObserver<I> openEventsChildObserver()

Opens a new ChildObserver that subclasses can use when handling events that might create new / update existing child items. The handling of orphaned items is a responsibility of the OrphanedItemStrategy which is only applied as part of a full computation.

Returns:

a ChildObserver for event handling. The caller must ChildObserver.close() when done.

Since:

6.0.0

isDisabled

public boolean isDisabled()

Is this folder disabled. A disabled folder should have all child items disabled.

Overrides:

isDisabled in class AbstractFolder<I extends hudson.model.TopLevelItem>

Returns:

true if and only if the folder is disabled.

See Also:

FolderJobQueueDecisionHandler

setDisabled

protected void setDisabled(boolean disabled)

Sets the folder as disabled.

Overrides:

setDisabled in class AbstractFolder<I extends hudson.model.TopLevelItem>

Parameters:

disabled - true if and only if the folder is to be disabled.

supportsMakeDisabled

protected boolean supportsMakeDisabled()

Determines whether the folder supports being made disabled.

Overrides:

supportsMakeDisabled in class AbstractFolder<I extends hudson.model.TopLevelItem>

Returns:

true if and only if AbstractFolder.setDisabled(boolean) is implemented

doConfigSubmit

public void doConfigSubmit(org.kohsuke.stapler.StaplerRequest req,
                           org.kohsuke.stapler.StaplerResponse rsp)
                    throws IOException,
                           javax.servlet.ServletException,
                           hudson.model.Descriptor.FormException

Overrides:

doConfigSubmit in class AbstractFolder<I extends hudson.model.TopLevelItem>

Throws:

IOException

javax.servlet.ServletException

hudson.model.Descriptor.FormException

recalculateAfterSubmitted

protected final void recalculateAfterSubmitted(boolean recalculate)

Method for child classes to use if they want to suppress/confirm the automatic recalculation provided in doConfigSubmit(StaplerRequest, StaplerResponse). This method should only be called from submit(StaplerRequest, StaplerResponse). If called multiple times from submit(StaplerRequest, StaplerResponse) then all calls must be with the false parameter to suppress recalculation.

Parameters:

recalculate - true to require recalculation, false to suppress recalculation.

Since:

FIXME

See Also:

submit(StaplerRequest, StaplerResponse)

submit

protected void submit(org.kohsuke.stapler.StaplerRequest req,
                      org.kohsuke.stapler.StaplerResponse rsp)
               throws IOException,
                      javax.servlet.ServletException,
                      hudson.model.Descriptor.FormException

Overrides:

submit in class AbstractFolder<I extends hudson.model.TopLevelItem>

Throws:

IOException

javax.servlet.ServletException

hudson.model.Descriptor.FormException

See Also:

recalculateAfterSubmitted(boolean)

getSuccessfulDestination

@Restricted(value=org.kohsuke.accmod.restrictions.NoExternalUse.class)
 @Nonnull
protected final String getSuccessfulDestination()

Where user will be redirected after creating or reconfiguring a AbstractFolder.

Overrides:

getSuccessfulDestination in class AbstractFolder<I extends hudson.model.TopLevelItem>

Returns:

A string that represents the redirect location URL.

See Also:

HttpServletResponse.sendRedirect(String)

getTriggers

public Map<hudson.triggers.TriggerDescriptor,hudson.triggers.Trigger<?>> getTriggers()

getTriggerDescriptors

@Restricted(value=org.kohsuke.accmod.restrictions.NoExternalUse.class)
public List<hudson.triggers.TriggerDescriptor> getTriggerDescriptors()

addTrigger

public void addTrigger(hudson.triggers.Trigger trigger)

getActions

public List<hudson.model.Action> getActions()

Overrides:

getActions in class hudson.model.Actionable

isBuildable

public boolean isBuildable()

Whether it is permissible to recompute this folder at this time.

Returns:

true if this folder can currenty be recomputed.

doBuild

public org.kohsuke.stapler.HttpResponse doBuild(@QueryParameter
                                                jenkins.util.TimeDuration delay)

scheduleBuild2

@CheckForNull
public hudson.model.Queue.Item scheduleBuild2(int quietPeriod,
                                                            hudson.model.Action... actions)

Duck-types ParameterizedJobMixIn.scheduleBuild2(int, Action...).

Parameters:

quietPeriod - seconds to wait before starting (normally 0)

actions - various actions to associate with the scheduling, such as ParametersAction or CauseAction

Returns:

a handle by which you may wait for the build to complete (or just start); or null if the build was not actually scheduled for some reason

scheduleBuild

public boolean scheduleBuild()

Specified by:

scheduleBuild in interface hudson.model.BuildableItem

scheduleBuild

public boolean scheduleBuild(hudson.model.Cause c)

Specified by:

scheduleBuild in interface hudson.model.BuildableItem

scheduleBuild

public boolean scheduleBuild(int quietPeriod)

Specified by:

scheduleBuild in interface hudson.model.BuildableItem

scheduleBuild

public boolean scheduleBuild(int quietPeriod,
                             hudson.model.Cause c)

Specified by:

scheduleBuild in interface hudson.model.BuildableItem

isBuildBlocked

public boolean isBuildBlocked()

Specified by:

isBuildBlocked in interface hudson.model.Queue.Task

getWhyBlocked

@Deprecated
public String getWhyBlocked()

Deprecated.

Specified by:

getWhyBlocked in interface hudson.model.Queue.Task

getCauseOfBlockage

public hudson.model.queue.CauseOfBlockage getCauseOfBlockage()

Specified by:

getCauseOfBlockage in interface hudson.model.Queue.Task

checkAbortPermission

public void checkAbortPermission()

Specified by:

checkAbortPermission in interface hudson.model.Queue.Task

hasAbortPermission

public boolean hasAbortPermission()

Specified by:

hasAbortPermission in interface hudson.model.Queue.Task

isConcurrentBuild

public boolean isConcurrentBuild()

Specified by:

isConcurrentBuild in interface hudson.model.Queue.Task

getSubTasks

public Collection<? extends hudson.model.queue.SubTask> getSubTasks()

Specified by:

getSubTasks in interface hudson.model.Queue.Task

getDefaultAuthentication

public org.acegisecurity.Authentication getDefaultAuthentication()

Specified by:

getDefaultAuthentication in interface hudson.model.Queue.Task

getDefaultAuthentication

public org.acegisecurity.Authentication getDefaultAuthentication(hudson.model.Queue.Item item)

Specified by:

getDefaultAuthentication in interface hudson.model.Queue.Task

getAssignedLabel

public hudson.model.Label getAssignedLabel()

Specified by:

getAssignedLabel in interface hudson.model.queue.SubTask

getLastBuiltOn

public hudson.model.Node getLastBuiltOn()

Specified by:

getLastBuiltOn in interface hudson.model.queue.SubTask

getEstimatedDuration

public long getEstimatedDuration()

Specified by:

getEstimatedDuration in interface hudson.model.queue.SubTask

createExecutable

public final FolderComputation<I> createExecutable()
                                            throws IOException

Specified by:

createExecutable in interface hudson.model.queue.SubTask

Throws:

IOException

createComputation

@Nonnull
protected FolderComputation<I> createComputation(@CheckForNull
                                                          FolderComputation<I> previous)

getOwnerTask

public hudson.model.Queue.Task getOwnerTask()

Specified by:

getOwnerTask in interface hudson.model.queue.SubTask

getSameNodeConstraint

public Object getSameNodeConstraint()

Specified by:

getSameNodeConstraint in interface hudson.model.queue.SubTask

getResourceList

public hudson.model.ResourceList getResourceList()

Specified by:

getResourceList in interface hudson.model.ResourceActivity

getComputationDir

protected File getComputationDir()

isHasEvents

public boolean isHasEvents()

Identifies if this ComputedFolder has a separate out of band events log. Default implementation just checks if the events log has content. Subclasses can override this method to force the events log always present in the UI.

Returns:

true if this ComputedFolder has a separate out of band events log.

Since:

FIXME

getComputation

@Nonnull
public FolderComputation<I> getComputation()

URL binding and other purposes. It may be null temporarily inside the constructor, so beware if you extend this class.

Returns:

the computation.

getLastSuccessfulBuild

@Restricted(value=org.kohsuke.accmod.restrictions.NoExternalUse.class)
public PseudoRun<I> getLastSuccessfulBuild()

getLastStableBuild

@Restricted(value=org.kohsuke.accmod.restrictions.NoExternalUse.class)
public PseudoRun<I> getLastStableBuild()

getLastFailedBuild

@Restricted(value=org.kohsuke.accmod.restrictions.NoExternalUse.class)
public PseudoRun<I> getLastFailedBuild()

renameBlocker

protected String renameBlocker()

Allows a subclass to block renames under dynamic conditions.

Overrides:

renameBlocker in class AbstractFolder<I extends hudson.model.TopLevelItem>

Returns:

a message if rename should currently be prohibited, or null to allow

getOrphanedItemStrategy

@NonNull
public OrphanedItemStrategy getOrphanedItemStrategy()

getOrphanedItemStrategyDescriptors

@Restricted(value=org.kohsuke.accmod.restrictions.DoNotUse.class)
 @NonNull
public List<OrphanedItemStrategyDescriptor> getOrphanedItemStrategyDescriptors()

Gets the OrphanedItemStrategyDescriptors applicable to this folder.

Returns:

the OrphanedItemStrategyDescriptors applicable to this folder.