jolshan commented on a change in pull request #9769:
URL: https://github.com/apache/kafka/pull/9769#discussion_r677932954



##########
File path: clients/src/main/java/org/apache/kafka/clients/admin/Admin.java
##########
@@ -303,7 +303,33 @@ default DescribeTopicsResult 
describeTopics(Collection<String> topicNames) {
      * @param options    The options to use when describing the topic.
      * @return The DescribeTopicsResult.
      */
-    DescribeTopicsResult describeTopics(Collection<String> topicNames, 
DescribeTopicsOptions options);
+    default DescribeTopicsResult describeTopics(Collection<String> topicNames, 
DescribeTopicsOptions options) {
+        return describeTopics(TopicCollection.ofTopicNames(topicNames), 
options);
+    }
+
+    /**
+     * This is a convenience method for {@link 
#describeTopics(TopicCollection, DescribeTopicsOptions)}
+     * with default options. See the overload for more details.
+     * <p>
+     * When using topic IDs, this operation is supported by brokers with 
version 3.1.0 or higher.
+     *
+     * @param topics The topics to describe.
+     * @return The DescribeTopicsResult.
+     */
+    default DescribeTopicsResult describeTopics(TopicCollection topics) {
+        return describeTopics(topics, new DescribeTopicsOptions());
+    }
+
+    /**
+     * describe a batch of topics.

Review comment:
       Can we adjust this javadoc to be `Describe some topics in the cluster.` 
like the previous API?




-- 
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.

To unsubscribe, e-mail: jira-unsubscr...@kafka.apache.org

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


Reply via email to