jenkins.scm.api

Class SCMHeadObserver.AllFinished

java.lang.Object

jenkins.scm.api.SCMHeadObserver

jenkins.scm.api.SCMHeadObserver.AllFinished

Enclosing class:

SCMHeadObserver

public static class SCMHeadObserver.AllFinished
extends SCMHeadObserver

An observer that wraps multiple observers and keeps observing as long as one of the wrapped observers wants to.

Nested Class Summary

Nested classes/interfaces inherited from class jenkins.scm.api.SCMHeadObserver

SCMHeadObserver.AllFinished, SCMHeadObserver.Any, SCMHeadObserver.Collector, SCMHeadObserver.Filter<O extends SCMHeadObserver>, SCMHeadObserver.Named, SCMHeadObserver.None, SCMHeadObserver.OneFinished, SCMHeadObserver.Selector, SCMHeadObserver.Wrapped<O extends SCMHeadObserver>

Constructor Summary

Constructors

Constructor and Description
AllFinished(Iterable<SCMHeadObserver> observers) Constructor.
AllFinished(SCMHeadObserver... observers) Constructor.

Method Summary

Modifier and Type	Method and Description
Set<SCMHead>	getIncludes() Returns the subset of SCMHead instances that this observer is interested in or null if interested in all SCMHead instances.
boolean	isObserving() Returns information about whether the observer wants more results.
void	observe(SCMHead head, SCMRevision revision) Observes a head and current revision.

Methods inherited from class jenkins.scm.api.SCMHeadObserver

allOf, any, collect, filter, first, named, none, select

Methods inherited from class java.lang.Object

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

Constructor Detail

AllFinished

public AllFinished(SCMHeadObserver... observers)

Constructor.

Parameters:

observers - the observers to wrap.

AllFinished

public AllFinished(@NonNull
                   Iterable<SCMHeadObserver> observers)

Constructor.

Parameters:

observers - the observers to wrap.

Method Detail

observe

public void observe(@NonNull
                    SCMHead head,
                    @NonNull
                    SCMRevision revision)
             throws IOException,
                    InterruptedException

Observes a head and current revision.

Specified by:

observe in class SCMHeadObserver

Parameters:

head - the head.

revision - the revision.

Throws:

IOException - if processing of the observation could not be completed due to an IOException.

InterruptedException - if processing of the observation was interrupted

isObserving

public boolean isObserving()

Returns information about whether the observer wants more results.

Overrides:

isObserving in class SCMHeadObserver

Returns:

true if the observer is still observing or false to signal that it is ok to stop early.

getIncludes

public Set<SCMHead> getIncludes()

Returns the subset of SCMHead instances that this observer is interested in or null if interested in all SCMHead instances.

Implementations should not assume that the SCMHeadObserver.getIncludes() will be honoured. This method is designed to provide a hint to SCMSource implementations.

Overrides:

getIncludes in class SCMHeadObserver

Returns:

the subset of SCMHead instances that this observer is interested in or null.