在Eclipse上链接时,由maven-javadoc-plugin生成的库javadocs不起作用

Question

UPDATE1:它不仅仅是参数名,eclipse根本不显示任何javadoc信息.将鼠标悬停在某个班级上时,不显示任何内容.

UPDATE2:我的eclipse版本是4.2.0.

我正在使用Eclipse,我想将库的javadocs附加到我的项目中,这样当我实现一个接口并选择Add unmplemented方法时,方法参数名称会正确显示而不是arg0,arg1等.

问题是:

• 当我通过eclipse(Project> Generate Javadocs ...)生成javadoc并将其链接到我的项目时,它可以工作,换句话说,我看到了正确的方法参数名称.

• 当我通过maven-javadoc-plugin生成javadoc并将其链接到我的项目时它不起作用,换句话说,我看到了arg0,arg1等.

也许我没有正确配置我的maven-javadoc-plugin？在我的pom.xml配置下面:

  <plugin>
    <artifactId>maven-javadoc-plugin</artifactId>
    <version>2.8</version>
    <executions>
      <execution>
        <id>attach-javadocs</id>
        <goals>
          <goal>jar</goal>
        </goals>
      </execution>
    </executions>
  </plugin>

任何帮助将不胜感激.没有看到参数名称是非常糟糕的.

Answer 1

这与eclipse 错误有关，该错误仅在 4.3 版本中修复。基本上 Eclipse 在以下行停止处理 javadoc html 文件：

<meta http-equiv="Content-Type" content="text/html" charset="UTF-8">

因为它需要内容属性中的字符集，如下所示：

 <meta http-equiv="Content-Type" content="text/html; charset=UTF-8">

我认为没有办法告诉 Maven javadoc 插件更改此元标记，但您可以从 Maven 运行下面的 ANT 任务来修复所有 html 文件：

<replace dir="target/apidocs">
    <include name="**/*.html"/>
    <replacetoken><![CDATA[<meta http-equiv="Content-Type" content="text/html" charset="UTF-8">]]></replacetoken>
    <replacevalue><![CDATA[<meta http-equiv="Content-Type" content="text/html; charset=UTF-8">]]></replacevalue>
</replace>