org.apache.flink.runtime.jobmaster

Class JobManagerRunnerImpl

java.lang.Object

org.apache.flink.runtime.jobmaster.JobManagerRunnerImpl

All Implemented Interfaces:

AutoCloseable, OnCompletionActions, JobManagerRunner, LeaderContender, org.apache.flink.util.AutoCloseableAsync

public class JobManagerRunnerImpl
extends Object
implements LeaderContender, OnCompletionActions, JobManagerRunner

The runner for the job manager. It deals with job level leader election and make underlying job manager properly reacted.

Constructor Summary

Constructors

Constructor and Description
JobManagerRunnerImpl(JobGraph jobGraph, JobMasterServiceFactory jobMasterFactory, HighAvailabilityServices haServices, LibraryCacheManager libraryCacheManager, Executor executor, FatalErrorHandler fatalErrorHandler) Exceptions that occur while creating the JobManager or JobManagerRunnerImpl are directly thrown and not reported to the given FatalErrorHandler.

Method Summary

Modifier and Type	Method and Description
CompletableFuture<Void>	closeAsync()
String	getDescription() Returns the description of the LeaderContender for logging purposes.
org.apache.flink.api.common.JobID	getJobID() Get the job id of the executed job.
CompletableFuture<JobMasterGateway>	getJobMasterGateway() Get the JobMasterGateway of the JobMaster.
CompletableFuture<ArchivedExecutionGraph>	getResultFuture() Get the result future of this runner.
void	grantLeadership(UUID leaderSessionID) Callback method which is called by the LeaderElectionService upon selecting this instance as the new leader.
void	handleError(Exception exception) Callback method which is called by LeaderElectionService in case of an error in the service thread.
void	jobFinishedByOther() Job completion notification triggered by self.
void	jobMasterFailed(Throwable cause) The JobMaster failed while executing the job.
void	jobReachedGloballyTerminalState(ArchivedExecutionGraph executionGraph) Job completion notification triggered by JobManager.
void	revokeLeadership() Callback method which is called by the LeaderElectionService upon revoking the leadership of a former leader.
void	start() Start the execution of the JobMaster.

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.util.AutoCloseableAsync

close

Constructor Detail

JobManagerRunnerImpl

public JobManagerRunnerImpl(JobGraph jobGraph,
                            JobMasterServiceFactory jobMasterFactory,
                            HighAvailabilityServices haServices,
                            LibraryCacheManager libraryCacheManager,
                            Executor executor,
                            FatalErrorHandler fatalErrorHandler)
                     throws Exception

Exceptions that occur while creating the JobManager or JobManagerRunnerImpl are directly thrown and not reported to the given FatalErrorHandler.

Throws:

Exception - Thrown if the runner cannot be set up, because either one of the required services could not be started, or the Job could not be initialized.

Method Detail

getJobMasterGateway

public CompletableFuture<JobMasterGateway> getJobMasterGateway()

Description copied from interface: JobManagerRunner

Get the JobMasterGateway of the JobMaster. The future is only completed if the JobMaster becomes leader.

Specified by:

getJobMasterGateway in interface JobManagerRunner

Returns:

Future with the JobMasterGateway once the underlying JobMaster becomes leader

getResultFuture

public CompletableFuture<ArchivedExecutionGraph> getResultFuture()

Description copied from interface: JobManagerRunner

Get the result future of this runner. The future is completed once the executed job reaches a globally terminal state.

Specified by:

getResultFuture in interface JobManagerRunner

Returns:

Future which is completed with the job result

getJobID

public org.apache.flink.api.common.JobID getJobID()

Description copied from interface: JobManagerRunner

Get the job id of the executed job.

Specified by:

getJobID in interface JobManagerRunner

Returns:

job id of the executed job

start

public void start()
           throws Exception

Description copied from interface: JobManagerRunner

Start the execution of the JobMaster.

Specified by:

start in interface JobManagerRunner

Throws:

Exception - if the JobMaster cannot be started

closeAsync

public CompletableFuture<Void> closeAsync()

Specified by:

closeAsync in interface org.apache.flink.util.AutoCloseableAsync

jobReachedGloballyTerminalState

public void jobReachedGloballyTerminalState(ArchivedExecutionGraph executionGraph)

Job completion notification triggered by JobManager.

Specified by:

jobReachedGloballyTerminalState in interface OnCompletionActions

Parameters:

executionGraph - serializable execution graph

jobFinishedByOther

public void jobFinishedByOther()

Job completion notification triggered by self.

Specified by:

jobFinishedByOther in interface OnCompletionActions

jobMasterFailed

public void jobMasterFailed(Throwable cause)

Description copied from interface: OnCompletionActions

The JobMaster failed while executing the job.

Specified by:

jobMasterFailed in interface OnCompletionActions

grantLeadership

public void grantLeadership(UUID leaderSessionID)

Description copied from interface: LeaderContender

Callback method which is called by the LeaderElectionService upon selecting this instance as the new leader. The method is called with the new leader session ID.

Specified by:

grantLeadership in interface LeaderContender

Parameters:

leaderSessionID - New leader session ID

revokeLeadership

public void revokeLeadership()

Description copied from interface: LeaderContender

Callback method which is called by the LeaderElectionService upon revoking the leadership of a former leader. This might happen in case that multiple contenders have been granted leadership.

Specified by:

revokeLeadership in interface LeaderContender

getDescription

public String getDescription()

Description copied from interface: LeaderContender

Returns the description of the LeaderContender for logging purposes.

Specified by:

getDescription in interface LeaderContender

Returns:

Description of this contender.

handleError

public void handleError(Exception exception)

Description copied from interface: LeaderContender

Callback method which is called by LeaderElectionService in case of an error in the service thread.

Specified by:

handleError in interface LeaderContender

Parameters:

exception - Caught exception