Java编程那些事儿系列文章(全集目录)
第九章 JDK文档使用
前面提到过,一个程序设计语言主要包含三个部分:语言的语法、开发工具和一套基础的功能。Java语言的语法以及开发工具JDK前面都已经介绍过了,本章就将介绍Java语言提供的这套基础的功能。
对于任何一个程序设计语言来说,都将提供一套已经编写完成的基础功能,这种和语言一起发布的这套基础功能一般被称作API(Application Programming Interface,应用编程接口),在面向过程的语言中也被称为函数库(Function Library),在面向对象的语言中也被称作类库(Class Library)。
这套功能都会以专门的文档来进行提供,在J2SE开发中,这套文档称之为JDK文档。例如Windows操作系统的基本功能称为Windows API,而和VB、VC开发相关的功能组成的文档称之为MSDN等。
这套功能就是在学习程序设计过程中需要学习的基本开发技术。
9.1 JDK文档概述
JDK文档中包含了JDK中开放给程序员的所有通用类结构的说明,该文档是学习J2SE编程的必备参考资料,该文档由SUN公司以免费的HTML文档的形式进行提供,当然也可以下载到其他人制作的CHM格式的文档。
JDK文档没有随JDK一起发布,如果需要使用该份文档,则需要到SUN公司的网站专门进行下载,最新版本的JDK文档下载地址为:
http://java.sun.com/javase/downloads/?intcmp=1281
选择“Java SE 6 Documentation”项目下载即可。
在06年初,SUN公司组织专人将JDK5.0的文档翻译成了中文,如果英文阅读比较困难,则可以使用中文文档,其下载地址为:
http://gceclub.sun.com.cn/chinese_java_docs.html
说明:建议阅读英文文档,因为这样既可以锻炼英文阅读能力,也可以阅读到最新的文档。
注意:使用的文档的版本最好和使用的JDK的版本匹配。
JDK的文档以网页文件压缩包的形式提供,下载完成以后,只需要解压缩即可,可以根据需要解压缩到任意的路径。
9.2 JDK文档结构
打开JDK文档所在目录下api目录中的index.html即可打开文档结构,打开以后的界面如下图所示:
JDK API文档图
在该文档中,页面的左上角区域显示JDK API中所有包名的列表,右下角区域默认显示所有类结构,如果选择对应的包名,则只显示该包中的接口、类、异常和错误等信息。页面右侧区域显示详细信息,当选择对应的类时,则显示该类的详细信息。
例如选择java.lang包中的String类时,显示的界面如下图:
String类的文档结构
在类的文档中主要包含以下几部分内容:类的继承和被继承关系,类的声明、类的功能说明、属性列表、构造方法列表和方法列表等。类内部结构中的属性、构造方法和方法每个都包含一个超链接,通过点击该链接可以查看更详细的说明。