Java API 文档生成器


以下程序使用文档注释中的一些重要标签。你可以根据你的需要使用其他标签。

关于 AddNum 类的文档将生成 HTML 文件 AddNum.html,但同时,还将创建一个名为 index.html 的主文件。

import java.io.*;
/**
  * <h1>Add Two Numbers!</h1>
  * The AddNum program implements an application that
  * simply adds two given integer numbers and Prints
  * the output on the screen.
  * <p>
  * <b>Note:</b> Giving proper comments in your program makes it more
  * user friendly and it is assumed as a high quality code.
  * </p>
  * @author Zara Ali
  * @version 1.0
  * @since 2014-03-31
  */

public class AddNum {
   /**
     * This method is used to add two integers. This is
     * a the simplest form of a class method, just to
     * show the usage of various javadoc Tags.
     * @param numA This is the first paramter to addNum method
     * @param numB This is the second parameter to addNum method
     * @return int This returns sum of numA and numB.
     */
   
   public int addNum(int numA, int numB) {
      return numA + numB;
   }
   /**
    * This is the main method which makes use of addNum method.
    * @param args Unused.
    * @return Nothing.
    * @exception IOException On input error.
    * @see IOException
    */

   public static void main(String args[]) throws IOException {
      AddNum obj = new AddNum();
      int sum = obj.addNum(10, 20);
      System.out.println("Sum of 10 and 20 is :" + sum);
   }
}

现在,使用 Javadoc 实用程序处理上述 AddNum.java 文件,如下所示 −

$ javadoc AddNum.java
Loading source file AddNum.java...
Constructing Javadoc information...
Standard Doclet version 1.7.0_51
Building tree for all the packages and classes...
Generating /AddNum.html...
AddNum.java:36: warning - @return tag cannot be used in method with void return type.
Generating /package-frame.html...
Generating /package-summary.html...
Generating /package-tree.html...
Generating /constant-values.html...
Building index for all the packages and classes...
Generating /overview-tree.html...
Generating /index-all.html...
Generating /deprecated-list.html...
Building index for all classes...
Generating /allclasses-frame.html...
Generating /allclasses-noframe.html...
Generating /index.html...
Generating /help-doc.html...
1 warning
$


更新于:2020-02-25

539 浏览

开启你的 职业生涯

通过完成课程获得认证

开始
广告