Как расширить следующую функцию API в java и не привести к неоднозначным

Вместо логического флага вы можете использовать Enum как Flag с тремя состояниями.

Если вы используете Java 8, вы должны использовать OptionalBoolean вместо Boolean. Он не так хорош, как его компаньоны Optional<>, OptionalInt, OptionalDouble и т. Д., Но в этом случае это может быть реальным преимуществом.

Поскольку упомянутый OptionalBoolean действительно принадлежит com.sun.javafx.scene.control.behavior.OptionalBoolean, может быть лучшая альтернатива.

Я лично стараюсь воздерживаться от использования null там, где есть лучшие варианты.

Вместо того

class Foo {
    Bar s; // whatever Bar is...
    Foo() {
        Foo(null)
    }

    Foo(Bar s) {
        this.s = s;
    }

    public void doStuff() {
        if (s != null) {
            bar.frobnicate();
        }
    }
}

Может быть лучше иметь

class Foo {
    Bar s; // whatever Bar is...
    Foo() {
        Foo(Bar.EMPTY_VALUE)
    }

    Foo(Bar s) {
        this.s = s;
    }

    public void doStuff() {
        bar.frobnicate();
    }
}

С Bar, имеющим

public final static EMPTY_VALUE = new Bar() {
    // redefine it so that frobnicate() just does nothing.
    // This way, EMPTY_VALUE can be used wherever appropriate
}

Это называется шаблоном нулевого объекта. Хотя он не решает напрямую вашу проблему, он разрешает возникшие у вас неоднозначности, используя null здесь и там.

Другой способ их решения - заставить каждый конструктор напрямую вызывать «главный конструктор».

Таким образом, вы могли бы

foo(a, b) { return foo(a, b, null, null); }
foo(a, c) { return foo(a, null, c, null); }
foo(a, b, c) {return foo(a,b,c,null);}
foo(a, b, d) {return foo(a,b,null, c);}
foo(a, b, c, d) { implement of the function...; }

С тем же успехом это могло быть понятнее.

А) Вы можете дать новым методам другое имя. fooWithFlag

Б) Вы не могли разрешить null (предположительно, он делает то же самое, что и предыдущие методы без флага), и вместо этого использовать примитив boolean

C) Вы можете создать субинтерфейс ServiceWithFlags или ServiceV2 и поместить новые методы только в него. Новый код может использовать его с помощью нового интерфейса, старый код по-прежнему использует старый интерфейс и не видит методов.

Г) Это только ошибка времени компиляции. Это не сломает уже скомпилированный код. Так что вы можете пойти дальше и добавить свои новые методы. Любая двусмысленность будет уловлена ​​компилятором и легко исправлена ​​в процессе разработки.