org.apache.flink.runtime.taskmanager

Class RuntimeEnvironment

java.lang.Object

org.apache.flink.runtime.taskmanager.RuntimeEnvironment

All Implemented Interfaces:

Environment

public class RuntimeEnvironment
extends Object
implements Environment

In implementation of the Environment.

Constructor Summary

Constructors

Constructor and Description

RuntimeEnvironment(JobID jobId, JobVertexID jobVertexId, ExecutionAttemptID executionId, ExecutionConfig executionConfig, TaskInfo taskInfo, Configuration jobConfiguration, Configuration taskConfiguration, ClassLoader userCodeClassLoader, MemoryManager memManager, IOManager ioManager, BroadcastVariableManager bcVarManager, AccumulatorRegistry accumulatorRegistry, TaskKvStateRegistry kvStateRegistry, InputSplitProvider splitProvider, Map<String,Future<Path>> distCacheEntries, ResultPartitionWriter[] writers, InputGate[] inputGates, CheckpointResponder checkpointResponder, TaskManagerRuntimeInfo taskManagerInfo, TaskMetricGroup metrics, Task containingTask)

Method Summary

Methods

Modifier and Type	Method and Description
void	acknowledgeCheckpoint(long checkpointId, CheckpointMetrics checkpointMetrics) Confirms that the invokable has successfully completed all steps it needed to to for the checkpoint with the give checkpoint-ID.
void	acknowledgeCheckpoint(long checkpointId, CheckpointMetrics checkpointMetrics, SubtaskState checkpointStateHandles) Confirms that the invokable has successfully completed all required steps for the checkpoint with the give checkpoint-ID.
void	declineCheckpoint(long checkpointId, Throwable cause) Declines a checkpoint.
void	failExternally(Throwable cause) Marks task execution failed for an external reason (a reason other than the task code itself throwing an exception).
AccumulatorRegistry	getAccumulatorRegistry() Return the registry for accumulators which are periodically sent to the job manager.
InputGate[]	getAllInputGates()
ResultPartitionWriter[]	getAllWriters()
BroadcastVariableManager	getBroadcastVariableManager()
Map<String,Future<Path>>	getDistributedCacheEntries()
ExecutionConfig	getExecutionConfig() Returns the job specific ExecutionConfig.
ExecutionAttemptID	getExecutionId() Gets the ID of the task execution attempt.
InputGate	getInputGate(int index)
InputSplitProvider	getInputSplitProvider() Returns the input split provider assigned to this environment.
IOManager	getIOManager() Returns the current IOManager.
Configuration	getJobConfiguration() Returns the job-wide configuration object that was attached to the JobGraph.
JobID	getJobID() Returns the ID of the job that the task belongs to.
JobVertexID	getJobVertexId() Gets the ID of the JobVertex for which this task executes a parallel subtask.
MemoryManager	getMemoryManager() Returns the current MemoryManager.
TaskMetricGroup	getMetricGroup() Returns the task specific metric group.
Configuration	getTaskConfiguration() Returns the task-wide configuration object, originally attached to the job vertex.
TaskInfo	getTaskInfo() Returns the TaskInfo object associated with this subtask
TaskKvStateRegistry	getTaskKvStateRegistry() Returns the registry for InternalKvState instances.
TaskManagerRuntimeInfo	getTaskManagerInfo() Gets the task manager info, with configuration and hostname.
ClassLoader	getUserClassLoader() Returns the user code class loader
ResultPartitionWriter	getWriter(int index)

Methods inherited from class java.lang.Object

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

Constructor Detail

RuntimeEnvironment

public RuntimeEnvironment(JobID jobId,
                  JobVertexID jobVertexId,
                  ExecutionAttemptID executionId,
                  ExecutionConfig executionConfig,
                  TaskInfo taskInfo,
                  Configuration jobConfiguration,
                  Configuration taskConfiguration,
                  ClassLoader userCodeClassLoader,
                  MemoryManager memManager,
                  IOManager ioManager,
                  BroadcastVariableManager bcVarManager,
                  AccumulatorRegistry accumulatorRegistry,
                  TaskKvStateRegistry kvStateRegistry,
                  InputSplitProvider splitProvider,
                  Map<String,Future<Path>> distCacheEntries,
                  ResultPartitionWriter[] writers,
                  InputGate[] inputGates,
                  CheckpointResponder checkpointResponder,
                  TaskManagerRuntimeInfo taskManagerInfo,
                  TaskMetricGroup metrics,
                  Task containingTask)

Method Detail

getExecutionConfig

public ExecutionConfig getExecutionConfig()

Description copied from interface: Environment

Returns the job specific ExecutionConfig.

Specified by:

getExecutionConfig in interface Environment

Returns:

The execution configuration associated with the current job.

getJobID

public JobID getJobID()

Description copied from interface: Environment

Returns the ID of the job that the task belongs to.

Specified by:

getJobID in interface Environment

Returns:

the ID of the job from the original job graph

getJobVertexId

public JobVertexID getJobVertexId()

Description copied from interface: Environment

Gets the ID of the JobVertex for which this task executes a parallel subtask.

Specified by:

getJobVertexId in interface Environment

Returns:

The JobVertexID of this task.

getExecutionId

public ExecutionAttemptID getExecutionId()

Description copied from interface: Environment

Gets the ID of the task execution attempt.

