JAVA菜鸟入门篇 - Package包、生成自己的API文档（七）

1、包

package包的用法：

为什么需要package？
   - 为了解决类之间的重名问题
   - 为了便于管理类：合适的类位于合适的包

package怎么用？
   - 通常是类的第一句非注释性语句
   - 包名：域名倒着写即可，再加上模块名，并与内部管理类

注意事项：
   - 写项目时都要加包，不要使用默认的包。

   - com.bei和com.bei.taxi，这两个包没有包含关系，是两个完全独立的包。只是逻辑上看起来后者是前者的一部分。

JDK中主要的包：

   1）、java.lang----包含一些 Java 语言的核心类，包含构成 Java 语言设计基础的类。如String、Math、Integer、System和Thread，提供常用功能。在此包中定义的最重要的一个类是“Object”，代表类层次的根，Java 是一个单根系统，最终的根就是“Object”，这个类会在后面讲到。
 
   Java并不具有“自由”的方法，例如，不属于任何类的方法，Java 中的所有方法必须始终属于某个类。经常需要使用数据类型转换方法。Java 在 Java.lang 包中定义了“包装对象”类，使我们能够实现数据类型转换。如 Boolean、Character、Integer、Long、Float 和Double，这些在后面会讲到。
 
   此包中的其它类包括：
 
   Math——封装最常用的数学方法，如正弦、余弦和平方根。
 
   String，StringBuffer——封装最常用的字符串操作。
 
   2）、java.awt----包含了构成抽象窗口工具集（abstract window toolkits）的多个类，这些类被用来构建和管理应用程序的图形用户界面(GUI)。
 
   3）、javax.swing----完全 Java 版的图形用户界面(GUI)解决方案，提供了很多完备的组件，可以应对复杂的桌面系统构建。

   4）、java.applet----包含applet运行所需要的一些类。

 
   5）、java.net----包含执行与网络相关的操作的类，如 URL, Socket, ServerSocket 等。
 
   6）、java.io----包含能提供多种输入/输出功能的类。
 
   7）、java.util----包含一些实用工具类，如定义系统特性、使用与日期日历相关的方法。还有重要的集合框架。

   注意：java1.2以后的版本中，java.lang这个包会自动被导入，对于其中的类，不需要使用import语句来做

导入了，如前面经常使用的System类。

2、生成自己项目的API文档

  API(Application Programming Interface)：应用程序编程接口
  特殊的注释：
   - 文档注释标记：    

/**
* @param 
*/

  使用JAVADOC生成API文档
   - 解决问题：代码和文档的分离

  常用的java注释标签
   - @Author 作者
   - @version 版本
   - @param 参数
   - @return  返回值的含义
   - @throws 抛出异常的描述
   - @deprecated 废弃，建议用户不再使用的方法

在eclipse中创建api文档的步骤 
1. 右键单击项目，选中项目，右键选择export，找到java类目中javadoc
 
 
 2、选择要生成文档的项目，Javadoc文档的可见性默认选择public，以及文档存放的目录。

 
 本文参考：http://www.fu-he.com/java/jishu_d.asp?id=3809