Как сделать Javadoc?

Question

Есть ли способ написать комментарий javadoc как для аксессора, так и для мутатора (getter/setter), чтобы избежать дублирования информации о поле, лежащем в основе метода?

например:

private float value;

/**
 * This value represents something.
 */
public float getValue () {
    return value;
}

/**
 * This value represents something.
 * @param    _value    A new value.
 */
public float setValue (float _value) {
    value = _value;
}

Кажется неэффективным и подверженным ошибкам дублировать информацию о поле 'value' в javadocs для getter и setter....

Answer 1

Вы можете использовать тег @see, чтобы указать из документации одного метода на другой следующим образом:

@see # setValue (float)

Eclipse поможет обеспечить завершение кода для Javadoc, а также упростить создание комментариев.

Для получения подробной информации, @see http://docs.oracle.com/javase/1.5.0/docs/tooldocs/windows/javadoc.html