匿名对象的方法的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

该方法根本不需要任何文档，因为它是接口的实现，并且应该记录该接口。接口的实现就是根据这一点工作的。