疯狂java


您现在的位置: 疯狂软件 >> 新闻资讯 >> 正文

Java程序注释—[疯狂java讲义]


 

       Java语言是一门强类型的语言,所有的变量必须先声明、后使用,从而保证程序更加健壮,可以在编译过程中发现源代码的错误。为此,Java语言提供了丰富的基本数据类型,例如整型、字符型、浮点型和布尔型等。基本类型大致上可以分为2类:数值类型和布尔类型,其中数值类型可包括整型、字符型和浮点型,所有数值类型之间可以进行类型转换,这种类型转换包括自动类型和强制类型转换。
       Java语言还提供了一系列功能丰富的运算符,这些运算符包括所有算术运算符,还包含功能丰富的位运算符、比较运算符、逻辑运算符,这些运算符是Java编程的基础。将运算符和操作数连接在一起就形成了表达式。
注释
       我们在编写程序时,总需要为程序添加一些注释,用以说明某段代码的作用,或者说明某个类的用途,某个方法的功能,以及该方法的参数和返回值的数据类型和意义等。
       程序注释的作用非常大,笔者有很多学生在开始学习Java语言时,会很努力写程序,但不大会注意添加注释,他们认为添加注释是一件浪费时间,而且没有意义的事情。经过一段时间的学习,他们写出了一些不错的小程序,如一些游戏、工具软件等。再经过一段时间的学习,他们开始意识到当初写的程序在结构上有很多不足,需要重构。于是他们打开源代码,以为可以很轻松地改写原有的代码,但这时他们发现理解原来写的代码非常困难,很难理解原有的编程思路。
       为什么要添加程序注释?至少有如下三方面的考虑:
       1、永远不要过于相信自己的理解力!当你思路通畅时,进入编程境界时,你可以很流畅地实现某个功能,但这种流畅可能是因为你当时正处于这种开发思路中。为了能在再次阅读这段代码时,还能找回当初编写这段代码的思路,建议添加注释!
       2、可读性第一,效率第二!在那些“古老”的岁月里,编程是少数人的专利;他们随心所欲地写程序,.他们以追逐程序执行效率为目的。但随着软件行业的发展,人们发现仅有少数技术Hacker编程满足不了日益增长的软件需求,越来越多的人加入了编程队伍,并引入了工程化的方式来管理软件开发。这个时候,软件开发成为一种团队协同作战,团队成员的沟通变得很重要,因此,一个人写的代码,需要被整个团队的其他人所理解;而且,随着硬件设备飞速发展,程序的执行效率不再是第一考虑的要素,程序的可读性变成了第一考虑的要素。
       3、代码即文档!很多刚刚学完学校软件工程课程的学生会以为:文档就是Word文档!实际上,程序源代码是程序文档的重要组成部分,当我们想着把各种软件相关文档写规范的时候,不要忘了把软件里最重要的文档:源代码写规范!
       程序注释是源代码的一个重要部分,对于一份规范的程序源代码而言,注释应该占到源代码的1/3以上。几乎所有的编程语言都提供了添加注释的方法,一般的编程语言都提供了基本的单行注释和多行注释语言,Java语言也不例外,除此之外,Java语言还提供了一种文档注释。Java语言的注释一共有三
种类型:
       1、单行注释。
       2、多行注释。
       3、文档注释。(未完.摘自[疯狂java讲义].李刚)