资源描述
单击此处编辑母版标题样式,单击此处编辑母版文本样式,第二级,第三级,第四级,第五级,*,*,教材:雍俊海.Java 程序设计.北京:清华大学出版社,2008.,Java,程序设计,Programming in Java,雍俊,海,清华大学软件学院,School of Software,Tsinghua University,yongjunhai,4/9/2026,1,教材,雍俊海,.Java,程序设计,.,北京,:,清华大学出版社,2008.,4/9/2026,2,辅助教材,雍俊海,.Java,程序设计教程(第,2,版),.,北京,:,清华大学出版社,2007.,4/9/2026,3,习题集,雍俊海,.Java,程序设计习题集,(,含参考答案,).,北京,:,清华大学出版社,2006.,4/9/2026,4,参考文献,本课件的参考文献与下列书的参考文献相同,雍俊海,.Java,程序设计,.,北京,:,清华大学出版社,2008.,雍俊海,.Java,程序设计教程(第,2,版),.,北京,:,清华大学出版社,2007.,雍俊海,.Java,程序设计习题集,(,含参考答案,).,北京,:,清华大学出版社,2006.,雍俊海,.Java,程序设计,.,北京,:,清华大学出版社,2004.,4/9/2026,5,第,10,章 编程规范,雍俊海,(Jun-Hai Yong),清华大学软件学院,School of Software,Tsinghua University,yongjunhai,4/9/2026,6,本章总体纲要,编程规范,文档注释,4/9/2026,7,Java,编程风格的指导方针,指导方针是可以被打破,但要求是确实所需要的,例如增加可读性,没有标准可以做到完美无缺,也没有标准可以做到适用于所有的应用,指导方针一般是为了,:,增加可读性、程序的可理解性,从而提高程序的可维护性以及程序代码质量,4/9/2026,8,命名规范,良好的命名规范可以增强程序的可读性,可以给标识符提供功能,/,属性上的一些额外信息,例如,:,是否是常量、类、包等。这些信息对理解程序非常有帮助,4/9/2026,9,问题,?,命名规范应当包含哪些内容,?,4/9/2026,10,命名规范内容,包,文件,类,/,接口,方法,变量,常量,4/9/2026,11,包的命名规范,包的,名称一般全部采用小写,包名的,前缀一般是域名单词序列的逆序,示例,com.sun.eng,com.apple.quicktime,edu.cmu.cs.bovik.cheese,4/9/2026,12,文件的命名规范,Java,源程序文件的命名规范,必须与该文件中,public,类的,类名同名,后缀必须是,.java,4/9/2026,13,类,/,接口的命名规范,类名一般是,名词,/,名词词组,:,每个单词的首字母大写,其它字母小写,类名应当尽量,简单,,而且其含义能够尽量准确地刻画该类的含义,一般采用,全称,尽量少用缩写词,(,除非该缩写词被广泛使用,),示例,J_Clock,J_Circle,Time,ImageSprite,(,图版精灵,),4/9/2026,14,方法的命名规范,方法名一般是,/,动词,/,动词性词组,首字母,小写,中间单词的首字母,大写,,其它字母小写,示例,:,run();,getBackground,();,getTime,();,4/9/2026,15,尽量应用常用词,尽量应用简单的、常用的单词,示例,:,get/set first/last,add/remove up/down,create/destroy min/max,start/stop next/previous,insert/delete old/new,increment/decrement open/close,old/new show/hide,begin/end,4/9/2026,16,变量的命名规范,变量名的首字母小写,中间单词的首字母大写,其它字母小写,变量名的首字母尽量不要用字符,:,_,或,$,变量名应当简短、有含义、且便于,记忆,示例,:,int,i;,char,c;,double,widthBox,;,4/9/2026,17,变量的命名规范,变量名常常由表示其所扮演的角色与数据类型组成,示例,:,Point,startingPoint,centerPoint,;,Name,loginName,;,4/9/2026,18,常量的命名规范,常量名一般全大写,单词之间用下划线分隔,(“_”),示例,:,static final,int,MIN_WIDTH,=4;,static final,int,MAX_WIDTH,=999;,4/9/2026,19,编辑 方法,特殊字符,行数,/,每行的字符数,缩排方式,(Indentation),空白符,/,行,4/9/2026,20,语句书写,关键,保证代码的简单性,4/9/2026,21,文件组织,源程序文件一般采用如下的组织顺序,:,最,开始一般是注释,package,和,import,语句,类和接口的定义,4/9/2026,22,本章总体纲要,编程规范,文档注释,4/9/2026,23,javadoc,Javadoc,是,一种从文档注释生成,HTML,帮助文件的工具,文档注释介于,/*,和,*,/,之间,示例,/*Sorts integer array using,MySort,algorithm*/,4/9/2026,24,文档注释的一般格式,示例,:,/*,*This is the description part of a doc comment,*,*tag Comment for the tag,*/,4/9/2026,25,常用的,javadoc,文档标签,author,param,return,see,throws,deprecated,link,since,version,4/9/2026,26,运行,javadoc,在命令行下执行,:,javadoc,options packages sources,options,:,选项列表,packages,:,包,列表,sources,:,源文件列表,示例,:,javadoc,-d.-author Time3.java,4/9/2026,27,作业,习题,10.7,4/9/2026,28,本课,件,使用要求,使用本课件,必须注明引用,(,具体见下一个幻灯片,),书及课件均可能出现一些错误和缺陷,恳切希望广大读者特别是讲授此课程的老师批评指正,4/9/2026,29,引用声明,本课件来源于,(,或参考了,),下面的书及其课件,:,雍俊海,.Java,程序设计,.,北京,:,清华大学出版社,2008.,4/9/2026,30,免责声明,请合法使用课件,其用途应当合法有益而且不应对任何人造成任何伤害或损失,同时请注意教材作者及出版社没有对本课件做出任何承诺与保证,4/9/2026,31,参考文献,本课件的参考文献与下列书的参考文献相同,雍俊海,.Java,程序设计,.,北京,:,清华大学出版社,2008.,雍俊海,.Java,程序设计教程(第,2,版),.,北京,:,清华大学出版社,2007.,雍俊海,.Java,程序设计习题集,(,含参考答案,).,北京,:,清华大学出版社,2006.,雍俊海,.Java,程序设计,.,北京,:,清华大学出版社,2004.,4/9/2026,32,谢谢,请多指教,4/9/2026,33,
展开阅读全文