1

我有一个案例，我想以下列方式生成一个 javadoc。

  • 我想为整个项目的公共方法生成 javadoc
  • 我想为单个类的受保护方法生成一个 javadoc。

使用 Eclipse 中的 Generate Javadoc 工具很容易做到这一点，但是已经要求在这种情况下使用命令行或批处理脚本而不是 Eclipse GUI 生成 Javadoc。

阅读以下链接后

http://docs.oracle.com/javase/1.5.0/docs/tooldocs/windows/javadoc.html#runningjavadoc

我了解如何从命令行使用 javadoc 工具，但它没有告诉我如何选择要记录的方法类型，而且似乎我必须列出每个类。

我的问题如下，

  • 有没有办法从命令行运行 Eclipse 风格的 Javadoc 生成工具？如果是这样，我在哪里可以找到如何执行此操作的示例。
  • 如果没有办法执行上述操作，有没有办法告诉 javadoc 工具遍历每个包并递归记录其中的类？
  • 有没有办法告诉javadoc工具记录什么类型的方法，公共vs受保护vs等？
4

2 回答 2

2

你可以让eclipse生成一个ant build文件。然后你可以从命令行使用这个 ant 构建文件。

在此处输入图像描述

于 2013-08-05T17:22:55.520 回答
0

从 javadoc 帮助文本中，您可以使用这些标志/参数：

-public                   Show only public classes and members
-protected                Show protected/public classes and members (default)
-package                  Show package/protected/public classes and members
-private                  Show all classes and members
-help                     Display command line options and exit
-doclet <class>           Generate output via alternate doclet
-docletpath <path>        Specify where to find doclet class files
-sourcepath <pathlist>    Specify where to find source files
-classpath <pathlist>     Specify where to find user class files
-exclude <pkglist>        Specify a list of packages to exclude
-subpackages <subpkglist> Specify subpackages to recursively load

或者，您可以使用诸如 ant 或 maven 之类的构建工具来为您生成具有良好包装功能的 javadoc。这是我的一个项目的 ant javadoc 目标：

<target name="javadoc" description = "generate javadoc from source">
    <delete dir="javadoc" verbose ="true"/>
    <javadoc packagenames ="my.app.*"               
            sourcepathref = "javadoc.sourcepath"
            author ="true"
            destdir = "javadoc"
            windowtitle = "${project-name} API"
            linksource= "yes"
            overview="${src}/overview-summary.html"
        access="public">                    



    </javadoc>
    </target>
于 2013-08-05T17:22:51.543 回答