2009-09-06 81 views
2

我有一个非常大的.java类文件,它有很多成员。如何为此创建HTML文档,以便按照外观顺序显示成员,而不按成员类型进行排序? (方法,常量和变量)如何按外观顺序创建Java文档?

例如,如果我的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

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

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

+0

我可以使用任何其他文档生成器能够读取java类文件。 – 2009-09-06 01:28:10

+0

我添加了一些关于您可能会考虑使用的Javadoc以外的其他工具的信息。 – 2009-09-06 01:43:54

0

另一种可能的方法是简单地分解出属于连成一个单独的类或类,如果他们真的是从概念类中的其他成员分开......成员

+0

班级工作完美,而不是你每一个约翰的节目。它非常复杂,我宁愿理解它,而不尝试重新设计它。 – 2009-09-06 01:33:07

+0

当然,理解。我无法抗拒地指出,你描述的那种情况正是重构可以提供帮助的情况。不幸的是,尽管我没有提供有关文档的有用答案。 : - | – 2009-09-06 01:38:36