org.apache.flink.runtime.jobgraph.tasks

Class AbstractInvokable

java.lang.Object

org.apache.flink.runtime.jobgraph.tasks.AbstractInvokable

Direct Known Subclasses:

BatchTask, DataSinkTask, DataSourceTask, IterationSynchronizationSinkTask

public abstract class AbstractInvokable
extends Object

This is the abstract base class for every task that can be executed by a TaskManager. Concrete tasks like the stream vertices of the batch tasks (see BatchTask) inherit from this class. The TaskManager invokes the methods registerInputOutput() and invoke() in this order when executing a task. The first method is responsible for setting up input and output stream readers and writers, the second method contains the task's core operation.

Constructor Summary

Constructors

Constructor and Description
AbstractInvokable()

Method Summary

Modifier and Type	Method and Description
void	cancel() This method is called when a task is canceled either as a result of a user abort or an execution failure.
int	getCurrentNumberOfSubtasks() Returns the current number of subtasks the respective task is split into.
Environment	getEnvironment() Returns the environment of this task.
org.apache.flink.api.common.ExecutionConfig	getExecutionConfig() Returns the global ExecutionConfig, obtained from the job configuration.
int	getIndexInSubtaskGroup() Returns the index of this subtask in the subtask group.
org.apache.flink.configuration.Configuration	getJobConfiguration() Returns the job configuration object which was attached to the original JobGraph.
org.apache.flink.configuration.Configuration	getTaskConfiguration() Returns the task configuration object which was attached to the original JobVertex.
ClassLoader	getUserCodeClassLoader() Returns the user code class loader of this invokable.
abstract void	invoke() Must be overwritten by the concrete task.
abstract void	registerInputOutput() Must be overwritten by the concrete task to instantiate the required record reader and record writer.
void	setEnvironment(Environment environment) Sets the environment of this task.

Methods inherited from class java.lang.Object

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

Constructor Detail

AbstractInvokable

public AbstractInvokable()

Method Detail

registerInputOutput

public abstract void registerInputOutput()
                                  throws Exception

Must be overwritten by the concrete task to instantiate the required record reader and record writer.

Throws:

Exception

invoke

public abstract void invoke()
                     throws Exception

Must be overwritten by the concrete task. This method is called by the task manager when the actual execution of the task starts.

Throws:

Exception - Tasks may forward their exceptions for the TaskManager to handle through failure/recovery.

setEnvironment

public final void setEnvironment(Environment environment)

Sets the environment of this task.

Parameters:

environment - the environment of this task

getEnvironment

public Environment getEnvironment()

Returns the environment of this task.

Returns:

The environment of this task.

getUserCodeClassLoader

public ClassLoader getUserCodeClassLoader()

Returns the user code class loader of this invokable.

Returns:

user code class loader of this invokable.

getCurrentNumberOfSubtasks

public int getCurrentNumberOfSubtasks()

Returns the current number of subtasks the respective task is split into.

Returns:

the current number of subtasks the respective task is split into

getIndexInSubtaskGroup

public int getIndexInSubtaskGroup()

Returns the index of this subtask in the subtask group.

Returns:

the index of this subtask in the subtask group

getTaskConfiguration

public org.apache.flink.configuration.Configuration getTaskConfiguration()

Returns the task configuration object which was attached to the original JobVertex.

Returns:

the task configuration object which was attached to the original JobVertex

getJobConfiguration

public org.apache.flink.configuration.Configuration getJobConfiguration()

Returns the job configuration object which was attached to the original JobGraph.

Returns:

the job configuration object which was attached to the original JobGraph

getExecutionConfig

public org.apache.flink.api.common.ExecutionConfig getExecutionConfig()

Returns the global ExecutionConfig, obtained from the job configuration.

cancel

public void cancel()
            throws Exception

This method is called when a task is canceled either as a result of a user abort or an execution failure. It can be overwritten to respond to shut down the user code properly.

Throws:

Exception - thrown if any exception occurs during the execution of the user code