Java API

  Java语言的强大功能主要体现在Java语言完备丰富、功能强大的Java API上。本章介绍Java API的基本结构以及语言包和实用包中的常用类。

1、Java API 综述 

  Java语言的内核非常小，Java语言的强大功能主要体现在Java语言完备丰富、功能强大的Java API上。
  Java API（Java Application Programming Interface，Java应用程序接口），是Java语言提供的组织成包结构的许多类和接口的集合。Java API为用户编写应用程序提供了极大的便利。Java API包含在JDK中，因此用户只要按照1.3节介绍的方法安装了JDK运行环境就可以使用了。
Java API按照内容分别组织和存放在不同的包中，Java API中的包及其主要功能按字母顺序说明如下：
  java.accessibility 接口组件和助手技术的类和接口
  java.applet Applet所需的类和接口
  java.awt 图形用户界面所需的类和接口
  java.beans Java bean所需的类和接口
  java.io 系统输入/输出所需的类和接口
  java.lang Java语言编程的基础类和接口
  java.math 支持任意精度整数和任意精度小数的类和接口
  java.naming 访问命名服务的类和接口
  java.net 网络应用的类和接口
  java.rmi 远程调用（RMI）的类和接口
  java.security 用于安全框架的类和接口
  java.sql 访问和处理数据源中数据的类和接口
  java.text 支持按与语言无关方式处理文本、数据、数字和消息的类和接口
  java.util 集合框架、事件模型、日期和时间机制、国际化等的类和接口
  javax.rmi 支持RMI-IIOP的类和接口
  javax.serverlet 支持serverlet编程的类和接口
  javax.sound 支持音频设备数字接口（MIDI）的类和接口
  javax.swing 扩充和增强基本图形用户界面功能的类和接口
  javax.transaction 包含有几个关于事务上下文异常的类 
  org.omg.CORBA 支持OMG CORBA API到Java语言映射的类和接口 

  上述大部分的包都又按内容组织成子包形式，关于各包的子包这里就不再赘述。
  Java语言在不断发展，这表现在JDK运行环境的版本在不断提高。因此，读者学习本书时，可能Java API中又包含了新的包，或某些包中又增加了新的子包。
打开JDK的帮助文档，可以看到Java API的详细说明文档。
  Java API包含的内容很多，本章主要讨论其中两个最基本的包中的主要类：
    (1)语言包（java.lang）。主要讨论的类有：Object类、Class类、Runtime类、Float类、String类和Math类。
    (2)实用包（java.util）。主要讨论的类和接口有：Arrays类、Vector 类、Data 类和Enumeration接口。

2、语言包（java.lang）简介 

  java.lang包中包含了Java程序设计语言最基础的类。本节讨论的java.lang包中的类有Object类、System类、Class类、Runtime类、String类、Math类和Float类。
  java.lang包是Java语言编程使用最频繁的包。为了简化编程，系统固定地默认导入了java.lang包，所以使用java.lang包中的类时可以不用import语句导入。

1、Object类 

  Object类是Java中所有类的根，所有其他的类都是由Object类派生出来的，因此，根据继承的特点，在Object类中定义的成员变量和方法，在其他类中都可以使用。
  Object类常用方法有：
   equals(Object obj) 比较两个对象是否相等
   getClass() 获取对象的运行时类
   toString() 把对象转换为字符串

  Object类中还有一组关于线程同步的方法：wait()方法和notify()方法。
  equals(Object obj)方法与Java运算符"=="的含义相同，但用法不同。当两个值比较、对象或变量与值比较、两个变量比较时，使用运算符"=="；当比较两个对象时，使用equals()方法。该方法调用返回true时表示两个对象相等（或称相同），返回false时表示两个对象不相等。

