Javadoc用於匿名對象的方法

Question

正確有用地記錄匿名對象功能的最佳方法是什么？ 我正在使用Soar（ 這里的 API）進行一些編程，並且代碼看起來像這樣：

/**
 * 
 * @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;
        }
    };
}

當重要的是知道返回的對象的功能是什么，它對參數等的期望是什么時，我不知道該寫下什么。 Eclipse似乎忽略了javadoc的方法，我真的不想為每個處理程序編寫單獨的類，僅用於文檔目的。

Answer 1

該方法根本不需要任何文檔，因為它是接口的實現，並且應該記錄該接口。 接口的實現表現如此。