如何从 NetBeans 中的 Javadoc 中排除特定包？答案

【问题标题】：How do I exclude a specific package from Javadoc in NetBeans?如何从 NetBeans 中的 Javadoc 中排除特定包？
【发布时间】：2011-06-30 19:04:06
【问题描述】：

NetBeans 为项目中的所有包生成 Javadoc。在“其他 Javadoc 选项”下的项目属性的文档表单中添加“-exclude”Javadoc 选项似乎不起作用。如何告诉 netBeans 从 Javadoc 中排除特定包？

【问题讨论】：

标签： java netbeans javadoc

【解决方案1】：

我为一个 Maven 项目（一个 Jenkins 插件）导入了 WSDL 服务。

JDK8 中的 wsimport 生成 is not compatible with the JDK8 javadoc compiler 的代码。

在解决此问题之前，一种可能的解决方法是将这些文件生成到单独的包中（这在任何情况下都很好），并将其从 javadoc 生成中排除。为 Maven 项目执行此操作的方法是将以下内容添加到 pom.xml。

    <plugins>

        <!-- ... -->

        <plugin>
            <groupId>org.apache.maven.plugins</groupId>
            <artifactId>maven-javadoc-plugin</artifactId>
            <configuration>
                <excludePackageNames>your.package.name</excludePackageNames>
            </configuration>
        </plugin>
    </plugins>

【讨论】：

【解决方案2】：

我会尝试在 ant 构建脚本中编辑 -javadoc-build 目标。在 Files 选项卡上浏览您的项目并找到 nbproject/build-impl.xml，在此文件中找到 -javadoc-build 目标并替换 @ 中的 ${excludes} 变量987654321@ 属性名为 excludes 与您想要的包。

Ant fileset spec.

【讨论】：

谢谢，这成功了，虽然方式很复杂。这种基本任务确实应该有一个 UI。
完全不鼓励修改 build-impl.xml，因为该文件由 IDE 自动管理和更改。相反，在文件 build.xml（放置在项目的主文件夹）中覆盖该目标，IDE 永远不会修改该目标。
如何修改 build.xml 以排除包或文件？
请任何人解释一下如何覆盖该文件（buid-impl.xml）？
可以修改project.properties中的excludes=这一行，而不是修改build-impl.xml。这在某种程度上被弃用了，并且不太可能突破 Netbeans 升级。它应该是一个目录列表，可以包含 Fileset 事物属性的通常 Ant 格式的通配符。