Mailing-List: contact issues-help@flink.apache.org; run by ezmlm
Precedence: bulk
Reply-To: dev@flink.apache.org
Date: Wed, 28 Oct 2015 10:15:27 +0000 (UTC)
From: "ASF GitHub Bot (JIRA)" <jira@apache.org>
To: issues@flink.apache.org
Message-ID: <JIRA.12830103.1431677267000.82537.1446027327931@Atlassian.JIRA>
In-Reply-To: <JIRA.12830103.1431677267000@Atlassian.JIRA>
References: <JIRA.12830103.1431677267000@Atlassian.JIRA>
 <JIRA.12830103.1431677267820@arcas>
Subject: [jira] [Commented] (FLINK-2017) Add predefined required parameters
 to ParameterTool
MIME-Version: 1.0
Content-Type: text/plain; charset=utf-8
Content-Transfer-Encoding: 7bit


    [ https://issues.apache.org/jira/browse/FLINK-2017?page=com.atlassian.jira.plugin.system.issuetabpanels:comment-tabpanel&focusedCommentId=14978133#comment-14978133 ] 

ASF GitHub Bot commented on FLINK-2017:
---------------------------------------

Github user fhueske commented on a diff in the pull request:

    https://github.com/apache/flink/pull/1097#discussion_r43236812
  
    --- Diff: flink-java/src/main/java/org/apache/flink/api/java/utils/RequiredParameters.java ---
    @@ -0,0 +1,150 @@
    +/*
    + * 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.java.utils;
    +
    +import java.util.HashMap;
    +import java.util.Map;
    +import java.util.Objects;
    +
    +/**
    + * Facility to manage required parameters in user defined functions.
    + */
    +public class RequiredParameters {
    +
    +	private static final String HELP_TEXT_PARAM_DELIMITER = "\t";
    +	private static final String HELP_TEXT_LINE_DELIMITER = "\n";
    +
    +	private HashMap<String, Option> data;
    +
    +	public RequiredParameters() {
    +		this.data = new HashMap<>();
    +	}
    +
    +	public Option add(String name) throws RequiredParametersException {
    +		if (!this.data.containsKey(name)) {
    +			Option option = new Option(name);
    +			this.data.put(name, option);
    +			return option;
    +		} else {
    +			throw new RequiredParametersException("Option with passed key already exists. " +  name);
    +		}
    +	}
    +
    +	public void add(Option option) throws RequiredParametersException {
    +		if (!this.data.containsKey(option.getName())) {
    +			this.data.put(option.getName(), option);
    +		} else {
    +			throw new RequiredParametersException("Option with passed key already exists. " +  option.getName());
    +		}
    +	}
    +
    +	/**
    +	 * Check for all parameters in the parameterTool passed to the function:
    +	 * - has a value been passed
    +	 *   - if not, does the parameter have an associated default value
    +	 * - does the type of the parameter match the one defined in RequiredParameters
    +	 * -
    --- End diff --
    
    It is not checked whether the parameter is within the choices list (if choices are defined).


> Add predefined required parameters to ParameterTool
> ---------------------------------------------------
>
>                 Key: FLINK-2017
>                 URL: https://issues.apache.org/jira/browse/FLINK-2017
>             Project: Flink
>          Issue Type: Improvement
>    Affects Versions: 0.9
>            Reporter: Robert Metzger
>              Labels: starter
>
> In FLINK-1525 we've added the {{ParameterTool}}.
> During the PR review, there was a request for required parameters.
> This issue is about implementing a facility to define required parameters. The tool should also be able to print a help menu with a list of all parameters.
> This test case shows my initial ideas how to design the API
> {code}
> 	@Test
> 	public void requiredParameters() {
> 		RequiredParameters required = new RequiredParameters();
> 		Option input = required.add("input").alt("i").help("Path to input file or directory"); // parameter with long and short variant
> 		required.add("output"); // parameter only with long variant
> 		Option parallelism = required.add("parallelism").alt("p").type(Integer.class); // parameter with type
> 		Option spOption = required.add("sourceParallelism").alt("sp").defaultValue(12).help("Number specifying the number of parallel data source instances"); // parameter with default value, specifying the type.
> 		Option executionType = required.add("executionType").alt("et").defaultValue("pipelined").choices("pipelined", "batch");
> 		ParameterUtil parameter = ParameterUtil.fromArgs(new String[]{"-i", "someinput", "--output", "someout", "-p", "15"});
> 		required.check(parameter);
> 		required.printHelp();
> 		required.checkAndPopulate(parameter);
> 		String inputString = input.get();
> 		int par = parallelism.getInteger();
> 		String output = parameter.get("output");
> 		int sourcePar = parameter.getInteger(spOption.getName());
> 	}
> {code}


--
This message was sent by Atlassian JIRA
(v6.3.4#6332)