Java常用类 -- API的使用

首先我们了解一下什么是API。API的全称是（Application Programming Interface），简单的理解就是应用程序的编程接口，java API文档是每个java开发程序员必备的编程词典，里面记录了java语言中的海量API，包括类的继承结构、成员变量和成员方法、构造方法、静态成员的详细说明和描述信息。

在编写程序的时候，通常有很多功能是通用的，或者是很基础的，可以用这些功能来组成更发杂的功能代码。比如文件操作，不同程序对文件的操作基本都是一样的，打开文件，关闭文件，读取文件里面的数据，往文件中写数据等等。所不同的仅仅是文件路径不相同，文件内容不同。如果把文件相关的操作编写成一个通用的类，不管哪个程序员都可以直接使用，而不必自己重新编写一遍操作文件的所有代码，那么程序员的工作效率就会大大提高。像这样把一些具有通用的功能编写成相应的类代码，就形成了类库。

Java 的类库是 Java 语言提供的已经实现的标准类的集合，是 Java 编程的 API（Application Program Interface），它可以帮助开发者方便、快捷地开发 Java 程序。程序员在开发程序的时候，直接调用这些现成的类就可以了。这些类根据实现的功能不同，可以划分为不同的集合，每个集合组成一个包，称为类库。Java 类库中大部分都是由Sun 公司提供的，这些类库称为基础类库。

使用Java类库

使用Java类库（或Java API）的方法是使用import语句，即在 java 源文件中 import语句应位于 package 语句之后，所有类的定义之前，可以没有，也可以有多条。import导入包有两种语法形式：

单类型导入(single-type-import)， 例如 import java.io.File;

按需类型导入(type-import-on-demand)，例如 import java.io.*;

对于按需类型导入( import java.io.*; )，有人误解为导入一个包下的所有类，其实不然，看名字就知道，他只会按需导入，也就是说它并非导入整个包，而仅仅导入当前类需要使用的类。

那么以上两种import程序包的方法是否一样呢？不一样！单类型导入和按需类型导入对类文件的定位算法是不一样的，具体说明请读者自己查找相关资料了解。

查看JDK的源代码就知道SUN的软件工程师一般不会使用按需类型导入。因为使用单类型导入至少有以下两点好处：

1。提高编译速度。

2。避免命名冲突。（例如：当你import java.awt.*;import java.util.*后，使用List的时候编译器将会出编译错误）

当然，使用单类型导入会使用你的import语句看起来很长。

如何使用

官方提供的文档是英文版的，英语底子不是很好的朋友可能看起来有点费劲，而中文版的确方便了很多。固然是好，但就是有一点不是很权威，翻译成的文档比较生硬，理解起来很难受，所以有时还需要中英结合着看。这里我们以中文版API_1.6为例演示：

API其实就是一个文档，只不过不是我们常用的.txt或.doc为后缀的文档，所以可以直接打开：

点击左上角显示

这样就可以 键入关键字查找：比如我们查找Time类，输入Time，回车，选择 显示：

得到Time类的所有信息

当然包括类的详解、构造方法、普通方法、继承的父类以及方法、实现的接口：

选择我们可能会用到的方法，查看他的详细解析，如，这个方法可以实现的功能，语法，返回值类型，是否有static修饰都可以查看

拓展-什么是程序包

包是一种概念，用来组织类。我们可以借助“行政区划”这个概念来帮助理解程序包。一个国家分很多省，省内又分很多市，还可以继续往下细分更多行政单位。这些行政单位界定了一个区域和这片区域上的所有人和物。程序包就相当于行政区划，行政区划里的人和物就相当于程序包里面的类。所以行政区划是一种抽象的概念。包和行政区划一样，都是一个抽象的概念。包里面还可以包含子包。如：com.myJava.utils这样的一个包名，就好比广东省.广州市.天河区。

需注意：

(1) package 前面还不能有空格。包声明应该在源文件的第一行，每个源文件只能有一个包声明（即只有一条package声明语句），这个文件中的每个类型都属于该包。

(2) 包名的命名规范，一般全部小写，Java要求包要有域名前缀，用来区分不同的作者，同时是域名的反写，如com.google.guava.guava-parent。

(3) 包的命名通常和代码文件的存储位置相关联。如上述Something.java文件的保存路径是 net/java/util/Something.java。因为Something.java文件中声明的包名是net.java.util

(4) 如果一个源文件中没有使用包声明，那么该类会被编译器认为放在一个默认的没有名称的默认包中。尽管默认包对于短的例子程序很好用，但对于实际的应用程序它是不适当的。多数情况，需要为自己的代码定义一个包。

 

 

 

转载于:https://my.oschina.net/u/4108101/blog/3044098