Package org.apache.flink.client.deployment.application

Class WebSubmissionJobClient

java.lang.Object

org.apache.flink.client.deployment.application.WebSubmissionJobClient

All Implemented Interfaces:

JobClient

@PublicEvolving
public class WebSubmissionJobClient
extends Object
implements JobClient

A JobClient that only allows asking for the job id of the job it is attached to.

This is used in web submission, where we do not want the Web UI to have jobs blocking threads while waiting for their completion.

Constructor Summary

Constructors

Constructor	Description
WebSubmissionJobClient(JobID jobId)

Method Summary

Modifier and Type	Method	Description
CompletableFuture<Void>	cancel()	Cancels the associated job.
CompletableFuture<Map<String,Object>>	getAccumulators()	Requests the accumulators of the associated job.
CompletableFuture<JobExecutionResult>	getJobExecutionResult()	Returns the result of the job execution of the submitted job.
JobID	getJobID()	Returns the JobID that uniquely identifies the job this client is scoped to.
CompletableFuture<JobStatus>	getJobStatus()	Requests the JobStatus of the associated job.
CompletableFuture<String>	stopWithSavepoint(boolean advanceToEndOfEventTime, String savepointDirectory, SavepointFormatType formatType)	Stops the associated job on Flink cluster.
CompletableFuture<String>	triggerSavepoint(String savepointDirectory, SavepointFormatType formatType)	Triggers a savepoint for the associated job.

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.core.execution.JobClient

reportHeartbeat

Constructor Detail

WebSubmissionJobClient

public WebSubmissionJobClient(JobID jobId)

Method Detail

getJobID

public JobID getJobID()

Description copied from interface: JobClient

Returns the JobID that uniquely identifies the job this client is scoped to.

Specified by:

getJobID in interface JobClient

getJobStatus

public CompletableFuture<JobStatus> getJobStatus()

Description copied from interface: JobClient

Requests the JobStatus of the associated job.

Specified by:

getJobStatus in interface JobClient

cancel

public CompletableFuture<Void> cancel()

Description copied from interface: JobClient

Cancels the associated job.

Specified by:

cancel in interface JobClient

stopWithSavepoint

public CompletableFuture<String> stopWithSavepoint(boolean advanceToEndOfEventTime,
                                                   @Nullable
                                                   String savepointDirectory,
                                                   SavepointFormatType formatType)

Description copied from interface: JobClient

Stops the associated job on Flink cluster.

Stopping works only for streaming programs. Be aware, that the job might continue to run for a while after sending the stop command, because after sources stopped to emit data all operators need to finish processing.

Specified by:

stopWithSavepoint in interface JobClient

Parameters:

advanceToEndOfEventTime - flag indicating if the source should inject a MAX_WATERMARK in the pipeline

savepointDirectory - directory the savepoint should be written to

formatType - binary format of the savepoint

Returns:

a CompletableFuture containing the path where the savepoint is located

triggerSavepoint

public CompletableFuture<String> triggerSavepoint(@Nullable
                                                  String savepointDirectory,
                                                  SavepointFormatType formatType)

Description copied from interface: JobClient

Triggers a savepoint for the associated job. The savepoint will be written to the given savepoint directory, or CheckpointingOptions.SAVEPOINT_DIRECTORY if it is null.

Specified by:

triggerSavepoint in interface JobClient

Parameters:

savepointDirectory - directory the savepoint should be written to

formatType - binary format of the savepoint

Returns:

a CompletableFuture containing the path where the savepoint is located

getAccumulators

public CompletableFuture<Map<String,Object>> getAccumulators()

Description copied from interface: JobClient

Requests the accumulators of the associated job. Accumulators can be requested while it is running or after it has finished. The class loader is used to deserialize the incoming accumulator results.

Specified by:

getAccumulators in interface JobClient

getJobExecutionResult

public CompletableFuture<JobExecutionResult> getJobExecutionResult()

Description copied from interface: JobClient

Returns the result of the job execution of the submitted job.

Specified by:

getJobExecutionResult in interface JobClient