[FLINK-14835] Make `org.apache.flink.configuration.Configuration` support method chaining

• Type: Improvement
• Status: Closed
• Priority: Major
• Resolution: Abandoned
• Affects Version/s: 1.9.1
• Component/s: Runtime / Configuration
• Assignee: Unassigned
• Reporter: jiasheng55
• Created: 18/Nov/19 03:01
• Updated: 29/Nov/19 12:34
• Resolved: 29/Nov/19 12:34

Description

Goal:

To make the following code examples work in production, which is very handy for users to set a couple of configurations: 

// instantiate table environment
TableEnvironment tEnv = ...tEnv.getConfig()        // access high-level configuration
  .getConfiguration()   // set low-level key-value options
  .setString("table.exec.mini-batch.enabled", "true")  // enable mini-batch optimization
  .setString("table.exec.mini-batch.allow-latency", "5 s") // use 5 seconds to buffer input records
  .setString("table.exec.mini-batch.size", "5000"); // the maximum number of records can be buffered by each aggregate operator task

 

Suggestion:

Currently, the return type of `setXXX` method is "void", we can make it return `Configuration` itself to support method chaining.

Issue Links

• is related to: FLINK-14817 "Streaming Aggregation" document contains misleading code examples