Aljoscha Krettek created FLINK-18011:
----------------------------------------
Summary: Make WatermarkStrategy/WatermarkStrategies more ergonomic
Key: FLINK-18011
URL:
https://issues.apache.org/jira/browse/FLINK-18011 Project: Flink
Issue Type: Sub-task
Components: API / Core, API / DataStream
Reporter: Aljoscha Krettek
Assignee: Aljoscha Krettek
Fix For: 1.11.0
Currently, we have an interface {{WatermarkStrategy}}, which is a {{TimestampAssignerSupplier}} and {{WatermarkGeneratorSupplier}}. The very first design (which is also currently implemented) also added {{WatermarkStrategies}} as a convenience builder for a {{WatermarkStrategy}}. However, I don't think users will ever implement a {{WatermarkStrategy}} but always wrap it in a builder. I also think that {{WatermarkStrategy}} itself is already that builder and we currently have two levels of builders, which also makes them harder to use in the {{DataStream API}} because of type checking issues.
I'm proposing to remove {{WatermarkStrategies}} and to instead put the static methods directly into {{WatermarkStrategy}} and also to remove the {{build()}} method. Instead of a {{build()}} method, API methods on {{WatermarkStrategy}} just keep "piling" features on top of a base {{WatermarkStrategy}} via wrapping.
Example to show what I mean for the API (current):
{code}
DataStream<MyType> input = ...;
input.assignTimestampsAndWatermarks(
WatermarkStrategies.<MyType>.forMonotonousTimestamps().build());
{code}
with the proposed change:
{code}
DataStream<MyType> input = ...;
input.assignTimestampsAndWatermarks(
WatermarkStrategy.forMonotonousTimestamps());
{code}
--
This message was sent by Atlassian Jira
(v8.3.4#803005)