java - 如何解决 Eclipse 不显示 webapp-javaee7 archetype Maven 项目中 javax.annotation 包的 Javadocs 的问题？

Question

我使用的是 Eclipse Oxygen，但这也是 Neon 版本中的问题。我已经启动了新的 Maven 项目并选择了 webapp-javaee7 原型(prototype)。项目创建完成后，pom.xml配置如下:

<properties>
    <endorsed.dir>${project.build.directory}/endorsed</endorsed.dir>
    <project.build.sourceEncoding>UTF-8</project.build.sourceEncoding>
</properties>

<dependencies>
    <dependency>
        <groupId>javax</groupId>
        <artifactId>javaee-web-api</artifactId>
        <version>7.0</version>
        <scope>provided</scope>
    </dependency>
</dependencies>

<build>
    <plugins>
        <plugin>
            <groupId>org.apache.maven.plugins</groupId>
            <artifactId>maven-compiler-plugin</artifactId>
            <version>3.1</version>
            <configuration>
                <source>1.7</source>
                <target>1.7</target>
                <compilerArguments>
                    <endorseddirs>${endorsed.dir}</endorseddirs>
                </compilerArguments>
            </configuration>
        </plugin>
        <plugin>
            <groupId>org.apache.maven.plugins</groupId>
            <artifactId>maven-war-plugin</artifactId>
            <version>2.3</version>
            <configuration>
                <failOnMissingWebXml>false</failOnMissingWebXml>
            </configuration>
        </plugin>
        <plugin>
            <groupId>org.apache.maven.plugins</groupId>
            <artifactId>maven-dependency-plugin</artifactId>
            <version>2.6</version>
            <executions>
                <execution>
                    <phase>validate</phase>
                    <goals>
                        <goal>copy</goal>
                    </goals>
                    <configuration>
                        <outputDirectory>${endorsed.dir}</outputDirectory>
                        <silent>true</silent>
                        <artifactItems>
                            <artifactItem>
                                <groupId>javax</groupId>
                                <artifactId>javaee-endorsed-api</artifactId>
                                <version>7.0</version>
                                <type>jar</type>
                            </artifactItem>
                        </artifactItems>
                    </configuration>
                </execution>
            </executions>
        </plugin>
    </plugins>
</build>

因此，javaee-endorsed-api-7.0.jar 已添加到 Endorsed 库中。据我了解this post该 jar 文件包含注释包 javax.annotation。

我已将 javax.annotation 包导入到该项目中的一些类中，并使用了一些注释。当我将鼠标悬停在其中一些注释上时，我收到消息:注意:此元素既没有附加源代码，也没有附加 Javadoc，因此找不到 Javadoc。

当我尝试在浏览器中打开“附加”Javadoc 时，我收到警告对话框，指出: (注释名称)的文档位置尚未配置。对于库中的元素，请在父 JAR 的属性页上指定 Javadoc 位置 URL ...\target\endorsed\javaee-endorsed-api-7.0.jar。

无法将源代码或 Javadoc 附加到 javaee-endorsed-api-7.0.jar。

当我制作普通 Java 项目并使用 javax.annotation 包时，Javadocs 将按预期显示。

如何解决这个问题并让 Eclipse 在我正在处理的这个 Maven 项目中显示 javax.annotation 包的 Javadocs？

谢谢。

Answer 1

我在this post的评论中找到了这个问题的解决方案。解决方案基于项目:

• 选择特定项目
• 转到项目 -> 属性 -> Java 构建路径 -> 订购和导出
• 重新排序库，直到 javadoc 出现。

对我来说，将 JRE 系统库置于认可库之上是有效的。这意味着 Eclipse 正在按照此选项卡指定的顺序从库中提取 javadoc。并且因为相关注释的所有 javadoc 都在放置在 jdk 安装的正确目录中的 javadocs 中定义(在此选项卡上注释为 JRE 系统库)，所以现在它们在 Eclipse 中按预期显示。