<pre name="code" class="java">public class EqualsTest{public static void main(String args[]){char ch='A';if ((ch=='A') || (ch=='a')) //变量与值比较System.out.println("true");String str1="abc",str2=null;if (str1!=null) //对象与值比较System.out.println(str1.equals(str2)); //两个对象比较}}

程序运行显示结果如下：
true
false

 

2、System类 

  System类提供了许多获取或重新设置系统资源的静态方法。
  System类的常用方法有：
   static Properties getProperty() 获取系统属性
   static Properties getProperty(String key) 获取由key指定的系统属性
   static void setProperty(Properties props) 设置由props指定的系统属性
   static void load(String fileName) 加载本地文件系统中由文件名fileName指定的动态库
   static void exit(int status) 中断当前运行的Java虚拟机，status为状态码，非0的状态码表示不正常中断

  其中，获取系统属性方法的返回值类型为Properties，Properties是java语言包中定义的一个类。该类定义了系统属性集合，每个属性用字符串表示，其常用的几个属性值以及含义如下：
   java.version java运行时环境版本
   java.vm.version java虚拟机实现的版本
   java.class.path java类的路径
   os.version 操作系统的版本
   user.name 用户名
   user.dir 用户路径
   user.home 用户HOME路径

 

public class SystemTest{public static void main(String args[]){String str;//java运行时环境版本str = System.getProperty("java.version"); System.out.println("java.version: " + str);//java虚拟机实现的版本str = System.getProperty("java.vm.version"); System.out.println("java.vm.version: " + str);//java类的路径str = System.getProperty("java.class.path"); System.out.println("java.class.path: " + str);//操作系统的版本str = System.getProperty("os.version"); System.out.println("os.version: " + str);//用户名str = System.getProperty("user.name"); System.out.println("user.name: " + str);//用户路径str = System.getProperty("user.dir"); System.out.println("user.dir: " + str);//用户HOME路径str = System.getProperty("user.home"); System.out.println("user.home: " + str);}}

程序的运行结果为：
java.version: 1.4.1_02
java.vm.version: 1.4.1_02-b06
java.class.path: D:\JBuilder9\jdk1.4\lib;D:\;.;
os.version: 5.0
user.name: administrator
user.dir: E:\Java\chapt5
user.home: C:\Documents and Settings\Administrator.ZXB 
另外，System类中定义了三个和输入输出流有关的静态成员变量in、out和err。

3、Class类

  Class类的实例代表一个正在运行的Java应用程序的类或接口。Java的基本数据类型（boolean，byte，char，shart，int，long，float，double）以及数组和关键字void都是由Class对象来表达。
  Class类没有公共的构造方法，Class对象由Java虚拟机自动构造。
  Class类的常用方法有：
    String static getName() 返回对象的类名
    class static forName(String ClassName) 使用ClassName指定的、与类或接口相联系的class对象
    class static forName(String name，boolean initialize，ClassLoader loader) 使用loader指定的类装载器Class类的forName()方法可用于安装驱动程序。 

  例如，安装JDBC-ODBC驱动程序，可以使用下面语句：
     Class.forName("sun.jdbc.odbc.JdbcOdcDriver");
  要安装Oracle Jdbc驱动程序，可以使用下面语句：
     Class.forName("oracle.jdbc.driver.OracleDriver");

4、Runtime类 

  每一个Java应用程序都有一个Runtime类的实例，从而允许应用程序与其运行的环境进行交互。可利用Runtime类直接访问运行时环境资源。
  Runtime类常用方法有：
    static Runtime getRuntime() 返回与当前应用程序相联系的运行时环境
    void exit(int status) 中断当前运行的Java虚拟机，status为状态码，非0的状态码表示不正常中断
    native void traceInstructions(Boolean on) 设置对指令的追踪，如果参数on为 true，则Java虚拟机对于其上执行的每一条指令都发出调试信息
    native void traceMethodCalls(Boolean on) 设置对调用方法的追踪，如果参数on为 true，则支持指令的追踪
    totalMemory() 返回系统的内存总数
    freeMemory() 返回系统当前内存的剩余空间总数
    gc () 运行垃圾回收程序

public class RuntimeTest{public static void main(String args[]){Runtime rtime = Runtime.getRuntime();long totalMemory = rtime.totalMemory()/1024;long freeMemory = rtime.freeMemory()/1024; System.out.println("totalMemory: " + totalMemory + "k"); System.out.println("freeMemory: " + freeMemory+ "k"); }}

程序运行结果为：
totalMemory: 1984k
freeMemory: 1734k 

5、Float类 

  为了方便学习过C语言的人员学习Java语言，Java语言也像C语言一样，有数据类型的概念。但数据类型与类不等同。Java是一种纯面向对象程序设计语言，为了达到这个目标，语言包中提供了8个称为数据类型包装类的类，专门完成把Java语言的8个基本数据类型包装为相应的类。
Java语言中的8种基本数据类型是：byte、short、int、long、float、double、char、boolean，对应的8个数据类型包装是：Byte、Short、Integer、Long、Float、Double、Character、Boolean。这里仅介绍Float类，其余的相似。

  Float类的几个构造方法如下：
    Float (double value) 以double类型的参数value创建一个对象
    Float (float value) 以float类型的参数value创建一个对象
    Float (String s) 以String类型的参数s创建一个对象
  Float类的几个方法如下：
   compareTo(Float anotherF) 比较两个对象的大小，大于返回1，相等返回0，小于返回-1
   floatValue() 返回对象的float数据类型的数值
   doubleValue() 返回对象的double数据类型的数值
   intValue() 返回对象的int数据类型的数值，小数部分丢掉

6、String类 

  我们说过，定义字符串变量所使用的String不是一个基本数据类型，而是Java API中提供的类。
  String类的构造方法和常用方法有：
   String() 构造方法，初始化创建一个字符为空的String对象
   String(byte[] bytes) 构造方法，初始化创建一个string对象，其值由指定bytes转换而来
   compareTo(String anotherString) 比较字符串，返回两者之间的差值
   length() 获取字符串的长度
   substring(int beginIndex) 返回当前字符串的由beginIndex开始到结尾的子串
   substring(int beginIndex，int endIndex) 返回当前字符串的由beginIndex开始到endIndex结尾的子串
   toLowerCase() 返回小写字符串，即返回的对象中所有的字符均为小写字符
   toUpperCase() 返回大写字符串，即返回的对象中所有的字符均为大写字符

public class StringTest{public static void main(String args[]){ System.out.println("abc");String cde = "cde";System.out.println("abc" + cde);String c = "abc";c = c.substring(2,3);System.out.println("c = " + c);String d = cde.substring(1, 2);System.out.println("d = " + d);}}

程序运行显示结果如下：
abc
abccde
c = c
d = d 

7、Math类

  Math类包含了一组基本的数学运算的方法和常数。如求绝对值的abs()方法，计算三角函数的sin()方法和cos()方法，求两个数中的较小值和较大值的min()方法和max()方法，求随机数的random()方法等。Math类中的所有方法都定义为静态的。另外，Math类还把E和PI定义为类的静态成员变量，其中，E和PI代表数学上的相应常数。
  Math类是最终类（final），所以不能从Math类中派生其他的新类。
  Math类的几个常用方法如下：
    double abs(double a) 求a的绝对值
    float abs(float a) 求a的绝对值
    int abs(int a) 求a的绝对值
    long abs(long a) 求a的绝对值
    double random() 返回一个(0.0,1.0)区间的随机数
  abs()方法有4个，包括了4种基本的数值类型（double，float，int，long），其他方法（如sin()方法 等）类同，为节省篇幅，这里不再列出。
random()方法是非常有用的方法。把random()的返回值乘上一个整数，可以得到任意区间的、double类型的随机数；把random()的返回值乘上一个整数再转换成int类型，可以得到任意区间的、int类型的随机数。

public class Exam5_6{public static void main(String args[]){final int SIZE = 10; //常量int i, min;int a[] = new int[SIZE]; for(i = 0; i < a.length; i++)a[i] = (int)(Math.random() * 100); //产生随机数并赋值System.out.print("数组元素为："); //输出一维数组for(i = 0; i < a.length; i++)System.out.print(" " + a[i]); min = a[0]; for(i = 1; i < a.length; i++)if(a[i] < min) min = a[i]; //寻找最小数 System.out.println("\n最小数为：" + min);}}

程序运行结果如下：
数组元素为： 64 99 44 94 28 82 39 19 6 41
最小数为：6 

3、实用包（java.util）简介 

  java.util包主要包含集合框架、事件模型、日期和时间机制、国际化等的类和接口。本节介绍的java.util包的类和接口有Arrays类、Vector类、Data类和Enumeration接口。

1、 Arrays类 

  Arrays类中包含有数组操作的一些常用方法（如排序和查找），这可以大大简化程序设计人员的设计过程。
  Arrays类的常用方法有：
   static void sort(byte[] a)

   把byte类型的数组a中的元素按升序排序
   static void sort(byte[] a，int fromIndex，int toIndex)

   把byte类型的数组a中的、从fromIndex到toIndex的元素按升序排序
   static void sort(int[] a)

   把int类型的数组a中的元素按升序排序
   static void sort(int[] a，int fromIndex，int toIndex)

   把int类型的数组a中的、从fromIndex到toIndex的元素按升序排序
   static void sort(double[] a)

   把double类型的数组a中的元素按升序排序
   static void sort(double[] a，int fromIndex，int toIndex) 

   把double类型的数组a中的、从fromIndex到toIndex的元素按升序排序
   static int binarySearch(byte[] a，byte key)

   在byte类型的数组a 中、使用折半查找算法查找指定元素key是否存在，若存在返回该元素的数组下标；若不存在返回-1

public static void main(String[] args) //java application程序主入口函数，带命令行参数{        int[] a={1,34,5,12,67,90,35,67,12,39};      Arrays.sort(a);  //进行排序      for(int n=0;n<a.length;n++)      {              System.out.print(a[n]+",");      }      System.out.println( "\n"+Arrays.binarySearch(a, 34));      }static int binarySearch(int[] a，int key)

  在int类型的数组a 中、使用折半查找算法查找指定元素key是否存在，若存在返回该元素的数组下标；若不存在返回-1
  static int binarySearch(double[] a，double key)
  在double类型的数组a 中、使用折半查找算法查找指定元素key是否存在，若存在返回该元素的数组下标；若不存在返回-1 

说明：

  (1)除了上面列出的sort()方法和binarySearch()外，还有char、float、long、Object等类型的sort()方法和binarySearch()，这里不再列出。
  (2)在使用binarySearch()时，要求数组a中的元素已经有序排列，否则返回值未定义。

2、Vector 类 

  Vector类称作向量类，它实现了动态的数组，使用于元素数量变化的对象数组。像数组一样，Vector类也用从0开始的下标表示元素的位置；但和数组不同的是，当Vector对象创建后，数组的元素个数会随着Vector对象元素个数的增大和缩小变化。
  Vector类的成员变量有：
   elementData 存放对象元素的数组
   elementCount 当前对象元素的个数
   capacityIncreament 元素个数变大时自动增大数组空间的个数 
  Vector类的构造方法有：
   Vector ()
   创建元素为空的对象，且elementCount=10，capacityIncreament=0
   Vector (int initialC)
   创建元素为空的对象，且elementCount= initialC，capacityIncreament=0
   Vector (int initialC，int capacityI)
   创建元素为空的对象，且elementCount= initialC，capacityIncreament= capacityI 
  Vector类的常用方法有：
   void add( int index，Object elem)
   在Vector对象的index下标处插入元素elem，index下标以后的元素依次后移
   boolean add(Object elem)
   在Vector对象的尾部添加元素elem，添加成功返回true，失败返回false
   boolean addAll(Collection c)
   在Vector对象的尾部、依次添加集合对象c中的所有元素，添加成功返回true，失败返回false
   void addElement(Object obj)
   在Vector对象的尾部、增加对象obj，且对象的元素个数加1
   boolean removeElement(Object obj)
   如果对象非空，则删除Vector对象obj第一次出现的元素
   copyInto(Object[] anArray)
   把Vector对象指针所指位置的成分复制给数组anArray，要求数组anArray要足够大，否则会抛出异常
   Enumeration elements()

   返回对象的序列化元素
   int size()

   返回对象的元素个数 
   和Arrays类相比，Vector类的最主要特点是长度可随对象成分个数的增加或减少任意变化。

3、Data 类和Calendar类 

  Data 类提供了获取当前精确到毫秒时间的方法，并提供了许多方法截取当前时间的年、月、日等数值。
  Data 类的构造方法有：
   Data () 创建一个可精确到毫秒的当前时间的对象
   Data (long date) 创建一个可精确到毫秒的参数date指定时间的对象，date表示从GMT（格林威治）时间1970-1-1 00:00:00开始至某时刻的毫秒数。

   Calendar类定义了许多如YEAR、MONTH、DAY、HOUR、MINUTE、SECOND、DAY_OF_WEEK等成员变量，Calendar类的get()方法可以获取这些成员变量的数值。 

4、Enumeration接口 

  Enumeration接口主要用于集合类对象的序列化。一个集合类对象中包含有许多元素，所谓对象是序列化的，就是说可以依次取出该对象中的元素。
  Enumeration接口定义如下：

public interface Enumeration {Object nextElement(); //返回后续元素boolean hasMoreElements(); //是否还有后续元素} 

  nextElement()方法返回后续元素；hasMoreElements()方法判断是否还有后续元素。
任何一个类，只要实现了Enumeration接口，其对象就是序列化的。所谓对象是序列化的，就是说若连续调用nextElement()方法，每次将返回该集合对象当前元素的后续元素。
  例如，Vector类是一个集合类，Vector类就实现了Enumeration接口。因此，若要输出一个Vector类的对象v中的所有元素，就可以编写如下代码：

Enumeration e = v.elements();while (e.hasMoreElements()) {System.out.println(e.nextElement());}

4、综合应用举例 

为了让读者更好地理解Java API的使用方法，本节给出两个简单的Java API的应用例子。

【例5.7】把10个数按从小到大的次序排序。要求：用 Arrays类的sort()方法实现排序。程序设计如下：import java.util.*;public class Exam5_7{public static void main(String args[]) {final int SIZE = 10; //常量int i, min;int a[] = new int[SIZE]; for(i = 0; i < a.length; i++)a[i] = (int)(Math.random() * 100); //产生随机数并赋值System.out.println("排序前数组元素为："); for(i = 0; i < a.length; i++)System.out.print(a[i] + " "); Arrays.sort(a); //排序 System.out.println("\n排序后数组元素为："); for(i = 0; i < a.length; i++)System.out.print(a[i] + " ");}}程序运行结果如下：排序前数组元素为：40 96 31 20 85 58 40 89 18 18排序后数组元素为：18 18 20 31 40 40 58 85 89 96 【例5.8】使用Vector类和Integer类求解约瑟夫环问题。约瑟夫环（Josephus）问题：古代某法官要判决N个犯人的死刑，他有一条荒唐的法律，将犯人站成一个圆圈，从第S个人开始数起，每数到第D个犯人，就拉出来处决，然后再数D个，数到的人再处决，……，直到剩下的最后一个可赦免。当N=5，S=0，D=2时，约瑟夫环问题执行过程示意图如下图所示。设计：1.初始化，创建一个Vector类的向量对象v，调用v的add()方法依次将N个人的序号添加到v中。由于v的元素类型为Object，所以add()的参数必须使用new Integer(i+1)将int值转化为Integer对象。2.设current为当前欲删除元素的下标，如果从第1个人开始数起，则current的初值应该设置为第1个人的前一个位置，即current=S－1。3.循环，当v中元素多于一个时（v.size()>0），调用v.remove()方法删除下标为current的元素。current的值一直在增加，但既不能超出数组下标范围，又要实现环形结构，所以current的变化规律是current=(current + 1) % v.size()，其中v.size()是v的实际元素个数，每删除一个元素，v.size()的值少1。4.为了更好地了解向量中的元素情况，每次循环都输出了向量中的全部元素值，调用(Integer)v.get(i))方法将获得的下标为i的Object类元素转化为Integer类对象，再调用Integer类的intValue()方法输出相应的int值。5.当循环停止时，向量v中只剩下一个元素，这就是我们要找的最后一个人。程序如下：import java.util.*;public class Josephus //使用Vector类求解约瑟夫环问题{public static void main(String args[]){int n=5,s=0,d=2;Vector v = new Vector(n); //创建向量对象vfor(int i = 0; i < n; i++)v.add(new Integer(i+1)); //向量对象v中添加Integer对象 int current = s - 1; //设置当前元素下标current的初值while (v.size()>1) //向量对象v中多于一个元素时循环 {System.out.print("Vector: ");for(int i = 0; i < v.size(); i++)//输出向量对象v中全部元素值System.out.print(((Integer)v.get(i)).intValue() + " ");int j=0;while (j<d) //计数{current = (current + 1) % v.size();j++;}System.out.println("\tcurrent = " + current + " ");v.remove(current); //删除向量v中下标为current的元素}System.out.println("赦免者是" +((Integer)v.get(0)).intValue());}}程序运行结果如下：Vector: 1 2 3 4 5 current = 1 Vector: 1 3 4 5 current = 3 Vector: 1 3 4 current = 2 Vector: 1 3 current = 0 赦免者是3