hachikuji commented on a change in pull request #9883:
URL: https://github.com/apache/kafka/pull/9883#discussion_r557064046



##########
File path: clients/src/main/java/org/apache/kafka/common/config/ConfigDef.java
##########
@@ -404,13 +404,47 @@ public ConfigDef define(String name, Type type, 
Importance importance, String do
      * @param name              The name of the config parameter
      * @param type              The type of the config
      * @param defaultValue      The default value to use if this config isn't 
present
-     * @param importance
+     * @param importance        The importance of this config (i.e. is this 
something you will likely need to change?)
      * @return This ConfigDef so you can chain calls
      */
     public ConfigDef defineInternal(final String name, final Type type, final 
Object defaultValue, final Importance importance) {
         return define(new ConfigKey(name, type, defaultValue, null, 
importance, "", "", -1, Width.NONE, name, Collections.<String>emptyList(), 
null, true));
     }
 
+    /**
+     * Define a new internal configuration. Internal configuration won't show 
up in the docs and aren't
+     * intended for general use.
+     * @param name              The name of the config parameter
+     * @param type              The type of the config
+     * @param defaultValue      The default value to use if this config isn't 
present
+     * @param validator     the validator to use in checking the correctness 
of the config
+     * @param importance        The importance of this config (i.e. is this 
something you will likely need to change?)
+     * @return This ConfigDef so you can chain calls
+     */
+    public ConfigDef defineInternal(
+        final String name,
+        final Type type,
+        final Object defaultValue,
+        final Validator validator,
+        final Importance importance
+    ) {
+        return define(new ConfigKey(
+            name,
+            type,
+            defaultValue,
+            validator,
+            importance,
+            "",
+            "",
+            -1,
+            Width.NONE,
+            name,
+            Collections.<String>emptyList(),
+            null,
+            true
+        ));
+    }

Review comment:
       Fair enough, I'll conform. I just find the other style hard to read.




----------------------------------------------------------------
This is an automated message from the Apache Git Service.
To respond to the message, please log on to GitHub and use the
URL above to go to the specific comment.

For queries about this service, please contact Infrastructure at:
us...@infra.apache.org


Reply via email to