2012-05-08 15 views
3

ソースを持たないjarファイル内のクラスファイルの基本的なhtmlインタフェースドキュメント(もちろんコメントなし)を生成したいと思います。これをやり遂げるにはどうすればいいですか?ソースのないクラスのJavaDocドキュメントを生成するには?

classdoc [Class Doc] [1] http://classdoc.sourceforge.net/の古いツールは、このサービスを提供するためにJava 1.3で使用できました。これは反射を利用して行うことができます。

javadocまたは別のユーティリティを使用して、1.6または1.7クラスで一見単純なタスクを実行する方法に関するアイデアや例はありますか?

+0

これはあなたを助けるかもしれません:http://stackoverflow.com/questions/29689/javadoc-template-generator –

答えて

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を使用してダミークラスからドキュメントを生成します。これは、それはこの1つは私の推測ですが行うのは少し長いかもしれません

...

1

あなたがクラスをリストするためjar tvf yourjar.jarを使用し、クラスを分解するためのjavapことができ、それは非常に読みやすいドキュメントを生成します。