Как заставить Eclipse показывать Javadoc для аннотаций javax

Мне очень нравится, как в Eclipse есть всплывающая документация Javadoc для различных классов библиотеки Java, которые я использую. Однако я также использую аннотации JPA и JAXB, такие как @Entity и @XMLType. Eclipse распознает их как действительные, потому что я могу нажать Ctrl-Space, и они всплывают. Я также получаю Javadoc для классов javax.

Но для этих аннотаций нет Javadoc... он просто сообщает, что Javadoc не найден.

Я загрузил javadoc, установил его в свою систему и связал со всеми JAR-файлами в моей системной библиотеке Java6 (единственный установленный).

Любые идеи? Трудно поверить, что в аннотациях нет Javadoc!


annotations javadoc
person HDave    schedule 01.02.2010    source источник
comment
Я наконец сделал. Зайдите в настройки-> maven и проверьте источник артефакта и артефакт javadoc. Сделал трюк. Спасибо!   -  person HDave    schedule 29.04.2010

Ответы (1)


arrow_upward
3
arrow_downward

@Entity не помечен аннотацией @Documented.

@Target(TYPE) 
@Retention(RUNTIME)
public @interface Entity {

Если вместо этого вы попробуете использовать аннотацию @javax.Inject, вы должны увидеть JavaDoc, так как он помечен @Documented.

@Target({ METHOD, CONSTRUCTOR, FIELD })
@Retention(RUNTIME)
@Documented
public @interface Inject {}

Аннотация @Documented с JavaDoc:

/**
 * Indicates that annotations with a type are to be documented by javadoc
 * and similar tools by default.  This type should be used to annotate the 
 * declarations of types whose annotations affect the use of annotated
 * elements by their clients.  If a type declaration is annotated with
 * Documented, its annotations become part of the public API
 * of the annotated elements.
 *
 * @author  Joshua Bloch
 * @version 1.6, 11/17/05
 * @since 1.5
 */
@Documented
@Retention(RetentionPolicy.RUNTIME)
@Target(ElementType.ANNOTATION_TYPE)
public @interface Documented {
}

Решение состоит в том, чтобы импортировать исходный код Java вместо JavaDoc. Тогда он будет работать так, как вы ожидаете.

person Espen    schedule 13.04.2010