java - Java 中的 Clean 方法声明

Question

我想编写干净的代码。因此，在编写方法时，我想告知方法的调用者有关参数、返回类型、异常等的信息。在调用方法时，调用者应该已经知道该方法是否可以返回 null 或者参数是否可以为 null。

我可以在 javadoc 中对此进行解释，但我想用注释来完成。我知道 jetbrains 和现在的 JSR305 试图解决这个问题，但我认为它们还不够。

所以:

1. 有没有大型的参数和返回类型的注解库

2. 这个注解只是为了代码的可读性，还是在运行时遇到意外的值/结果时抛出异常？

3. 方法声明应该只包含基本检查异常或它的子类

   public void foo() throws ConnectionException, AuthenticationException {
   }
   
   public class AuthenticationException extends ConnectionException {
   }
   

Answer 1

叫我老派。但这不是 javadoc 的用途吗？