加入收藏 | 设为首页 | 会员中心 | 我要投稿 李大同 (https://www.lidatong.com.cn/)- 科技、建站、经验、云计算、5G、大数据,站长网!
当前位置: 首页 > 编程开发 > Java > 正文

Java API中断

发布时间:2020-12-15 00:05:10 所属栏目:Java 来源:网络整理
导读:我有以下API: public interface MyApi { /** * Performs some stuff. * @throws MyException if condition C1 */ public void method() throws MyException;} 我现在正在API实现中执行以下修改 public class MyApiImpl { public void method() throws MyExc
我有以下API:
public interface MyApi {

   /**
    * Performs some stuff.
    * @throws MyException if condition C1
    */
   public void method() throws MyException;
}

我现在正在API实现中执行以下修改

public class MyApiImpl {

   public void method() throws MyException {
     if (C1) {
       throw new MyException("c1 message");
     }
     ...
   }
}

被替换为:

public class MyApiImpl {

   public void method() throws MyException {
     if (C1) {
        throw new MyException("c1 message");
     } else if (c2) {
        throw new MyException("c2 message");
     }
     ...
   }
}

你认为这是一个API破坏?

客户端的代码仍然会编译,但API javadoc定义的方法契约不再受到尊重,因为MyExcepiton被“新”条件抛出.

如果只更新了我的API jar文件,客户端应用程序仍然可以工作,但根据客户端捕获异常的方式,应用程序行为可能会发生很大变化.

你对此持何看法?

解决方法

是的,当C1没有发生时,你通过抛出异常来破坏接口的契约.

根据经验,接口契约的变形,更容易不破坏:)如果接口没有用显式C1来定义,但更一般地说,这给了更多的灵活性.

(编辑:李大同)

【声明】本站内容均来自网络,其相关言论仅代表作者个人观点,不代表本站立场。若无意侵犯到您的权利,请及时与联系站长删除相关内容!

    推荐文章
      热点阅读