3

我有一个非常大的 .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. 方法的大小 - 代码行
4

2 回答 2

5

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

除了 Javadoc 之外,还有许多可以处理 Java 的文档生成器。doxygenROBODoc就是两个这样的工具。我相信这两个工具都为项目(例如方法)提供了选项,可以在生成的文档中以与它们在源代码中出现的顺序相同的顺序出现。

于 2009-09-06T01:27:23.930 回答
0

另一种可能的方法是简单地将属于一个或多个单独类的成员分解为一个或多个类,如果它们在概念上确实与类中的其他成员是分开的......

于 2009-09-06T01:30:37.630 回答