作者:Confach 发表于March 19,200614:59 pm
版权信息:可以任意转载, 转载时请务必以超链接形式标明文章原始出处和作者信息.
http://www.cnblogs.com/confach/articles/353363.html

1

第1章BlackBerry API

使用BlackBerry API

 BlackBerry Java 开发环境（简称JDE）的设计提供了一套完整的API和工具,来开发在BlackBerry设备上运行的Java应用程序。

 BlackBerry设备包含了一个基于CLDC1.1以及MIDP的Java ME（Java Platform Micro Edition）运行时环境。BlackBerry API扩展提供了额外的功能,并且和BlackBerry集成得更紧密。

   你可以在你的应用程序中使用CLDC/MIDP和BlackBerry API。为了能让你的应用程序在任何采用JTWI（Java Technology for Wireless Industry，无线领域的Java技术）的设备上运行，你仅需要使用CLDC和MIDP API来编写标准的MIDP应用程序。

       <!--[if !vml]--><!--[endif]-->

BlackBerry手持设备软件组件

为了查看API 参考。点击任务栏的开始>程序>Research In Motion>BlackBerry JDE 4.1.0>API Java Doc Reference

BlackBerry API

BlackBerry API为访问BlackBerry特性提供了用户界面，本地化，网络，以及其他功能。

  <!--[if !vml]--><!--[endif]-->注：访问某些特性，如高级的加密，同步，以及消息的额外API，是受限制的。为了使用这些API,你必须收到专门来自Research In Motion的认证中心编写的许可。为了得到更多信息，参看 BlackBerry 应用程序开发者指南第一卷：基础 第二卷：高级。

CLDC API

MIDP API

PDAP API

在BlackBerry设备上使用Java

编译源代码，打包为.cod文件，并将.cod文件加载到BlackBerry设备上，通过虚拟机运行。

<!--[if !supportLists]-->        <!--[endif]-->注：.cod文件名控制在128字节。

如CLDC中描述的那样，BlackBerry IDE使用一个分割的VM架构。为了降低内存的数量以及BlackBerry设备需要的处理能力，部分类加载过程，称为预验证，它在Java代码加载到BlackBerry之前发生。在将源代码打包为.cod文件之前，自动验证它。在类加载到BlackBerry设备时完成验证的提示。

限制

在CLDC1.1中描述的那样BlackBerry虚拟机有以下限制：

• 没有对象的析构（finalization）
• 没有用户类的加载
• 没有反射，因此不支持RMI和Jini网络技术。
• 没有原生方法（Native method）
• 没有Runtime.exec()执行外部的进程

多线程

BlackBerry Java环境提供一个真正的多线程环境来运行应用程序。这个环境允许多个应用程序同时运行，允许事件广播到多个应用程序，以及长操作和监听线程在背后运行。

持久数据

存储在闪存中的数据在BlackBerry重新设置之间持久保存。在BlackBerry设备上存储数据可以采用以下二种方式中的一种：

• 使用MIDP记录存储
• 使用BlackBerry持久模型

为了得到关于使用BlackBerry API存储持久数据的更多信息，参看BlackBerry应用程序开发者指南第一卷：基础 第二卷：高级。

网络通信

BlackBerry JDE根据MIDP2.0，实现了网络通信。它提供多种连接选项，包括通过使用HTTP代理连接在公司防火墙背后安全连接的能力。

BlackBerry JDE提供了以下几种连接类型：

• 流连接（StreamConnection接口，包括：

1.         HTTP 连接（HttpConnection接口）

2.         HTTPS连接（HttpsConnection接口）

3.         Socket连接（SocketConnection接口）

4.         安全socket连接（SecureConnection接口）

5.         序列连接到BlackBerry设备的一个通信接口（CoomConnection接口）

• 数据报连接（DtagramConnection接口），包含

1. UDP数据报连接（UDPDatagramConnection接口）

Javax.microedition.io.PushRegistry 类对BlackBerry设备保持了一些进入的连接。

流

 BlackBerry JDE为包含在CLDC java.io包里的流提供了标准的接口和类。

MIME编码

BlackBerry IDE提供了MIMEInputStream和MIMEOutputStream类来读写一个MIME编码的数据流。

压缩

在net.rim.device.api.compress包里，BlackBerry JDE提供类来读取使用Zlib或者GZip格式压缩的数据流。这些类的行为如Java标准版本里的java.util.zip包里对应的类一样。

 缺省的，压缩是允许的，BlackBerry设备可以写有效的GZip和Zlib文件为这样压缩文件的内容。解压缩同样也是支持的。

集合

