Given:
interface A
{
/**
* @see some other method
*/
void isGreaterThan(int exclusiveMinimum);
}
interface B extends A
{
/**
* @see {@inheritDoc}
* @throws IllegalArgumentException if [some condition]
*/
@Override
void isGreaterThan(int exclusiveMinimum);
}
interface C extends A
{
/**
* {@inheritDoc}
* <p>
* Records {@code IllegalArgumentException} if [some condition].
* The list of recorded exceptions can be retrieved using {@link #getResult()}
*
* @see {@inheritDoc}
*/
@Override
void isGreaterThan(int exclusiveMinimum);
}
I would like B.doSomething() to inherit @see Javadoc tags from the method it is overriding but {@inheritDoc} doesn't seem to work. Any ideas?
What I'm trying to do
I've got two implementations of A. One throws an exception on the first failure. Another records multiple exceptions and allows them to retrieve the list of failures after all the validations has completed. Both sub-interfaces need to have the same methods, but only one of them will throw an exception. The other notes in its comment how to retrieve the list of exceptions.