Java程序规范

一. Java源程序结构

一个完整的Java 源程序包括下列部分：
1. package语句 ； //该部分最多只能有一句，且必须放在源程序的第一句
2. import 语句 ； // 可以有多个import语句或者没有，必须放在所有的类定义之前
3. public class Definition ； // 定义公共类，Definition即为公共类的类名，一个Java源程序最多只能有一个公共类的定义，且该Java源程序的文件名必须与该公共类的类名一致
4. class Definition ； //定义类，可以有多个类的定义或没有
5. interface Definition ； //定义接口，可以有多个接口的定义或没有

例如一个Java源程序文件，命名为HelloWorld.java，结构可以如下：

package javawork.helloworld;

import java.util.ArrayList; //告诉编译器本程序用到系统中util包中的ArrayList类
import java.net.*; //告诉编译器本程序用到系统中的net包

public class HelloWorld {......} //公共类名与文件名一致

class TheFirstDemo {......} // 定义第一个普通类
class TheSecondDemo {......} // 定义第二个普通类 

package 语句：由于Java编译器为每个类生成一个字节码文件，且文件名与类名相同，因此同名的类有可能发生冲突。为了解决这一问题，Java提供了“包”这个概念来管理类命空间，包实际上提供了一种命名机制和可见性限制机制。

如 javawork.helloworld.HelloWorld，表示javawork.helloworld 包下的HelloWorld，如果又有一个类被命名为HelloWorld，且这两个类要同时使用，为避免冲突可以将第二个HelloWorld放在其他包中，如 javawork.helloworldsecond.HelloWorld。

import语句： 如果在一个包的类中，调用了其他包的类，则必须用import语句进行标识，已通知编译器在编译时找到相应的类文件。“.*”表示导入这个包中的所有类，系统默认已导入了 java.lang 这个包。

二. Java编程规范

1.包名：全小写的名词，中间可以用点号分隔：java.util.Map ;
2.类名：首字母大写，由多个单词组合而成时，要求每个单词的首字母也大写；
3.接口名：同类名；
4.方法名：通常由多个单词合成，第一个单词通常为动词，首字母小写，中间的每个单词的首字母都大写；
5.变量名：全小写，一般为名词，如 length；
6.常量名：基本数据类型的常量名全大写，如果由多个单词组成，可以用下划线隔开；如果是对象类型的常量，则是大小写混合，用大写字母把单词隔开。

三、Java注释

单行注释：” // “，
多行注释： 在” /* ” 和 ” */ ” 之间的内容都是注释
文档注释： 在” /*” 和 ” / ” 之间的内容都是注释