0

我正在为数据库访问创建一个 API。

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

例如，

API 版本 1.0：

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

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

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

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

谢谢。

4

3 回答 3

1

如果已经有一个应用程序使用您的接口方法，那么删除以前的方法是不明智的。我宁愿在前一个中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
于 2014-01-23T15:31:50.043 回答
0

如果您正在更改正在使用的方法，就像在这种情况下一样，那么我认为正确的方法是添加新方法并将 @Deprecated 标记添加到旧方法中，并解释为什么它已经不推荐使用，以及应该使用哪种方法。

于 2014-01-23T15:31:37.910 回答
0

您不能只用第二个替换第一个，因为客户端可能会使用SearchBy对象作为实际参数来调用它。这会导致编译错误。

同时拥有这两种方法也是不可能的，因为它们是模棱两可的。如果使用Domain1SearchBy对象调用这两种方法都将适用，因此无法决定使用哪一种。

您唯一的两个选择是给新的另一个名称或更改参数计数。

于 2014-01-23T15:32:00.853 回答