由于 Kotlin 没有检查异常，记录接口方法预期抛出的异常的正确方法是什么？我应该在接口中还是在实现类中记录它（仅当具体方法实际抛出它时）？
【问题讨论】：
@Throws 注释。 IMO 将其放在接口方法上最有意义。
由于客户端程序针对该接口进行编程，我建议在该接口的 Javadoc/KDoc 中制作文档。您是否真的应该记录它们在 this 线程中讨论，例如：
Oracle推荐：
如果记录方法的 API 非常好，包括它可以抛出的异常，为什么不指定运行时异常呢？
运行时异常表示由编程问题引起的问题，因此，不能合理地期望 API 客户端代码从它们中恢复或以任何方式处理它们。此类问题包括算术异常，例如除以零；指针异常，例如试图通过空引用访问对象；和索引异常，例如试图通过太大或太小的索引访问数组元素。
运行时异常可以在程序的任何地方发生，在典型的情况下，它们可能非常多。必须在每个方法声明中添加运行时异常会降低程序的清晰度。
因此，如果信息对客户有用，则应记录在案（即客户是否可以处理，例如IOException）。对于“常规”运行时异常，例如IllegalArgumentException，我会说“不”，不要记录它们。
【讨论】：