* 介绍

      迄今为止,我们知道 CLDC 比较适合 J2ME,并且也已经建立了我们的开发环境。在这一章中,我们将更深入地探索 CLDC API。CLDC API 实际上只是 J2SE 的一个子集,它包括 java.lang、java.io 和 java.util,另加一个新软件包 -- javax.microedition。我们将逐个来研究这些软件包,并突出显示每一个包中的重要的类。

      尽管每一个类都在 J2SE 中,但是没有必要让每一个类的 CLDC 实现都能实现 J2SE 支持的所有方法。您可以检查 CLDC API 文档以确认哪些方法是受支持的。文档的副本位于安装 J2ME CLDC 时创建的 j2me_cldc/docs 目录下。它提供 PDF 和 javadoc 两种格式。

 

    * java.lang

      CLDC java.lang 软件包是 J2SE java.lang 软件包的一个子集。与 J2SE 相比,它最引人注目的可能便是冗长的浮点操作了,特别是浮点 (Float) 和双精度 (Double) 类。如果使用浮点的话,这些冗余将涉及到所有其它的类。

      相对于 J2SE v1.3 API,CLDC API 中删去了几个其它的类。其中包括 ClassLoader、Compiler、InheritableThreadLocal、Number、Package、Process、 RuntimePermission、SecurityManager、StrictMath、ThreadGroup、ThreadLocal 和 Void。

      我们描述了可从下面几页表中的 CLDC java.lang 软件包中获取的主要的类。Java 开发人员对所有这些类的使用都应该是非常熟悉了。

      除这些核心类之外,您还将看到 CLDC 支持的 Runnable 接口,正象 Exception 、Error 和其它有关的类一样。

 

    * java.lang 核心运行时类

      java.lang 软件包的核心运行时类有:

      · Class -- 显示正在运行的 Java 应用程序中的类和接口。

      · Object -- 与在 J2SE 中相同,Object 是所有 Java 对象的基本类。

      · Runtime -- 为 Java 应用程序提供一种与运行时环境(Java 应用程序在其中运行)进行交互的方法。

      · System -- 提供一些静态的帮助方法,就像为 J2SE 提供方法一样。

      · Thread -- 定义 Java 程序的一个执行线程。

      · Throwable -- Java 语言中所有错误和异常的超级类。

 

    * java.lang 核心数据类型类

      java.lang 软件包中的核心数据类型类有:

      · Boolean -- 包装 boolean 原始数据类型。

      · Byte —- 包装 byte 原始数据类型。

      · Character -- 包装 char 原始数据类型。

      · Integer -- 包装 int 原始数据类型。

      · Long -- 包装 long 原始数据类型。

      · Short -- 包装 short 原始数据类型。

 

    * java.lang 帮助类

      java.lang 软件包的帮助类有:

      · Math -- 包含执行基本数学运算的方法。请注意,所有执行浮点值运算的方法都被省略了,仅保留了关于 integers 和 longs 的方法:abs()、min() 和 max()。

      · String -- 在 Java 中代表对象 String,就像在 J2SE 中一样。

      · StringBuffer -- 代表一个可以修改的串,就像在 J2SE 中一样。

 

    * java.io 输入类

      CLDC API 包含许多 J2SE 中共同使用的输入类。特别地,CLDC java.io 软件包中包括下面一些类:

      · ByteArrayInputStream -- 包含一个内部缓冲器,它代表可能从输入流中读取的字节。

      · DataInput -- 一个接口,从二进制输入流提供字节以供读取并把它们转换成原始 Java 数据类型。DataInputStream 提供该接口的实现。

      · DataInputStream -- 允许应用程序以独立于平台的方式从基层输入流中读取原始 Java 数据类型。

      · InputStream -- 一个抽象类,它是所有代表字节输入流的类的超级类。

      · InputStreamReader -- 读取字节并把它们按照指定的字符编码方法转换成字符。

      · Reader -- 一种读取字符流的抽象类。

      注意:其中一些类可能不包含 J2SE 姊妹版支持的所有方法,就像在 java.lang 软件包中一样。尤其是省略了浮点和双精度方法。

 

    * java.io 输出类

      CLDC API 包含了许多 J2SE 中的共同使用的输出类。特别是,CLDC java.io 软件包中包括下面一些输出类:

      · ByteArrayOutputStream -- 实现一个输出流,在此输出流中数据被写入字节数组。

      · DataOutput -- 一种接口,提供原始 Java 数据类型以供写入二进制输出流。DataOutputStream 提供该接口的实现。

      · DataOutputStream -- 一个输出流,允许应用程序以一种便捷的方式编写原始 Java 数据类型。

      · OutputStream -- 一个抽象类,它是所有代表字节输出流的类的超级类。

      · OutputStreamReader -- 给出字符,并按指定的字符编码方法将其转换为字节。

      · PrintStream -- 添加一种便捷的方法来打印数据值的文本表现形式。

      · Writer -- 编写字符流的一个抽象类。

      其中一些类可能不包含 J2SE 支持的所有方法,比如浮点和双精度方法。

 

    * java.util 收集类

      CLDC java.util 软件包中包含 J2SE java.util 软件包中最常用的类。这些类中包括四个收集类(实际是三个收集类和一个接口),以及日期/时间和实用程序类。

      CLDC 支持的 java.util 收集类有:

      · Enumeration -- 一个接口,通过项目集允许对例程进行重复调用。

      · Hashtable -- 实现 hashtable,将键映射到值。

      · Stack -- 代表了一个后进先出 (LIFO) 的对象集合或堆栈。

      · Vector -- 代表可以调整大小的对象“数组”或者矢量。

 

    * java.util -- 其它的类

      CLDC 支持的 java.util 类中其余部分包括日期和时间类,以及 Random 实用程序类。下表中简要列出了这些类。

      · Calendar -- 一个抽象类,使用一套整型字段如 YEAR、MONTH、 DAY 等来获取和设置日期。

      · Date -- 代表特定的时间和日期,精确到毫秒级。

      · Random -- 一个实用程序类,用来生成 int 或 long 的随机值流。

      · TimeZone -- 代表时区的偏移量,也用于校正时间。

 

    * javax.microedition.io

      迄今为止,我们在 CLDC API 中看到的所有的类都是 J2SE API 的子类。CLDC 还包含一个附加的软件包 -- javax.microedition.io。

      在这个包里唯一被定义的类就是 Connector 类,也称为工厂类,包含创建 Connection 对象或输入、输出流的方法。

      当动态识别一个类的名字时,Connection 对象就被创建了。类名称的识别基于平台名称和被请求连接的协议。描述目标对象的参数串应该满足 RFC 2396 规范所要求的格式。请使用下列格式:

      {scheme}:[{target}][{params}]

      {scheme} 是一个协议的名称,如 http 或 ftp。{target} 通常是一个网络地址,但是面向非网络的协议则可能把它当作一个相当灵活的字段来处理。还有一些参数,如 {params} 被指定为一系列形如 ";x=y" 的分配形式(例如,;myParam=value)。

 

    * javax.microedition.io 帮助接口

      除类属连接工厂类之外,javax.microedition.io 软件包中还包含下列面向连接的接口:

      · Connection -- 定义了最基本的连接类型。这个接口也是此软件包中所有其它连接接口的基本类。

      · ContentConnection -- 定义了一个可以通过内容的流连接。

      · Datagram -- 定义了一个类属数据报接口。

      · DatagramConnection -- 定义了类属数据报连接和它必须支持的性能。

      · InputConnection -- 定义了一个类属输入流连接和它必须支持的性能。

      · OutputConnection -- 定义了一个类属输出流连接和它必须支持的性能。

      · StreamConnection -- 定义了一个类属流连接和它必须支持的性能。

      · StreamConnectionNotifier -- 定义了一个流连接的通告程序必须具有的性能。