[jira] [Created] (KAFKA-14373) provide builders for producer/consumer

["Daniel Scanteianu (Jira)" <ji...@apache.org>]

Daniel Scanteianu created KAFKA-14373:
-----------------------------------------

             Summary: provide builders for producer/consumer
                 Key: KAFKA-14373
                 URL: https://issues.apache.org/jira/browse/KAFKA-14373
             Project: Kafka
          Issue Type: Improvement
          Components: clients
            Reporter: Daniel Scanteianu


creating a producer/consumer involves looking up the consts for kafka configuration, and usually doing a lot of googling for what the possible values are for each configuration. Providing a builder where there are named methods to set various configuration, with meaningful parameters (ie: enums for configurations that can only have a few values), and good javadoc would make it much easier from developers working from ides (such as intellij, eclipse, netbeans, etc) to discover the various configurations, and navigate to the documentation for the various options when creating producers/consumers.

A salient consumer example: 

Examples:

Pseudocode:

Producer:

ProducerBuilder(String bootstrapUrl){
...
}

ProducerBuilder withTransactionsEnabled(String transactionalId){
...
// internally sets a flag so that transactions are initialized when producer is built
}

Producer build(){

...

}

Salient Consumer Example:
/**
* ....
* @param strategy : if the strategy is set to NONE, then an error is thrown if a valid offset is passed to seek (etc.), if it is set to EARLIEST, then the consumer will seek to beginning (etc).
*/
ConsumerBuilder withAutoOffsetResetStrategy(OffsetResetStrategy strategy){
...
}
where OffsetResetStrategy is an enum with 3 values (EARLIEST,LATEST, NONE)



--
This message was sent by Atlassian Jira
(v8.20.10#820010)