Specified by:

getExecutionId in interface Environment

Returns:

The ID of the task execution attempt.

getTaskInfo

public TaskInfo getTaskInfo()

Description copied from interface: Environment

Returns the TaskInfo object associated with this subtask

Specified by:

getTaskInfo in interface Environment

Returns:

TaskInfo for this subtask

getJobConfiguration

public Configuration getJobConfiguration()

Description copied from interface: Environment

Returns the job-wide configuration object that was attached to the JobGraph.

Specified by:

getJobConfiguration in interface Environment

Returns:

The job-wide configuration

getTaskConfiguration

public Configuration getTaskConfiguration()

Description copied from interface: Environment

Returns the task-wide configuration object, originally attached to the job vertex.

Specified by:

getTaskConfiguration in interface Environment

Returns:

The task-wide configuration

getTaskManagerInfo

public TaskManagerRuntimeInfo getTaskManagerInfo()

Description copied from interface: Environment

Gets the task manager info, with configuration and hostname.

Specified by:

getTaskManagerInfo in interface Environment

Returns:

The task manager info, with configuration and hostname.

getMetricGroup

public TaskMetricGroup getMetricGroup()

Description copied from interface: Environment

Returns the task specific metric group.

Specified by:

getMetricGroup in interface Environment

Returns:

The MetricGroup of this task.

getUserClassLoader

public ClassLoader getUserClassLoader()

Description copied from interface: Environment

Returns the user code class loader

Specified by:

getUserClassLoader in interface Environment

getMemoryManager

public MemoryManager getMemoryManager()

Description copied from interface: Environment

Returns the current MemoryManager.

Specified by:

getMemoryManager in interface Environment

Returns:

the current MemoryManager.

getIOManager

public IOManager getIOManager()

Description copied from interface: Environment

Returns the current IOManager.

Specified by:

getIOManager in interface Environment

Returns:

the current IOManager.

getBroadcastVariableManager

public BroadcastVariableManager getBroadcastVariableManager()

Specified by:

getBroadcastVariableManager in interface Environment

getAccumulatorRegistry

public AccumulatorRegistry getAccumulatorRegistry()

Description copied from interface: Environment

Return the registry for accumulators which are periodically sent to the job manager.

Specified by:

getAccumulatorRegistry in interface Environment

Returns:

the registry

getTaskKvStateRegistry

public TaskKvStateRegistry getTaskKvStateRegistry()

Description copied from interface: Environment

Returns the registry for InternalKvState instances.

Specified by:

getTaskKvStateRegistry in interface Environment

Returns:

KvState registry

getInputSplitProvider

public InputSplitProvider getInputSplitProvider()

Description copied from interface: Environment

Returns the input split provider assigned to this environment.

Specified by:

getInputSplitProvider in interface Environment

Returns:

The input split provider or null if no such provider has been assigned to this environment.

getDistributedCacheEntries

public Map<String,Future<Path>> getDistributedCacheEntries()

Specified by:

getDistributedCacheEntries in interface Environment

getWriter

public ResultPartitionWriter getWriter(int index)

Specified by:

getWriter in interface Environment

getAllWriters

public ResultPartitionWriter[] getAllWriters()

Specified by:

getAllWriters in interface Environment

getInputGate

public InputGate getInputGate(int index)

Specified by:

getInputGate in interface Environment

getAllInputGates

public InputGate[] getAllInputGates()

Specified by:

getAllInputGates in interface Environment

acknowledgeCheckpoint

public void acknowledgeCheckpoint(long checkpointId,
                         CheckpointMetrics checkpointMetrics)

Description copied from interface: Environment

Confirms that the invokable has successfully completed all steps it needed to to for the checkpoint with the give checkpoint-ID. This method does not include any state in the checkpoint.

Specified by:

acknowledgeCheckpoint in interface Environment

Parameters:

checkpointId - ID of this checkpoint

checkpointMetrics - metrics for this checkpoint

acknowledgeCheckpoint

public void acknowledgeCheckpoint(long checkpointId,
                         CheckpointMetrics checkpointMetrics,
                         SubtaskState checkpointStateHandles)

Description copied from interface: Environment

Confirms that the invokable has successfully completed all required steps for the checkpoint with the give checkpoint-ID. This method does include the given state in the checkpoint.

Specified by:

acknowledgeCheckpoint in interface Environment

Parameters:

checkpointId - ID of this checkpoint

checkpointMetrics - metrics for this checkpoint

checkpointStateHandles - All state handles for the checkpointed state

declineCheckpoint

public void declineCheckpoint(long checkpointId,
                     Throwable cause)

Description copied from interface: Environment

Declines a checkpoint. This tells the checkpoint coordinator that this task will not be able to successfully complete a certain checkpoint.

Specified by:

declineCheckpoint in interface Environment

Parameters:

checkpointId - The ID of the declined checkpoint.

cause - An optional reason why the checkpoint was declined.

failExternally

public void failExternally(Throwable cause)

Description copied from interface: Environment

Marks task execution failed for an external reason (a reason other than the task code itself throwing an exception). If the task is already in a terminal state (such as FINISHED, CANCELED, FAILED), or if the task is already canceling this does nothing. Otherwise it sets the state to FAILED, and, if the invokable code is running, starts an asynchronous thread that aborts that code.

This method never blocks.

Specified by:

failExternally in interface Environment