[ https://issues.apache.org/jira/browse/FLINK-7040?page=com.atlassian.jira.plugin.system.issuetabpanels:comment-tabpanel&focusedCommentId=16137002#comment-16137002 ]
ASF GitHub Bot commented on FLINK-7040: --------------------------------------- Github user tillrohrmann commented on a diff in the pull request: https://github.com/apache/flink/pull/4569#discussion_r134528391 --- Diff: flink-runtime/src/main/java/org/apache/flink/runtime/rest/messages/ParameterMapper.java --- @@ -0,0 +1,83 @@ +/* + * 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.runtime.rest.messages; + +import java.util.Collections; +import java.util.Iterator; +import java.util.Map; +import java.util.Set; + +/** + * This class is used to map query/path {@link Parameter}s to their actual value. + */ +public abstract class ParameterMapper { + + /** + * Maps the given query {@link Parameter}s to their actual value. + * + * @param queryParameters parameters to map + * @return map containing the parameters and their associated value + */ + public Map<Parameter, String> mapQueryParameters(Set<Parameter> queryParameters) { + return Collections.emptyMap(); + } + + /** + * Maps the given path {@link Parameter}s to their actual value. + * + * @param pathParameters parameters to map + * @return map containing the parameters and their associated value + */ + public Map<Parameter, String> mapPathParameters(Set<Parameter> pathParameters) { + return Collections.emptyMap(); + } + + /** + * Resolves the given URL (e.g "jobs/:jobid") using the given path/query parameters. + * + * @param genericUrl URL to resolve + * @param pathParameters path parameters + * @param queryParameters query parameters + * @return resolved url, e.g "/jobs/1234?state=running" + */ + public static String resolveUrl(String genericUrl, Map<Parameter, String> pathParameters, Map<Parameter, String> queryParameters) { + StringBuilder sb = new StringBuilder(genericUrl); + + pathParameters.forEach((parameter, value) -> { + int start = sb.indexOf(":" + parameter.getKey()); + sb.replace(start, start + parameter.getKey().length() + 1, value); + }); --- End diff -- But we could, for example, count how many placeholders there are in the request URL and check that all of them have been replaced, couldn't we? Or is it also a valid request URL if a placeholder has not been replaced with a concrete value? > Flip-6 client-cluster communication > ----------------------------------- > > Key: FLINK-7040 > URL: https://issues.apache.org/jira/browse/FLINK-7040 > Project: Flink > Issue Type: New Feature > Components: Cluster Management, Mesos > Reporter: Till Rohrmann > Assignee: Chesnay Schepler > Priority: Critical > Labels: flip-6 > > With the new Flip-6 architecture, the client will communicate with the > cluster in a RESTful manner. > The cluster shall support the following REST calls: > * List jobs (GET): Get list of all running jobs on the cluster > * Submit job (POST): Submit a job to the cluster (only supported in session > mode) > * Lookup job leader (GET): Gets the JM leader for the given job > * Get job status (GET): Get the status of an executed job (and maybe the > JobExecutionResult) > * Cancel job (PUT): Cancel the given job > * Stop job (PUT): Stops the given job > * Take savepoint (POST): Take savepoint for given job (How to return the > savepoint under which the savepoint was stored? Maybe always having to > specify a path) > * Get KV state (GET): Gets the KV state for the given job and key (Queryable > state) > * Poll/subscribe to notifications for job (GET, WebSocket): Polls new > notifications from the execution of the given job/Opens WebSocket to receive > notifications > The first four REST calls will be served by the REST endpoint running in the > application master/cluster entrypoint. The other calls will be served by a > REST endpoint running along side to the JobManager. > Detailed information about different implementations and their pros and cons > can be found in this document: > https://docs.google.com/document/d/1eIX6FS9stwraRdSUgRSuLXC1sL7NAmxtuqIXe_jSi-k/edit?usp=sharing > The implementation will most likely be Netty based. -- This message was sent by Atlassian JIRA (v6.4.14#64029)