繁体   English   中英

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

[英]Library javadocs generated by maven-javadoc-plugin does not work when linked on Eclipse

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

UPDATE2:我的eclipse版本是4.2.0。

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

问题是:

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

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

也许我没有正确配置我的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>

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

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

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

因为它期望内容属性中的charset如下所示:

 <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>

暂无
暂无

声明:本站的技术帖子网页,遵循CC BY-SA 4.0协议,如果您需要转载,请注明本站网址或者原文地址。任何问题请咨询:yoyou2525@163.com.

 
粤ICP备18138465号  © 2020-2024 STACKOOM.COM