Как правильный способ написать Javadoc в абстрактных методах ⇐ JAVA

[Anonymous]

public interface ISomething
/**
* This method does something!
*/
public void something();
}

public abstract class AbstractSomething implements ISomething
{
/**
* See {@link #doSomething()}
*/
public final void something()
{
doSomething();
// Do something else...
...
}

protected abstract void doSomething();
}

public class ConcreteSomething extends AbstractSomething
{
/**
* Concrete implementation of doSomething(). It does... something!
*/
@Override
protected void doSomething()
{
// Actually do something...
...
}
}
< /code>
Так что у меня есть иерархия класса, которая выглядит как эта. Идея состоит в том, чтобы использовать Public Final Final Something () - затем Abstract - Dosomething () шаблон (), чтобы расширенные классы были обязаны назвать Super (), например,
andrzej respne < /p>
Тогда у меня в конечном итоге будет несколько реализаций, которые расширяют абстрактные. Клиенты этого кода затем создадут эти реализации и будут использовать методы Isomething. < /P>
Примерно так: < /p>
public class Main
{
public static void main(String[] args)
{
ConcreteSomething concrete = new ConcreteSomething();
concrete.something();
}
}
< /code>
Итак, вопрос в том, что использование этой идиомы дизайна есть ли правильный способ написать хороший Javadoc для иерархии? Однако, поскольку метод является окончательным, я не могу просто переопределить его и написать конкретный javadoc. предложения?

Подробнее здесь: https://stackoverflow.com/questions/308 ... ct-methods