BlackBerry IDE 提供了一组接口和实用类来管理BlackBerry设备上的集合。

net.rim.device.api.collection包包含了许多接口，这些接口为某些特定类型数据类型多定义了种类型的集合，例如列表，数组以及映射。这些接口定义了与Java标准版本集合框架的list,set和map接口类似的功能。

在你自己的类中实现这些接口，或者使用在net.rim.device.api.collection.util包里提供的使用类。

向量

 标准的java.util.Vector实现了一个大小可以改变的对象数组。BlackBerry JDE也提供了合适的类，例如rim.device.api.util.IntVector和rim.device.api.util.ByteVector来对主要类型进行工作。这些类看起来和普通的Vector一样,除了它们优化了在任何位置上插入的项。相反，如果你使用标准的大Vector作随机的改变，大量的数据会在闪存和RAM移动。

列表

BlackBerry JDE在net.rim.device.api.collection.util包里提供了一些类来管理元素的列表

哈希表

除了CLDC提供的标准java.util.Hashtable 之外，BlackBerry JDE包含了特定的net.rim.device.api.collection.util.LongHashtableCollection类，这个类提供了使用长整形作为关键字的哈希表集合。一个LongHashtableCollection 对象，写操作作为一个映射（使用一个关键字-元素对），读操作作为一个映射或者作为一个集合（在集合里作为一个数组来得到数据）。

事件监听者

事件监听者接口根据事件类型划分。每个应用程序注册来接收特定类型的事件。应用程序事件队列然后调度事件到一个合适的监听者。
应用程序可以实现合适的监听者接口或者在各种Screen对象里重写监听者方法。大多数应用程序实现了KeyListener 和TrackwheelListener 接口，而且注册了监听者来接收键盘和滑轮的事件。键盘和滑轮是用户和应用程序交互的主要方式。

下列的事件监听者放在 net.rim.device.api.system包中

系统功能

net.rim.device.api.system包的类提供了访问Java VM和BlackBerry设备上系统资源的能力。
得到信号信息

RadioInfo提供了访问信号状态信息的能力。
得到设备信息

DeviceInfo类可以访问下列BlackBerry设备的信息：

• <!--[if !supportLists]--><!--[endif]-->电池电源和状态
• <!--[if !supportLists]--> <!--[endif]-->Blackerry设备号
• <!--[if !supportLists]--> <!--[endif]-->空闲时间
• <!--[if !supportLists]--> <!--[endif]-->平台版本

系统事件通知用户

当一个事件，例如一条新消息到来的时候，Alert类允许应用程序通知用户。
监视内存使用情况

使用一个Memory类提供的静态方法来得到VM内存使用统计信息。

Memory类很多实用方法返回一个MemoryStats对象。使用MemoryStats类提供的实用方法得到BlackBerry设备上内存和可用存储空间的详细信息。
日志事件

EventLogger允许应用程序在持久存储里存储事件日志。BlackBerry设备维护事件队列，以至当日志满时，会删除最早的事件，并增加新的事件。用户可以按住Alt+lglg键来查看BlackBerry设备的系统事件日志。

使用工具

BlackBerry JDE在net.rim.device.api.util包里提供了一组实用工具，这些类里的许多类提供了和Java标准版本里相似的功能

• <!--[if !supportLists]-->Comparator接口定义了对象集合上的顺序的方法。
• <!--[if !supportLists]-->Arrays提供方法来操作数组，例如排序，查找，以及作为列表来查看数组。
• <!--[if !supportLists]-->BitSet 类维护bit的集合。

net.rim.device.api.util包包含了多个类来管理特定类型的数据集合，包括向量，哈希表，映射以及栈。

应用程序控制

应用程序控制允许系统管理员操作以下动作：

• <!--[if !supportLists]-->控制内部连接（公司防火墙背后的连接）
• <!--[if !supportLists]-->控制外部连接
• <!--[if !supportLists]-->控制本地连接（序列和USB连接）
• <!--[if !supportLists]-->控制访问键存储(key store)
• <!--[if !supportLists]-->控制访问特殊的API.
• <!--[if !supportLists]--> <!--[endif]-->阻止第三方应用程序存在BlackBerry设备上。

为了得到更多信息，参看BlackBerry Enterprise Server Handheld Management Guide的应用程序管理。

受限制访问的API, 类, 和方法

使用了下列受限的API,类，以及方法的应用程序可以加载到BlackBerry设备，但是如果他们访问了一个没有在应用程序控制下得到允许的API时，在运行时会抛出一个ControlledAccessException或者NoClassDefFoundError的异常。