文档注释-南京大学计算机系.ppt

Java程序结构 package语句 //0或1条，必须放在文件开始 import语句 //0或多条，必须放在所有类定义之前 public classDefinition //0或1个。文件名必须与该类的类名完全相同 classDefinition //类定义，个数不限 interfaceDefinition //接口定义，个数不限 * * Java程序结构示例 package javawork.helloworld; /*把编译生成的所有.class文件放到包 　　　　　　　　　　　　　　　 javawork.helloworld中*/ import java.awt.*; 　 //告诉编译器本程序中用到系统的AWT包 import javawork.newcentury; /*告诉编译器本程序中用到用户自定义 　　　　　　　　　　　　　　　的包javawork.newcentury*/ public class HelloWorldApp{......} /*公共类HelloWorldApp的定义， 　　　　　　　　　　　　　　　　　　 名字与文件名相同*/ class TheFirstClass{......} //第一个普通类TheFirstClass的定义 class TheSecondClass{......} //第二个普通类TheSecondClass的定义 ......　　　　　　　　 //其它普通类的定义 interface TheFirstInterface{......} //第一个接口TheFirstInterface的定义 ...... //其它接口定义 * * package语句 包（package）是用于管理生成的java字节码文件（.class），其对应于文件系统中的目录，目的是把编译生成的.class文件放入该目录。 例如：javawork.helloworld对应于目录“path\javawork\helloworld，其中path需在编译时指定，且该目录须存在；如果javawork\helloworld不存在则创建该目录。例如： javac -d f:\javaproject HelloWorldApp.java 则生成的HelloWorldApp.class文件将放在目录 f:\javaproject\javawork\helloworld\中 * * package语句 如果程序中没有package语句，或者有package语句但是在编译时不用-d选项，则生成的.class文件放入当前目录。 * * Import语句 在程序中用到了标准类库或自定义包中的类，需要用import语句来声明。 可以声明一个包：import java.awt.* 在引用到类或者包时，将沿着类路径classpath开始寻找相应的.class文件，因此需要事先设置环境变量classpath： classpath=.；d:\jdk1.3\lib\ * * Java程序结构 源文件的命名规则 如果.java文件包含一个public类，它必须按该类名命名。 一个源文件中最多只能有一个public类，其他类的个数不限。 * * Java编程规范 包名 全小写，一般为名词，如：java.awt.event； 类名 首字母大写，每个单词的首字母大写，如：class HelloWorldApp；　 接口名 同类名，如：interface Collection； 方法名 一般为动词，小写字母开头，每个单词的首字母都要大写，如：balanceAccount，　isButtonPressed； 变量名 全小写，一般为名词，如：length； 常量名 基本类型的常量名为全大写，如：int YEAR, int WEEK_OF_MONTH；对象常量大小写混合。 * * Java帮助文档 Jdk1.3\docs\index.html * * Java帮助文档 查阅JDK命令，选择Tool Documentation * * Java帮助文档 Java、javac、javadoc、appletviewer * * Java帮助文档 查阅类库文档，选择Java 2 Platform API Specification * * Java注释 单行注释：从“//”开始到本行结束的内容都是注释，例如： 　　　 //这是一行单行注释 　　　 //则是另一行单行