org.apache.flink.streaming.runtime.tasks.mailbox

Class MailboxExecutorImpl

java.lang.Object

org.apache.flink.streaming.runtime.tasks.mailbox.MailboxExecutorImpl

All Implemented Interfaces:

MailboxExecutor

@Internal
public final class MailboxExecutorImpl
extends Object
implements MailboxExecutor

Implementation of an executor service build around a mailbox-based execution model.

Field Summary

Fields inherited from interface org.apache.flink.streaming.api.operators.MailboxExecutor

EMPTY_ARGS

Constructor Summary

Constructors

Constructor and Description
MailboxExecutorImpl(TaskMailbox mailbox, int priority, StreamTaskActionExecutor actionExecutor)

Method Summary

Modifier and Type	Method and Description
void	execute(org.apache.flink.util.function.RunnableWithException command, String descriptionFormat, Object... descriptionArgs) Executes the given command at some time in the future in the mailbox thread.
boolean	tryYield() This methods attempts to run the command at the head of the mailbox.
void	yield() This methods starts running the command at the head of the mailbox and is intended to be used by the mailbox thread to yield from a currently ongoing action to another command.

Methods inherited from class java.lang.Object

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

Methods inherited from interface org.apache.flink.streaming.api.operators.MailboxExecutor

execute, submit, submit, submit, submit

Constructor Detail

MailboxExecutorImpl

public MailboxExecutorImpl(@Nonnull
                           TaskMailbox mailbox,
                           int priority,
                           StreamTaskActionExecutor actionExecutor)

Method Detail

execute

public void execute(@Nonnull
                    org.apache.flink.util.function.RunnableWithException command,
                    String descriptionFormat,
                    Object... descriptionArgs)

Description copied from interface: MailboxExecutor

Executes the given command at some time in the future in the mailbox thread.

An optional description can (and should) be added to ease debugging and error-reporting. The description may contain placeholder that refer to the provided description arguments using Formatter syntax. The actual description is only formatted on demand.

Specified by:

execute in interface MailboxExecutor

Parameters:

command - the runnable task to add to the mailbox for execution.

descriptionFormat - the optional description for the command that is used for debugging and error-reporting.

descriptionArgs - the parameters used to format the final description string.

yield

public void yield()
           throws InterruptedException

Description copied from interface: MailboxExecutor

This methods starts running the command at the head of the mailbox and is intended to be used by the mailbox thread to yield from a currently ongoing action to another command. The method blocks until another command to run is available in the mailbox and must only be called from the mailbox thread. Must only be called from the mailbox thread to not violate the single-threaded execution model.

Specified by:

yield in interface MailboxExecutor

Throws:

InterruptedException - on interruption.

tryYield

public boolean tryYield()

Description copied from interface: MailboxExecutor

This methods attempts to run the command at the head of the mailbox. This is intended to be used by the mailbox thread to yield from a currently ongoing action to another command. The method returns true if a command was found and executed or false if the mailbox was empty. Must only be called from the mailbox thread to not violate the single-threaded execution model.

Specified by:

tryYield in interface MailboxExecutor

Returns:

true on successful yielding to another command, false if there was no command to yield to.