Javadoc для метода анонимного объекта

Как лучше всего правильно и с пользой документировать функцию анонимного объекта? Я делаю некоторое Программирование с 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, и я действительно не хочу писать отдельные классы для каждого из обработчиков. для целей документации.

1 3
javadoc methods anonymous-class

1 ответ:

Метод Вообще не должен нуждаться в документации, поскольку это реализация интерфейса, и этот интерфейс должен быть документирован. Реализация интерфейса ведет себя в соответствии с этим.

2