[ https://issues.apache.org/jira/browse/FLINK-4272?page=com.atlassian.jira.plugin.system.issuetabpanels:comment-tabpanel&focusedCommentId=15687015#comment-15687015 ]
ASF GitHub Bot commented on FLINK-4272: --------------------------------------- Github user mxm commented on a diff in the pull request: https://github.com/apache/flink/pull/2732#discussion_r89137469 --- Diff: flink-core/src/main/java/org/apache/flink/api/common/JobClient.java --- @@ -0,0 +1,70 @@ +/* + * Licensed to the Apache Software Foundation (ASF) under one + * or more contributor license agreements. See the NOTICE file + * distributed with this work for additional information + * regarding copyright ownership. The ASF licenses this file + * to you under the Apache License, Version 2.0 (the + * "License"); you may not use this file except in compliance + * with the License. You may obtain a copy of the License at + * + * http://www.apache.org/licenses/LICENSE-2.0 + * + * Unless required by applicable law or agreed to in writing, software + * distributed under the License is distributed on an "AS IS" BASIS, + * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. + * See the License for the specific language governing permissions and + * limitations under the License. + */ +package org.apache.flink.api.common; + +import java.util.Map; + +/* + * An Flink job client interface to interact with running Flink jobs. + */ +public interface JobClient { + + /** + * Gets the JobID associated with this JobClient. + */ + JobID getJobID(); + + /** + * Returns a boolean indicating whether the job execution has finished. + */ + boolean hasFinished() throws Exception; + + /** + * Blocks until the result of the job execution is returned. + */ + JobExecutionResult waitForResult() throws Exception; + + /** + * Gets the accumulator map of a running job. + */ + Map<String, Object> getAccumulators() throws Exception; + + /** + * Cancels a running job. + */ + void cancel() throws Exception; + + /** + * Stops a running job if the job supports stopping. + */ + void stop() throws Exception; + + /** + * Adds a Runnable to this JobClient to be called + * when the client is shut down. Runnables are called + * in the order they are added. --- End diff -- Ay! > Create a JobClient for job control and monitoring > -------------------------------------------------- > > Key: FLINK-4272 > URL: https://issues.apache.org/jira/browse/FLINK-4272 > Project: Flink > Issue Type: New Feature > Components: Client > Reporter: Maximilian Michels > Assignee: Maximilian Michels > Priority: Minor > Fix For: 1.2.0 > > > The aim of this new features is to expose a client to the user which allows > to cancel a running job, retrieve accumulators for a running job, or perform > other actions in the future. Let's call it {{JobClient}} for now (although > this clashes with the existing JobClient class which could be renamed to > JobClientActorUtils instead). > The new client should be returned from the {{ClusterClient}} class upon job > submission. The client should also be instantiatable by the users to retrieve > the JobClient with a JobID. > We should expose the new JobClient to the Java and Scala APIs using a new > method on the {{ExecutionEnvironment}} / {{StreamExecutionEnvironment}} > called {{executeWithControl()}} (perhaps we can find a better name). -- This message was sent by Atlassian JIRA (v6.3.4#6332)