04第4章Java程序规范.ppt

Java程序设计语言 第四章 Java程序规范 学习内容 4.1 Java源程序结构 4.2 Java编程规范 Java源程序结构 一个完整的java源程序应该包括下列部分： 示例： 例如一个java源程序可以是如下结构，该源程序命名为HelloWorldApp.java ： package语句 Java用包来管理类名空间 程序中包含了package语句，则在运行时就必须包含包名。 运行带有包的Java类： 第一种：在命令行下的path目录下输入字符java p1.p2.HelloWorldApp。 第二种：在环境变量classpath中加入目录path，则运行时在任何目录下输入java p1.p2.HelloWorldApp即可。 import语句 import语句标识，以通知编译器在编译时找到相应的类文件。 java.lang 中的类不需要import。 classpath可以称为类路径，编译器和解释器将从它指定的目录寻找类。 Classpath可以是文件夹也可以是zip或jar格式的压缩文件。 源文件的命名规则 如果在源程序中包含有公共类的定义，则该源文件名必须与该公共类的名字完全一致，字母的大小写都必须一样。 一个java源程序中至多只能有一个公共类的定义 。 Java编程规范 软件开发是一个集体协作的过程，程序员之间的代码是经常要进行交换阅读的，因此，java源程序有一些约定成俗的命名规定，主要目的是为了提高java程序的可读性。 Java源文件范例代码 Java源文件范例代码 文件名 这部分列出了常用的文件名及其后缀。Java程序使用下列文件后缀： Java源文件.java，Java字节码文件.class 文件组织 一个文件由被空行分割而成的段落以及标识每个段落的可选注释共同组成。超过2000行的程序难以阅读，应该尽量避免。Java源文件范例提供了一个布局合理的Java程序范例。 Java源文件 Java源文件还遵循以下规则： - 开头注释 - 包和引入语句 - 类和接口声明 开头注释 所有的源文件都应该在开头有一个C语言风格的注释，其中列出类名、版本信息、日期和版权声明： 包和引入语句 在多数Java源文件中，第一个非注释行是包语句。在它之后可以跟引入语句。例如： 缩进排版 4个空格常被作为缩进排版的一个单位。缩进的确切解释并未详细指定(空格 vs. 制表符)。一个制表符等于8个空格(而非4个)。 行长度 尽量避免一行的长度超过80个字符，因为很多终端和工具不能很好处理之。 换行 当一个表达式无法容纳在一行内时，可以依据如下一般规则断开之： - 在一个逗号后面断开 - 在一个操作符前面断开 - 宁可选择较高级别(higher-level)的断开，而非较低级别(lower-level)的断开 - 新的一行应该与上一行同一级别表达式的开头处对齐 - 如果以上规则导致你的代码混乱或者使你的代码都堆挤在右边，那就代之以缩进8个空格。 换行 以下是断开方法调用的一些例子： 以下是两个断开算术表达式的例子。前者更好，因为断开处位于括号表达式的外边，这是个较高级别的断开。 换行 以下是两个缩进方法声明的例子。前者是常规情形。后者若使用常规的缩进方式将会使第二行和第三行移得很靠右，所以代之以缩进8个空格。 换行 if语句的换行通常使用8个空格的规则，因为常规缩进(4个空格)会使语句体看起来比较费劲。比如： 换行 这里有三种可行的方法用于处理三元运算表达式： 注释 Java程序有两类注释：实现注释(implementation comments)和文档注释(document comments)。实现注释是那些在C++中见过的，使用/*...*/和// 界定的注释。文档注释(被称为doc comments)是Java独有的，并由/**...*/界定。文档注释可以通过javadoc工具转换成HTML文件。 实现注释的格式 程序可以有4种实现注释的风格：块(block)、单行(single-line)、尾端(trailing)和行末(end-of-line)。 块注释 块注释之首应该有一个空行，用于把块注释和代码分割开来，比如： 单行注释 短注释可以显示在一行内，并与其后的代码具有一样的缩进层级。 尾端注释 极短的注释可以与它们所要描述的代码位于同一行，但是应该有足够的空白来分开代码和注释。若有多个短注释出现于大段代码中，它们应该具有相同的缩进。 行末注释 注释界定符//，可以注释掉整行或者一行中的一部分。它一般不用于连续多行的注释文本；然而，它可以用来注释掉连续多行的代码段。 文档注释 文档注释描述Java的类、接口、构造器，方法，以及字段(field)。每个文档注释都会被置