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

该方法根本不需要任何文档，因为它是接口(interface)的实现，应该记录该接口(interface)。接口(interface)的实现根据该行为。