第六章：CLDC API

第六章：CLDC API

介绍

迄今为止，我们知道 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 -- 定义了一个流连接的通告程序必须具有的性能。