maven - 杀死特定标签的 Javadoc 警告

Question

在使用 Maven 构建时，是否有一种简单的方法/选项可以防止 javadoc 警告？我们为 Eclipse 使用了 soyatec uml 插件，它插入了特殊的标签，这使得我们的构建会抛出很多烦人的警告；我环顾四周，包括在 soyatec 网站上，结果都是空的。

@uml.property 是未知标签

Answer 1

我能找到的唯一答案是配置自定义 Javadoc 标签。

一个例子可能是这样的：

<build>
    <plugins>
        <plugin>
            <groupId>org.apache.maven.plugins</groupId>
            <artifactId>maven-javadoc-plugin</artifactId>
            <version>2.8.1</version>
            <configuration>
                <tags>
                    <tag>
                        <name>uml.property</name>
                        <!-- The value X makes javadoc ignoring the tag -->
                        <placement>X</placement>
                    </tag>
                    <tag>
                        <name>some.other.property</name>
                        <placement>X</placement>
                    </tag>
                    <tag>
                        <name>some.third.property</name>
                        <placement>X</placement>
                    </tag>
                </tags>
            </configuration>
        </plugin>
    </plugins>
</build>

运行时，您将在输出中看到：

mvn javadoc:javadoc

<lots of output>
Note: Custom tags that were not seen:  @uml.property
<maybe more output>

您可以使用以下命令禁用非错误和非警告消息：

mvn javadoc:javadoc -Dquiet

---

定义所有这些标签可能是一项艰巨的工作，但一旦完成，您将不再看到警告。

您可能应该在父 pom 中定义这些自定义标签，每个人都可以使用它来使所有工作受益。