如何按外观顺序创建Java文档？

Question

我有一个非常大的.java类文件，其中包含很多成员。如何为此创建HTML文档，以便按外观顺序显示成员，而不按成员类型排序？（方法，常量和变量）

例如，如果我的Java代码是：

 private int typeOfAction_1;      // notice the order:  1,2,3..
 public void startAction_2(){
 }

 private int jobtype_3;
 private int jobcount_4;
 private void doJob_5(){
 }

 public void haltAction_6(){
 }

订单的Javadoc成员按字母顺序和按类型排序，因此，成员之间的关系都将丢失：

int jobcount_4;        // notice how the order is lost:  4,3,1..
int jobtype_3;
int typeOfAction_1;

doJob_5()
haltAction_6()
startAction_2()

此外，是否生成具有更智能功能的文档？喜欢：

1. 提取方法和变量的附近注释
2. 方法大小-代码行

Answer 1

Javadoc的标准doclet不支持方法的自定义显示顺序。如果需要此功能，则需要开发一个自定义doclet（或找到满足您要求的现有doclet）。

除了Javadoc之外，还有许多可以处理Java的文档生成器。doxygen和ROBODoc是两个这样的工具。我相信这两个工具都为项目（例如方法）提供了选项，使其在生成的文档中的顺序与在源代码中的顺序相同。