[转载]Java学习总结（Java源文件、JavaDoc文档）

一、Java源文件
1、一个Java应用包含一个或多个Java源文件，每个Java源文件只能包含下列内容(空格和注释除外)
l 零个或一个包声明语句
l 零个或多个包引入语句
l 零个或多个类声明语句
l 零个或多个接口声明
2、每个Java源文件可包含多个类或接口的定义，但是至多只有一个类或者接口是public的，而且Java源文件必须以其中public类型的名字命名。
3、包声明语句用于把Java类放到特定的包中。在一个Java源文件中，最多只能有一个package语句，但package语句不是必需的。如果没有提供package语句，就表明Java类位于默认包中，默认包没有名字。
声明形式：
package 包名;
4、package语句必须位于Java源文件的第一行(忽略注释行)。并且在同一个Java源文件中定义的多个Java类或接口都位于同一个包中。
5、关于包引入的几个注意事项：
l import语句不会导致类的初始化
l 如果一个类同时引用了两个来自于不同包的同名类，在程序中必须通过类的完整类名来区分这两个类。
l 每个包都是独立的，顶层包不会包含子包中的类。
l package和import语句的顺序是固定的，在Java源文件中，package语句必须位于第一行(忽略注释行)，其次是import语句，接着才是类或接口的声明。
6、作为程序入口的main方法，必须是 public static void main(String[] args){…}
7、static修饰的方法默认都是final类型的(不能被子类覆盖)。所以在main方法前加上final也是可以的。
二、JavaDoc文档
Java比C++多了一种注释，即：/**text*/——从“/**”到“*/”之间的所有字符会被编译器忽略。
当这类注释出现在任何声明(如类的声明、接口声明、类的成员变量的声明、类的成员方法的声明或者类的构造方法声明)之前时，会作为JavaDoc文档的内容。而在其他地方使用这种声明，不会出现在JavaDoc文档中。
以下为搜集到的JavaDoc标记的使用方法：
Javadoc注释编写细则
-------------------------------------------------------------------------------------------------------------------------------------------------------
一.Java 文档
// 注释一行
/* ...... */ 注释若干行
/** ...... */ 注释若干行，并写入 javadoc 文档
通常这种注释的多行写法如下：
/**
* .........
* .........
*/
javadoc -d 文档存放目录 -author -version 源文件名.java
这条命令编译一个名为 “源文件名.java”的 java 源