第1章BlackBerry API
使用 BlackBerry API 在BlackBerry设备上使用Java 应用程序控制 |
使用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应用程序。
BlackBerry手持设备软件组件
为了查看API 参考。点击任务栏的开始>程序>Research In Motion>BlackBerry JDE 4.1.0>API Java Doc Reference
BlackBerry API
BlackBerry API为访问BlackBerry特性提供了用户界面,本地化,网络,以及其他功能。
BlackBerry API 包 |
描述 |
|
net.rim.blackberry.api.browser |
应用程序可以调用BlackBerry浏览器,为了得到更多信息,参看 BlackBerry 应用程序开发者指南 第二卷:高级。 |
|
net.rim.blackberry.api.invoke |
允许应用程序调用BlackBerry应用程序,如任务,消息,备忘录以及电话。为了得到更多信息,参看 BlackBerry 应用程序开发者指南 第二卷:高级。 |
|
net.rim.blackberry.api.mail |
定义了必要的功能来将内部的RIM消息系统对象组件转化为和Mail API兼容并可移植的对象。同时也提供了发送,接收,以及访问消息的功能。为了得到更多信息,参看 BlackBerry 应用程序开发者指南 第二卷:高级 |
|
net.rim.blackberry.api.mail.event |
定义了消息事件以及监听者(Listener)接口来管理邮件事件。为了得到更多信息,参看 BlackBerry 应用程序开发者指南 第二卷:高级 |
|
net.rim.blackberry.api.menuitem |
允许应用程序在BlackBerry的应用程序例如地址本,日历以及消息中增加客户定制的菜单项,为了得到更多信息,参看 BlackBerry 应用程序开发者指南 第二卷:高级 |
|
net.rim.blackberry.api.options |
允许应用程序在BlackBerry设备的选项中增加选项条目。为了得到更多信息,参看 BlackBerry 应用程序开发者指南 第二卷:高级 |
|
net.rim.blackberry.api.pdap |
允许应用程序和BlackBerry个人信息管理(PIM)交互,PIM包括地址本,任务,日历。MIDP包javax.microedition.pim提供了类似的功能。为了得到更多信息,参看 BlackBerry 应用程序开发者指南 第二卷:高级 |
|
net.rim.blackberry.api.phone |
提供了访问电话应用程序的高级特性。为了得到更多信息,参看 BlackBerry 应用程序开发者指南 第二卷:高级 |
|
net.rim.blackberry.api.phone.phonelogs |
提供了访问电话呼叫历史记录的功能。为了得到更多信息,参看 BlackBerry 应用程序开发者指南 第二卷:高级 |
|
net.rim.device.api.bluetooth |
允许BlackBerry应用程序在一个蓝牙序列端口连接的基础上与打开蓝牙无线技术的设备进行通信。为了得到更多信息,参看103页的“使用蓝牙序列端口连接”. |
|
net.rim.device.api.browser.field |
允许程序在界面上显示浏览器的字段。为了得到更多信息,参看 BlackBerry 应用程序开发者指南 第二卷:高级 |
|
net.rim.device.api.browser.plugin |
允许程序增加额外支持的MIME类型到BlackBerry浏览器上。为了得到更多信息,参看 BlackBerry 应用程序开发者指南 第二卷:高级 |
|
net.rim.device.api.collection net.rim.device.api.collection.util |
为管理数据集合定义了接口和实用类。为了得到更多信息,参看13页的“集合”. |
|
net.rim.device.api.compress |
提供实用类来进行GZip和ZLib数据压缩。<!--[if !supportFootnotes]-->[1]<!--[endif]--> |
|
net.rim.device.api.i18n |
提供类来支持BlackBerry设备上应用程序的本地化。为了得到更多信息,参看13页的“本地化应用程序”. |
|
net.rim.device.api.io |
提供一个定制的BlackBerry类库来管理数据的输入和输出。 |
|
net.rim.device.api.mime |
提供与MIME编码的数据流一起工作的类。 |
|
net.rim.device.api.notification |
提供触发事件的通知以及响应系统以及程序的事件的方法。为了得到更多信息,参看 BlackBerry 应用程序开发者指南 第二卷:高级 |
|
net.rim.device.api.servicebook |
允许程序增加,删除,以及访问服务约定(Service Book)<!--[if !supportFootnotes]-->[2]<!--[endif]-->的接口。为了得到更多信息,参看 BlackBerry 应用程序开发者指南 第二卷:高级 |
|
net.rim.device.api.system |
提供访问系统级的功能,包括键盘和滑轮的事件监听者,图像创建和支持,和应用程序控制。 |
|
net.rim.device.api.ui |
提供增强的功能来控制BlackBerry用户界面,包括屏幕和控件布局管理,控件类型支持,焦点,滚动,以及改变监听者。为了得到更多信息,参看39页的“用户界面API”. |
|
net.rim.device.api.ui.component |
提供了创建UI程序的界面组件库。为了得到更多信息,参看39页的“显示用户界面组件”。 |
|
net.rim.device.api.ui.container |
提供创建UI程序的界面管理组件的库。为了得到更多信息,参看49页的“管理用户界面组件”。 |
|
net.rim.device.api.ui.text |
提供类对文本字符串进行过滤,包含多种类型的数据,例如电话号码或URL。 |
|
net.rim.device.api.util |
提供实用的方法和接口,包含数组,哈希表,字符匹配。 |
CLDC API
CLDC API 包 |
描述 |
java.io |
提供数据流的系统输入和输出。 |
java.lang |
提供Java编程语言基础类。 |
java.lang.ref |
提供引用对象类,它们支持一定程度上的垃圾回收。 |
java.util |
包含集合类,时间,以及多样的实用类。 |
javax.microedition.io |
包含一般连接的类。 |
MIDP API
MIDP API 包 |
描述 |
javax.microedition.lcdui |
包含MIDP 用户界面API,它为MIDP应用程序的用户界面实现提供了一组特性。 |
javax.microedition.lcdui.game |
包含了可以为BlackBerry设备进行丰富游戏内容开发的类。 |
javax.microedition.midlet |
定义了MIDP应用程序以及应用程序和应用程序运行的环境之间的交互。 注:BlackBerry IDE可以在启动时,使参数传递到一个BlackBerry CLDC应用程序中。 |
javax.microedition.pki |
定义了用来验证安全连接信息的证书。 |
javax.microedition.rms |
为MIDlet提供一种机制来存储和取得持久性数据。 |
PDAP API
MIDP API 包 |
描述 |
javax.microedition.pim |
.提供标准机制来访问PIM信息。 |
在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编码的数据流。
类
|