小麦工作室07

2007年10月4日星期四

3个Eclipse插件轻松制作Javadoc

JDocEditor,JAutoDoc,Java2Html。三个小工具，轻松制作JavaDoc.一个是可见即所得的JavaDoc编辑工具，一个是自动建立代码注释的工具，一个是把代码转换成Html格式的工具。
JDocEditor:
http://www.certiv.net/download/downloads.html#jdoceditor
一个所见即所得的Java Doc 编辑器。不用再费神地在代码中调整注释的html标记了，可以自由地编出高质量的带丰富格式的Java Doc 。

JAutoDoc
http://jautodoc.sourceforge.net/index.html#download
自动建立Java Doc 文档。功能十分强大，三个命令实现在所有源代码中加入完整的Java Doc注释。一个命令是加入Package的说明文档，在Package中加入package.html，对package进行说明。
第二个命令是代码文件的头部注释。一个命令就可以自动地在项目的所有代码文件中加入头部注释，或者替换原来的注释。
第三个命令为类、方法、属性加入注释说明。可以根据模式匹配，自动地根据方法的名称，建立更为具有可读性的注释文本。

Java2Html
http://www.java2html.de/eclipse.html
准确地说它不是用来直接建立JavaDoc 的，但是可以用来建立其他文档。它的功能是，把Eclipse中的语法色彩格式转换成为Html,让粘贴到网页上，或者其他文档中的代码带有清晰的语法格式。
例如下面的内容就是java2html辅助建立的：

/**
 * @author mai
 *
 */
public class InitWizardDialog extends WizardDialog {

  /**
   * @param parentShell
   * @param newWizard
   */
  public InitWizardDialog(Shell parentShell) {
      super(parentShell, new InitWizard());
      this.setTitle(msg("initWizardTitle"));
   //this.setMessage(msg("initWizardMessage"));
  }
  public static void openWizardDialog(Shell parentShell){
      InitWizardDialog dialog = new InitWizardDialog(parentShell);
      dialog.open();
  }