java - 我应该在 throws 子句中抛出 Exception 的子类型吗？

Question

我正在编写一个 API

void doSomething(args) throws Exception1, Exception2;

Exception1 是 Exception2 的子类型。

Intellij idea 说“throws 列表中已经有一个更一般的异常。”我知道 java 只要求我在 throws 子句中包含 Exception2，但我认为出于文档目的我应该在 throws 子句中同时包含两个，并向调用者表明他们可以分别捕获每个子句并为每个子句做不同的事情。在我的 API 实现中，我抛出 Exception1 并调用抛出 Exception2 的内部方法。

推荐的做法是什么？

谢谢。

Answer 1

您应该编写一个 javadoc 来解释抛出每个特定异常的条件。看看ReadableByteChannel.read()例如 javadoc - 该方法在其 throws 子句中仅声明了 IOException，但在其 javadoc 中描述了该异常的许多更具体的子类。