org.apache.flink.runtime.jobmaster

Class DefaultJobMasterServiceProcess

java.lang.Object

org.apache.flink.runtime.jobmaster.DefaultJobMasterServiceProcess

All Implemented Interfaces:

AutoCloseable, OnCompletionActions, JobMasterServiceProcess, AutoCloseableAsync

public class DefaultJobMasterServiceProcess
extends Object
implements JobMasterServiceProcess, OnCompletionActions

Default JobMasterServiceProcess which is responsible for creating and running a JobMasterService. The process is responsible for receiving the signals from the JobMasterService and to create the respective JobManagerRunnerResult from it.

The JobMasterService can be created asynchronously and the creation can also fail. That is why the process needs to observe the creation operation and complete the resultFuture with an initialization failure.

The resultFuture can be completed with the following values:

• JobManagerRunnerResult to signal an initialization failure of the JobMasterService or the completion of a job
• JobNotFinishedException to signal that the job has not been completed by the JobMasterService
• Exception to signal an unexpected failure

Nested Class Summary

Nested classes/interfaces inherited from interface org.apache.flink.runtime.jobmaster.JobMasterServiceProcess

JobMasterServiceProcess.WaitingForLeadership

Constructor Summary

Constructors

Constructor and Description
DefaultJobMasterServiceProcess(JobID jobId, UUID leaderSessionId, JobMasterServiceFactory jobMasterServiceFactory, Function<Throwable,ArchivedExecutionGraph> failedArchivedExecutionGraphFactory)

Method Summary

Modifier and Type	Method and Description
CompletableFuture<Void>	closeAsync() Trigger the closing of the resource and return the corresponding close future.
CompletableFuture<JobMasterGateway>	getJobMasterGatewayFuture() Future which is completed with the JobMasterGateway once the JobMasterService has been created.
CompletableFuture<String>	getLeaderAddressFuture() Future which is completed with the JobMasterService address once it is created.
UUID	getLeaderSessionId() The leader session id of this process.
CompletableFuture<JobManagerRunnerResult>	getResultFuture() Future which is completed with the result of job execution.
boolean	isInitializedAndRunning() True iff the JobMasterService has been initialized and is running.
void	jobMasterFailed(Throwable cause) The JobMaster failed while executing the job.
void	jobReachedGloballyTerminalState(ExecutionGraphInfo executionGraphInfo) Job reached a globally terminal state.

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.runtime.jobmaster.JobMasterServiceProcess

waitingForLeadership

Methods inherited from interface org.apache.flink.util.AutoCloseableAsync

close

Constructor Detail

DefaultJobMasterServiceProcess

public DefaultJobMasterServiceProcess(JobID jobId,
                                      UUID leaderSessionId,
                                      JobMasterServiceFactory jobMasterServiceFactory,
                                      Function<Throwable,ArchivedExecutionGraph> failedArchivedExecutionGraphFactory)

Method Detail

closeAsync

public CompletableFuture<Void> closeAsync()

Description copied from interface: AutoCloseableAsync

Trigger the closing of the resource and return the corresponding close future.

Specified by:

closeAsync in interface AutoCloseableAsync

Returns:

Future which is completed once the resource has been closed

getLeaderSessionId

public UUID getLeaderSessionId()

Description copied from interface: JobMasterServiceProcess

The leader session id of this process.

Specified by:

getLeaderSessionId in interface JobMasterServiceProcess

isInitializedAndRunning

public boolean isInitializedAndRunning()

Description copied from interface: JobMasterServiceProcess

True iff the JobMasterService has been initialized and is running.

Specified by:

isInitializedAndRunning in interface JobMasterServiceProcess

getJobMasterGatewayFuture

public CompletableFuture<JobMasterGateway> getJobMasterGatewayFuture()

Description copied from interface: JobMasterServiceProcess

Future which is completed with the JobMasterGateway once the JobMasterService has been created. Upon closing of the process, this future is completed exceptionally if it is still uncompleted.

Specified by:

getJobMasterGatewayFuture in interface JobMasterServiceProcess

getResultFuture

public CompletableFuture<JobManagerRunnerResult> getResultFuture()

Description copied from interface: JobMasterServiceProcess

Future which is completed with the result of job execution. The job's result can be the JobManagerRunnerResult, JobNotFinishedException if the job was not finished or an Throwable if an unexpected failure occurs. Upon closing of the process, this future is completed exceptionally with JobNotFinishedException.

Specified by:

getResultFuture in interface JobMasterServiceProcess

getLeaderAddressFuture

public CompletableFuture<String> getLeaderAddressFuture()

Description copied from interface: JobMasterServiceProcess

Future which is completed with the JobMasterService address once it is created.

Specified by:

getLeaderAddressFuture in interface JobMasterServiceProcess

jobReachedGloballyTerminalState

public void jobReachedGloballyTerminalState(ExecutionGraphInfo executionGraphInfo)

Description copied from interface: OnCompletionActions

Job reached a globally terminal state.

Specified by:

jobReachedGloballyTerminalState in interface OnCompletionActions

Parameters:

executionGraphInfo - contains information about the terminated job

jobMasterFailed

public void jobMasterFailed(Throwable cause)

Description copied from interface: OnCompletionActions

The JobMaster failed while executing the job.

Specified by:

jobMasterFailed in interface OnCompletionActions