Java_26_API文档_注释_package的概念

API：Application Programming Lnterface

API文档

JDK为我们提供了很多类，如何使用这些类。我们可以通过查看API文档来获取信息。API文档就相当于我们学英语用的词典一样。

package包的概念

为了便于管理类：合适的类位于合适的包。

为了解决类之间的重名问题。

package用法

通常是类的第一句非注释性语句。

包名：域名倒着写即可，加上模块名，并于内部管理类。

其实内部实现就是靠目录结构来做到的。

com.nuipc.test;

com.nuipc.test.test01;

com.nuipc.test.view;

com.nuipc.test.view.model;

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

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

JDK中的主要包

java.lang--包含一些Java语言的核心类，如String、Math、Integer、System、Thread，提供常用功能。

java.awt--包含了构成抽象窗口工具集（abstract win-dow toolkits）的多个类，这些类被用来构建和管理应用程序的图形用户界面（GUI）。

java.net--包含执行与网络相关的操作的类。

java.io--包含能提供多种输入/输出功能的类。

java.util--包含一些使用工具类，如定义系统特性、使用如日期日历相关的函数。

如何生成自己项目的API文档：

特殊的注释：

文档注释：/**

使用JAVADOC生成API文档

解决问题：代码和文档的分离

常用的java注释标签：

@author 作者 //类注释

@ersion 版本 //类注释

@param 参数 //方法注释

@return 返回值的含义 //方法注释

@throws 抛出异常描述 //方法注释

@deprecated 废弃，建议用户不再使用该方法 //方法注释

在eclipse中创建api文档的步骤

1.右键单机项目，选中export