org.apache.flink.runtime.operators

Interface PactDriver<S extends Function,OT>

Type Parameters:

S - The type of stub driven by this driver.

OT - The data type of the records produced by this driver.

All Known Subinterfaces:

ResettablePactDriver<S,OT>

All Known Implementing Classes:

AbstractCachedBuildSideMatchDriver, AllGroupReduceDriver, AllReduceDriver, BuildFirstCachedMatchDriver, BuildSecondCachedMatchDriver, CoGroupDriver, CoGroupWithSolutionSetFirstDriver, CoGroupWithSolutionSetSecondDriver, CollectorMapDriver, CrossDriver, FlatMapDriver, GroupReduceCombineDriver, GroupReduceDriver, JoinWithSolutionSetFirstDriver, JoinWithSolutionSetSecondDriver, MapDriver, MatchDriver, NoOpDriver, ReduceCombineDriver, ReduceDriver

public interface PactDriver<S extends Function,OT>

The interface to be implemented by all pact drivers that run alone (or as the primary driver) in a nephele task. The driver is the code that deals with everything that specific to a certain PACT. It implements the actual map or reduce specific code.

See Also:

PactTaskContext

Method Summary

Methods

Modifier and Type	Method and Description
void	cancel() This method is invoked when the driver must aborted in mid processing.
void	cleanup() This method is invoked in any case (clean termination and exception) at the end of the tasks operation.
int	getNumberOfInputs() Gets the number of inputs (= Nephele Gates and Readers) that the task has.
Class<S>	getStubType() Gets the class of the stub type that is run by this task.
void	prepare() This method is called before the user code is opened.
boolean	requiresComparatorOnInput() Flag indicating whether the inputs require always comparators or not.
void	run() The main operation method of the task.
void	setup(PactTaskContext<S,OT> context)

Method Detail

setup

void setup(PactTaskContext<S,OT> context)

getNumberOfInputs

int getNumberOfInputs()

Gets the number of inputs (= Nephele Gates and Readers) that the task has.

Returns:

The number of inputs.

getStubType

Class<S> getStubType()

Gets the class of the stub type that is run by this task. For example, a MapTask should return MapFunction.class.

Returns:

The class of the stub type run by the task.

requiresComparatorOnInput

boolean requiresComparatorOnInput()

Flag indicating whether the inputs require always comparators or not.

Returns:

True, if the initialization should look for and create comparators, false otherwise.

prepare

void prepare()
             throws Exception

This method is called before the user code is opened. An exception thrown by this method signals failure of the task.

Throws:

Exception - Exceptions may be forwarded and signal task failure.

run

void run()
         throws Exception

The main operation method of the task. It should call the user code with the data subsets until the input is depleted.

Throws:

Exception - Any exception thrown by this method signals task failure. Because exceptions in the user code typically signal situations where this instance in unable to proceed, exceptions from the user code should be forwarded.

cleanup

void cleanup()
             throws Exception

This method is invoked in any case (clean termination and exception) at the end of the tasks operation.

Throws:

Exception - Exceptions may be forwarded.

cancel

void cancel()
            throws Exception

This method is invoked when the driver must aborted in mid processing. It is invoked asynchronously by a different thread.

Throws:

Exception - Exceptions may be forwarded.