java第一章课件(清华大学).ppt

1.6 Java Doc文档 1.6.1 语法 /** 类的说明*/ public class DocDemo{ /** 变量的说明*/ public int i=0; /**方法的说明*/ public int m(){} } 1.6 Java Doc文档 对于javadoc的运用主要有两种形式： 内嵌式HTML 文档标签 1.6 Java Doc文档 1.6.2 标签简介 所谓文档标签是一种以@符号为首的命令，@必须置于注解的最前面。 1. 类文档所用的标签 @version 版本信息 用来标示版本信息。 @since 早期的版本号 指出最早的版本。 @author 作者信息 标示作者信息，包括作者的名字、e-mail等信息。可以提供多个@author标签。 1.6 Java Doc文档 1.6.2 标签简介 @see 类名 用以参考其他类的说明文档，javadoc会自动为@see标签产生一个超链接，链接到你所指定的其他文档，但系统并不检查链接的文档是否存在。 1.6 Java Doc文档 2. 变量文档所用的标签 @see 3. 方法文档所用的标签 @param 参数名 描述性文本 对方法的参数进行描述，本标签的使用次数不限。 @return 描述性文本 对方法的返回值进行说明。 @throws 异常类的类名 说明性的文本 对方法可能抛出的异常进行说明。 @deprecated 该标签标示出这一方法已不再使用，有新的方法来替代它。 1.6 Java Doc文档 1.6.3 生成Java Doc文档 编辑源文件 /**学习文档的制作 *@author Songmin *@author email:kcsjwd@ *@version 2.0 *@since 1.0 */ public class DocDemo{ /**普通变量*/ public int i=0; /**m()方法用来使变量i自加1 * @return 本函数返回自加后的i * @exception Exception 没有异常抛出 */ public int m() {return i++;} /**程序的入口函数 * @param args String类型的数组 * @exception Exception 没有异常抛出 */ public static void main(String[ ] args) { DocDemo d=new DocDemo(); int j=d.m(); System.out.println(j);}} 1.6 Java Doc文档 1.6.3 生成Java Doc文档 生成Java Doc文档 javadoc [选项] [软件包名称] [源文件] [@file] Javadoc –author –version –d demo DocDemo.java 在命令行中的输出 输出字符串 System.out.println(“hello”); 输出一个整数变量 System.out.printf(“%d”, a,); 输出一个换行符 System.out.printf(“hello \n”); 实验一 College of information Science and Engineering , Henan University of Technology College of information Science and Engineering , Henan University of Technology College of information Science and Engineering , Henan University of Technology College of information Science and Engineering , Henan University of Technology Java程序设计 刘继承 王社伟 宋敏 主编 讲授：郑丽萍 Tel18623716976 E-mail: 973811610@ 办公室：莲花街6410 ---- Java程序设计及实验 课程要求 考试形式：闭卷 总成绩=平时成绩*10%+实验成绩*20% +期末成绩*70% 平时成绩包括：平时点名+课堂提问和练习+作业 实验成绩: 实验代码检查+实验报告（课