java - 如何为没有源代码的类生成 JavaDoc 文档？

Question

我想在我没有源代码的 jar 中生成一些类文件的基本 html 接口(interface)文档(当然没有注释)。我该怎么做呢？

java 1.3可用的classdoc老工具[Class Doc][1]http://classdoc.sourceforge.net/就是用来提供这个服务的。在我看来，这可以通过使用反射来完成。

关于如何在 1.6 或 1.7 类上执行这个看似简单的任务，有没有使用 javadoc 或其他实用程序的想法或示例？

Answer 1

可能有自动化解决方案，但我不知道。我最好的选择是手动编写一些代码，这些代码将生成内部带有 javadoc 的虚拟 java 文件。您必须使用如下方式浏览 jar 文件:

ArrayList<Class> classes = new ArrayList<Class>();    
    JarFile jfile = new JarFile("your jar file name");
    String pkgpath = pckgname.replace(".", "/");     
    for (Enumeration<JarEntry> entries = jfile.entries(); entries.hasMoreElements();) {
        JarEntry element = entries.nextElement();     
        if(element.getName().startsWith(pkgpath)
            && element.getName().endsWith(".class")){     
            String fileName = element.getName().substring(pckgname.length() + 1);     
            classes.add(Class.forName(pckgname + "." + fileName .split("\\.")[0]));     
        }     
    }

然后对于每个类，您必须浏览它们的方法以最终记下看起来像 jar 文件中的原始类的虚拟类。当代码将虚拟方法写入文件时，让它也根据参数和返回类型编写 javadoc 注释。

完成此操作后，使用 javadoc 从您的虚拟类生成文档。

这可能有点长，但这是我的猜测...