java - 在方法定义中使用 @deprecated 并更改参数类型

Question

我正在创建一个用于数据库访问的 API。

已经有一个应用程序使用我们的 API。在这种情况下，如果我想将参数类型从接口(interface)更改为实现类型。

例如，

API 版本 1.0:

getDomain1Data(SearchBy searchBy,List<String> someList);

我可以将其更改为以下内容吗？我想确保 API 用户不会使用另一个域的表列名称搜索 domain1 数据。

getDomain1Data(Domain1SearchBy searchBy,List<String> someList);

如果我这样做，我应该将 deprecated 添加到第一个方法，然后添加第二个方法，或者我可以用第二个方法替换第一个方法。

谢谢。

Answer 1

如果已经有一个应用程序使用您的接口(interface)方法，则删除以前的方法是不明智的。我宁愿添加 getDomain1Data(Domain1SearchBy searchBy,List<String> someList);并添加@Deprecated对前一个的注释。

示例代码:

@Deprecated
static interface SearchBy {
}
static class Domain1SearchBy implements SearchBy {
}

static interface Api10 {
    void some(SearchBy a);
}
static interface Api11 extends Api10 {
    void some(Domain1SearchBy b);
}

static class Api10Impl implements Api10 {
    @Deprecated
    public void some(SearchBy a) {
        System.out.println("some searchby");
    }
}
static class Api11Impl extends Api10Impl implements Api11 {
    public void some(Domain1SearchBy b) {
        System.out.println("some domain1");
    }
}

public static void main(String[] args) {

    //with api 1.0
    Api10 api10 = new Api10Impl();
    api10.some(new SearchBy() {});
    api10.some(new Domain1SearchBy());

    //with api 1.1
    Api11 api11 = new Api11Impl();
    api11.some(new SearchBy() {});
    api11.some(new Domain1SearchBy());

}

结果:

some searchby
some searchby
some searchby
some domain1