Java编程那些事儿73——JDK文档使用

 

第九章 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类的文档结构

         在类的文档中主要包含以下几部分内容：类的继承和被继承关系，类的声明、类的功能说明、属性列表、构造方法列表和方法列表等。类内部结构中的属性、构造方法和方法每个都包含一个超链接，通过点击该链接可以查看更详细的说明。

9.3 类和接口使用语法

         在JDK文档中，可以很方便的查阅到每个类的作用和类内部的结构，如构造方法、属性和方法等，在实际的开发过程中，则需要根据项目的要求使用对应类。

         具体该使用哪个类或接口，以及如何使用类或接口，这些是开发技术的要求，本部分只是总结一下和类和接口使用相关的语法知识。

         无论使用类还是接口，首先需要引入该结构，使用的语法格式为：

                   import 包名.类名|*;

         说明：这里的“|”表示或者的关系。

         注意：java.lang包中的类和接口，系统会自动引入，所以该包中的类和接口无需引用即可使用。

9.3.1 类使用语法

         对于从JDK文档中查阅出的类，使用的方法一般只有三种：继承该类、使用该类的对象和调用该类中的静态属性或静态方法。下面一一介绍这三种使用方式相关的语法。

9.3.1.1继承类的语法

         如果以继承的方式使用JDK文档中提供的类，则对应的语法格式如下：

         1、构造方法

首先需要说明的是，构造方法不被继承。也就是说子类中的构造方法和父类中的构造方法的参数列表没有关联。

如果被继承的类，也就是JDK文档中提供的类，有默认的构造方法(也就是无参数的构造方法)，则子类的构造方法内部会自动调用，不需要编写特殊的代码。

如果被继承的类中没有默认的构造方法，则必须在子类中书写构造方法，而且需要在子类的构造方法中的第一行使用super关键字调用父类中对应的构造方法，在使用super调用时也必须传入对应的参数。

如果父类中没有提供public或protected修饰的构造方法，则该类不能被继承。

         2、属性和方法

继承了一个类以后，该类中的所有属性和方法都被继承下来，在子类中可以像使用自己声明的属性和方法一样使用这些结构。

说明：在JDK文档中只将被覆盖的方法单独列举在文档中，未被覆盖的属性和方法则显示在属性和方法列表的下面。

         最后一个和继承有关的语法是，如果继承的类是抽象类，则必须覆盖父类中的抽象方法，否则声明的类则必须声明为抽象类。

9.3.1.2使用类的对象

         如果通过创建对象对类进行使用，这种方式是最常用的方式，则相关的语法格式如下：

         1、构造方法

                   首先声明对象，然后使用new关键字和构造方法来创建对象。当构造方法比较多时，根据需要调用合适参数列表的构造方法，调用时仔细阅读参数列表即可。

                   格式为：

                            类名 对象名 = new 构造方法(参数);

         2、属性和方法

                   当对象创建完成以后，则可以通过该对象调用类提供的属性和方法了。

                   调用属性和方法的语法格式为：

                            对象名.属性  或  对象名.方法(参数)

9.3.1.3调用类的静态属性和静态方法

         调用类中的静态属性和静态方法，语法中提供了简单的格式：

                            类名.静态属性名     和     类名.静态方法名(参数)

         注意：对于类内部的静态属性和静态方法，不推荐使用对象名.静态属性名和对象名.静态方法名进行调用。

9.3.2 接口使用语法

         对于JDK文档中提供的接口，其使用方式一般有两种：声明该接口的对象、实现该接口和继承接口。接口的使用比类要简单一些，下面一一介绍相关的语法格式。

9.3.2.1 声明接口对象

         对于一部分接口，需要声明一个接口对象，然后使用JDK中提供的方法或对应的子类构造方法进行创建，但是需要首先声明接口的对象。

         语法格式为：

                   接口名 对象名;

9.3.2.2 实现接口

         另外一种更常见的使用接口的方式是声明一个类实现接口，一个类可以实现任意多个接口，使用implements关键字实现，如果接口中包含抽象方法，则必须覆盖抽象方法，否则必须声明为抽象类。

9.3.2.3 继承接口

         也可以声明一个接口，继承JDK文档中已有的接口，接口继承接口支持多重继承，使用extends关键字继承即可。