[jira] [Commented] (FLINK-15740) Remove Deadline#timeLeft()

["Aljoscha Krettek (Jira)" <ji...@apache.org>]

    [ https://issues.apache.org/jira/browse/FLINK-15740?page=com.atlassian.jira.plugin.system.issuetabpanels:comment-tabpanel&focusedCommentId=17028872#comment-17028872 ] 

Aljoscha Krettek commented on FLINK-15740:
------------------------------------------

I think the simpler fix would be to remove {{timeLeftIfAny()}} and change {{timeLeft()}} to always return a result that is {{>= 0}}. There are only three places that use {{timeLeftIfAny()}} but {{timeLeft()}} is used lots more.

> Remove Deadline#timeLeft()
> --------------------------
>
>                 Key: FLINK-15740
>                 URL: https://issues.apache.org/jira/browse/FLINK-15740
>             Project: Flink
>          Issue Type: Improvement
>          Components: API / DataStream, Tests
>            Reporter: Chesnay Schepler
>            Priority: Major
>              Labels: pull-request-available
>             Fix For: 1.11.0
>
>          Time Spent: 20m
>  Remaining Estimate: 0h
>
> As shown in FLINK-13662, {{Deadline#timeLeft()}} is conceptually broken since there is no reliable way to call said method while ensuring that
>  a) the value is non-negative (desired since most time-based APIs reject negative values)
>  b) the value sign (+,-) corresponds to preceding calls to {{#hasTimeLeft()}}
>  
> As a result any usage of the following form is unreliable and obfuscating error messages.
> {code:java}
> while (deadline.hasTimeLeft()) {
> 	doSomething(deadline.timeLeft());
> } {code}
>  
> All existing usage should be migrate to either
> {code:java}
> while (deadline.hasTimeLeft()) {
> 	doSomething();
> } {code}
> or
> {code:java}
> while (true) {
> 	doSomething(deadline.timeLeftIfAny());
> }
> {code}



--
This message was sent by Atlassian Jira
(v8.3.4#803005)