익명 객체의 메소드에 대한 Javadoc

Question

익명 객체의 함수를 적절하고 유용하게 문서화하는 가장 좋은 방법은 무엇입니까? 나는 (API here) 서식지 일부 프로그래밍을하고,이 같이 보입니다 코드가 오전 :

/** 
* 
* @return handler that does blah 
*/ 
public static RhsFunctionInterface functionBlah() { 
    return new Kernel.RhsFunctionInterface() { 
     /** 
     * Does blah 
     */ 
     @Override 
     public String rhsFunctionHandler(int eventID, Object data, 
       String agentName, String functionName, String arguments) { 
      return null; 
     } 
    }; 
} 

등의 매개 변수에 대해 무엇을 기대하고, 반환 된 객체의 기능이 무엇을하는지 아는 것이 중요합니다 ., 나는 무엇을 적어야하는지 잘 모른다. 이클립스는 javadoc의 메서드를 무시하는 것처럼 보입니다. 실제로는 문서화를 위해 각 핸들러에 대해 별도의 클래스를 작성하고 싶지는 않습니다.

Answer 1

메서드는 인터페이스의 구현이므로 문서가 전혀 필요하지 않으며 해당 인터페이스를 문서화해야합니다. 인터페이스 구현은 그에 따라 동작합니다.