Package com.oracle.coherence.concurrent.executor

Class AbstractCollectable<T,R,O extends AbstractOrchestration<T,?>>

java.lang.Object

com.oracle.coherence.concurrent.executor.AbstractCollectable<T,R,O>

Type Parameters:

T - the type of the Task

R - the type of the collected result

O - the type of Task.Orchestration on which the Task.Collectable is based

All Implemented Interfaces:

Task.Collectable<T,R>, Task.Completable<T,R>

public abstract class AbstractCollectable<T,R,O extends AbstractOrchestration<T,?>>
extends Object
implements Task.Collectable<T,R>, Task.Completable<T,R>

A base implementation of a Task.Collectable and Task.Completable.

Since:

21.12

Author:

bo

Field Summary

Fields

Modifier and Type	Field	Description
protected Task.Collector<? super T,?,R>	m_collector	The Task.Collector for the Task.
protected com.tangosol.util.function.Remote.Predicate<? super R>	m_completionPredicate	The optional Remote.Predicate to indicate if collection is completed.
protected Task.CompletionRunnable<? super R>	m_completionRunnable	The optional Task.CompletionRunnable to call after the task is completed.
protected O	m_orchestration	The Task.Orchestration on which the Task.Collectable is based.
protected LinkedHashSet<Task.Subscriber<? super R>>	m_setSubscribers	The Task.Subscribers to register when creating the Task orchestration with the TaskExecutorService.

Constructor Summary

Constructors

Constructor	Description
AbstractCollectable(O orchestration, Task.Collector<? super T,?,R> collector)	Constructs a Task.Collectable based on an Task.Orchestration.

Method Summary

Modifier and Type	Method	Description
Task.Completable<T,R>	andThen(Task.CompletionRunnable<? super R> runnable)	Provide a runnable to call when the task has completed.
Task.Collectable<T,R>	subscribe(Task.Subscriber<? super R> subscriber)	Registers the specified Task.Subscriber as part of the orchestration of the Task.
Task.Completable<T,R>	until(com.tangosol.util.function.Remote.Predicate<? super R> predicate)	Sets the Remote.Predicate to determine when the collection of results will be considered completed, based on the collected result, after which no further results will be published to Task.Subscribers.

Methods inherited from class java.lang.Object

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

Methods inherited from interface com.oracle.coherence.concurrent.executor.Task.Collectable

submit

Field Detail

m_orchestration

protected O extends AbstractOrchestration<T,?> m_orchestration

The Task.Orchestration on which the Task.Collectable is based.

m_collector

protected Task.Collector<? super T,?,R> m_collector

The Task.Collector for the Task.

m_completionPredicate

protected com.tangosol.util.function.Remote.Predicate<? super R> m_completionPredicate

The optional Remote.Predicate to indicate if collection is completed. null when not required (for continuous collection)

m_setSubscribers

protected LinkedHashSet<Task.Subscriber<? super R>> m_setSubscribers

The Task.Subscribers to register when creating the Task orchestration with the TaskExecutorService.

m_completionRunnable

protected Task.CompletionRunnable<? super R> m_completionRunnable

The optional Task.CompletionRunnable to call after the task is completed. null when not required (to call a Runnable)

Constructor Detail

AbstractCollectable

public AbstractCollectable(O orchestration,
                           Task.Collector<? super T,?,R> collector)

Constructs a Task.Collectable based on an Task.Orchestration.

Parameters:

orchestration - the Task.Orchestration

collector - the Task.Collector of results

Method Detail

until

public Task.Completable<T,R> until(com.tangosol.util.function.Remote.Predicate<? super R> predicate)

Description copied from interface: Task.Collectable

Sets the Remote.Predicate to determine when the collection of results will be considered completed, based on the collected result, after which no further results will be published to Task.Subscribers.

When collection activity is completed, Task.Subscribers will then be notified by calling Task.Subscriber.onComplete().

Specified by:

until in interface Task.Collectable<T,R>

Parameters:

predicate - the Remote.Predicate to determine when the Task has completed (based on the collected results) or null to indicate continuous collection and publishing of results

Returns:

a Task.Collectable to permit fluent-style method chaining

andThen

public Task.Completable<T,R> andThen(Task.CompletionRunnable<? super R> runnable)

Description copied from interface: Task.Collectable

Provide a runnable to call when the task has completed.

Specified by:

andThen in interface Task.Collectable<T,R>

Parameters:

runnable - the Task.CompletionRunnable to call when the Task has completed

Returns:

a Task.Collectable to permit fluent-style method chaining

subscribe

public Task.Collectable<T,R> subscribe(Task.Subscriber<? super R> subscriber)

Description copied from interface: Task.Collectable

Registers the specified Task.Subscriber as part of the orchestration of the Task.

This method may be used multiple times to register multiple Task.Subscribers.

Specified by:

subscribe in interface Task.Collectable<T,R>

Parameters:

subscriber - the Task.Subscriber

Returns:

the Task.Collectable to permit fluent-style method chaining