相关疑难解决方法(0)

你很快就会发现JDK8在Javadoc方面要严格得多(默认情况下).(链接 - 见最后一点)

如果你从来没有生成任何Javadoc那么你当然不会遇到任何问题,但Maven发布过程之类的事情以及可能你的CI版本会突然失败,因为它们与JDK7一起工作得很好.任何检查Javadoc工具退出值的东西现在都会失败.warnings与JDK7相比,JDK8 Javadoc可能也更冗长,但这不是这里的范围.我们在谈论errors!

存在这个问题是为了收集有关如何处理的提案.什么是最好的方法？是否应该在源代码文件中一劳永逸地修复这些错误？如果你有一个巨大的代码库,这可能是很多工作.还有哪些其他选择？

您也可以评论以前通过的失败的故事.

现在失败的恐怖故事

wsimport工具

wsimport工具是用于创建Web服务使用者的代码生成器.它包含在JDK中.即使您使用wsimportJDK8中的工具,它仍然会生成无法使用JDK8中的javadoc编译器编译的源代码.

@author标签

我打开3-4岁的源代码文件,看到这个:

/**
 * My very best class
 * @author John <john.doe@mine.com> 
 */

现在由于<字符而失败.严格来说,这是合理的,但不是很宽容.

HTML表格

Javadoc中的HTML表格？考虑这个有效的HTML:

/**
 *
 * <table>
 *   <tr>
 *      <td>Col1</td><td>Col2</td><td>Col3</td>
 *   </tr>
 * </table>
 */

这现在失败并显示错误消息no summary or caption for table.一个快速解决方法是这样做:

/**
 *
 * <table summary="">
 *   <tr>
 *      <td>Col1</td><td>Col2</td><td>Col3</td>
 *   </tr>
 * </table>
 */

但为什么这必须是一个来自Javadoc工具的停止世界错误击败我？

现在因为更明显的原因而失败的事情

1. 链接无效,例如 {@link notexist}
2. 格式错误的HTML,例如 always returns <code>true<code> …

使用JDK 8运行javadoc时遇到的最佳解决方法是什么,并且收到此错误.

似乎对于JDK 8,已经确定标签喜欢<br />并且<p />应该生成错误,因为它们是无效的(严格的)HTML 4. 请参阅讨论JDK邮件列表这里

我想知道,因为我只想使用maven编译一些java项目并在这个问题上绊倒.当然,我可以使用该项目提交一张票(我想我会这样),但是如果有一种方法可以禁用这种行为(对于一台机器),那将会很棒.否则,我希望在没有问题的情况下在JDK 8上构建之前需要修复很多项目.

我正在使用Maven Javadoc插件.它输出如下警告:

[ERROR] /home/monperrus/spoon/src/main/java/spoon/visitor/CtVisitor.java:144:
      warning: no @param for <T>

如何将这些警告显示为[WARNING](而不是令人困惑[ERROR])？

A mvn release:perform is failing due to javadocs not being created. So I tried running

mvn javadoc:javadoc

myself and I see that it fails due to the javadoc comments in the source code not having definitions for all of the parameters and return values. Errors are of the format:

Failed to execute goal org.apache.maven.plugins:maven-javadoc-plugin:3.0.1:jar (attach-javadocs) on project my-project: MavenReportException: Error while generating Javadoc:

Exit code: 1 - /my/file.java:36: warning: no description for @return

This, however, used to work. So what …

当我<additionalparam>-Xdoclint:none</additionalparam>用JAVA 8 运行我的pom时Maven工作正常,因为-Xdoclint在JAVA 8中添加了.但是,当我用JAVA 7运行maven时它会抛出一个错误,因为它不在JAVA 7中.

但是我想让pom为JAVA 7和JAVA 8推广,即如果JAVA 8我应该能够使用指定的"additionalparam",但是当使用JAVA 7时,它应该排除该参数.

当我使用依赖项构建项目时，它会出现此错误。

Failed to execute goal org.apache.maven.plugins:maven-javadoc-plugin:2.10.4:jar (attach-javadocs) on project appointmentscheduling-api: MavenReportException: Error while generating Javadoc:

以前我可以正确构建它。我没有改变任何东西，我也尝试了一个备份样本。但是这个错误总是来的。尝试重新安装 javadoc 插件。有一些答案说要更改 pom.xml 文件。他们也没有为我工作。请有人帮我解决这个问题。

提前致谢

我最近将我的项目从Java 7升级到8.由于javadoc的doclint功能,我偶然发现了一些错误.错误:此处不允许使用标记:

java文件中的HTML标记:

<a name="ThpSslEnabled"></a>

我尝试检查是否符合W3C HTML标准的锚标记,但没有找到任何有用的东西.