首页 > 编程笔记 > Java笔记

学会使用Java API文档

正如前面所看到的,String 类包含许多方法。 而且, 在标准库中有几千个类, 方法数量更加惊人。要想记住所有的类和方法是一件不太不可能的事情。 因此,学会使用在线 API 文档十分重要,从中可以查阅到标准类库中的所有类和方法。

对于 Java 而言,API 文档详细说明了 Java 中常用类和方法的功能,开发者可以通过查阅 API 文档,调用应用程序接口(API)来编程。

Java 中很多类,每一个类又有很多方法和变量,通过查看 Java API 文档能够知道这些类、方法和变量如何使用。Java 官方为 Java SE 提供了基于 HTML 的 API 文档。作为 Java 程序员应该熟悉如何使用 API 文档。

本节介绍一下如何使用 Java SE 的 API 文档。Java 官方提供了 Java 8 在线 API 文档,网址是 http://docs.oracle.com/javase/8/docs/api/,页面如图 1 所示。

Java 8在线API文档
图 1  Java 8在线API文档

提示:很多读者希望能够有离线的中文 Java API 文档,但 Java 官方只提供了 Java 6 的中文 API 文档,该文件下载地址是 http://download.oracle.com/technetwork/java/javase/6/docs/zh/api.zip,下载完成后解压 api.zip 文件,找到其中的 index.html 文件,双击就会在浏览器中打开 API 文档了。

下面介绍一下如何使用 API 文档,熟悉一下 API 文档页面中的各个部分含义,如图 2 所示,类和接口中,斜文字体显示是接口,正常字体才是类。

API 文档页面各个部分
图 2  API 文档页面各个部分

在类窗口还有很多内容,向下拖曳滚动条会看到如图 3 所示页面,其中“字段摘要”描述了类中的实例变量和静态变量,“构造方法摘要”描述了类中所有构造方法,“方法摘要”描述了类中所有方法。这些“摘要”只是一个概要说明,单击链接可以进入到该主题更加详细的描述,如图 4 所示单击了 compareTo 方法看到的详细信息。

类窗口页面其他内容
图 3  类窗口页面其他内容

compareTo 方法详细描述
图 4  compareTo 方法详细描述

查询 API 的一般流程是:找包→找类或接口→查看类或接口→找方法或变量。读者可以尝试查找一下 String、StringBuffer 和 StringBuilder 这些字符串类的 API 文档,熟悉一下这些类的用法。

所有教程

优秀文章