匿名对象方法的Javadoc

Question

正确有效地记录匿名对象的函数的最佳方法是什么？我正在使用 Soar (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;
        }
    };
}

当知道返回对象的功能是什么、它期望的参数是什么等很重要时，我不确定要写下什么。 Eclipse 似乎忽略了 javadoc 的方法，我真的不想为了文档目的而为每个处理程序编写单独的类。

Answer 1

该方法根本不需要任何文档，因为它是接口的实现，并且应该记录该接口。接口的实现就是按照这个来实现的。