BlackBerry開發(fā)應(yīng)用程序開發(fā)基礎(chǔ)之BlackBerry API

作者：admin 2010-05-22 16:57:09

BlackBerry開發(fā)的概念你是否了解，本文向大家簡(jiǎn)單介紹一下BlackBerry開發(fā)應(yīng)用程序開發(fā)基礎(chǔ)之BlackBerryAPI，希望本文介紹對(duì)你有所幫助。

本文和大家重點(diǎn)學(xué)習(xí)一下BlackBerry開發(fā)應(yīng)用程序開發(fā)基礎(chǔ)之BlackBerryAPI，主要包括應(yīng)用程序控制，BlackBerry開發(fā)手持設(shè)備軟件組件等內(nèi)容，希望本文的介紹能讓你有所收獲。

在BlackBerry設(shè)備上使用Java

應(yīng)用程序控制

使用BlackBerryAPIBlackBerryJava開發(fā)環(huán)境（簡(jiǎn)稱JDE）的設(shè)計(jì)提供了一套完整的API和工具,來開發(fā)在BlackBerry設(shè)備上運(yùn)行的Java應(yīng)用程序。
BlackBerry設(shè)備包含了一個(gè)基于CLDC1.1以及MIDP的JavaME（JavaPlatformMicroEdition）運(yùn)行時(shí)環(huán)境。BlackBerryAPI擴(kuò)展提供了額外的功能,并且和BlackBerry集成得更緊密。
你可以在你的應(yīng)用程序中使用CLDC/MIDP和BlackBerryAPI。為了能讓你的應(yīng)用程序在任何采用JTWI（JavaTechnologyforWirelessIndustry，無線領(lǐng)域的Java技術(shù)）的設(shè)備上運(yùn)行，你僅需要使用CLDC和MIDPAPI來編寫標(biāo)準(zhǔn)的MIDP應(yīng)用程序。

BlackBerry開發(fā)手持設(shè)備軟件組件

為了查看API參考。點(diǎn)擊任務(wù)欄的開始>程序>ResearchInMotion>BlackBerryJDE4.1.0>APIJavaDocReference
BlackBerryAPI

BlackBerryAPI為訪問BlackBerry特性提供了用戶界面，本地化，網(wǎng)絡(luò)，以及其他功能。
注：訪問某些特性，如高級(jí)的加密，同步，以及消息的額外API，是受限制的。為了使用這些API,你必須收到專門來自ResearchInMotion的認(rèn)證中心編寫的許可。為了得到更多信息，參看BlackBerry應(yīng)用程序開發(fā)者指南第一卷：基礎(chǔ)第二卷：高級(jí)。

BlackBerryAPI包

描述：

net.rim.blackberry.api.browser應(yīng)用程序可以調(diào)用BlackBerry瀏覽器，為了得到更多信息，參看BlackBerry應(yīng)用程序開發(fā)者指南第二卷：高級(jí)。

net.rim.blackberry.api.invoke允許應(yīng)用程序調(diào)用BlackBerry應(yīng)用程序，如任務(wù)，消息，備忘錄以及電話。為了得到更多信息，參看BlackBerry應(yīng)用程序開發(fā)者指南第二卷：高級(jí)。

net.rim.blackberry.api.mail定義了必要的功能來將內(nèi)部的RIM消息系統(tǒng)對(duì)象組件轉(zhuǎn)化為和MailAPI兼容并可移植的對(duì)象。同時(shí)也提供了發(fā)送，接收，以及訪問消息的功能。為了得到更多信息，參看BlackBerry應(yīng)用程序開發(fā)者指南第二卷：高級(jí)

net.rim.blackberry.api.mail.event定義了消息事件以及監(jiān)聽者（Listener）接口來管理郵件事件。為了得到更多信息，參看BlackBerry應(yīng)用程序開發(fā)者指南第二卷：高級(jí)

net.rim.blackberry.api.menuitem允許應(yīng)用程序在BlackBerry的應(yīng)用程序例如地址本，日歷以及消息中增加客戶定制的菜單項(xiàng)，為了得到更多信息，參看BlackBerry應(yīng)用程序開發(fā)者指南第二卷：高級(jí)

net.rim.blackberry.api.options允許應(yīng)用程序在BlackBerry設(shè)備的選項(xiàng)中增加選項(xiàng)條目。為了得到更多信息，參看BlackBerry應(yīng)用程序開發(fā)者指南第二卷：高級(jí)

net.rim.blackberry.api.pdap允許應(yīng)用程序和BlackBerry個(gè)人信息管理（PIM）交互，PIM包括地址本，任務(wù)，日歷。MIDP包javax.microedition.pim提供了類似的功能。為了得到更多信息，參看BlackBerry應(yīng)用程序開發(fā)者指南第二卷：高級(jí)

net.rim.blackberry.api.phone提供了訪問電話應(yīng)用程序的高級(jí)特性。為了得到更多信息，參看BlackBerry應(yīng)用程序開發(fā)者指南第二卷：高級(jí)

net.rim.blackberry.api.phone.phonelogs提供了訪問電話呼叫歷史記錄的功能。為了得到更多信息，參看BlackBerry應(yīng)用程序開發(fā)者指南第二卷：高級(jí)

net.rim.device.api.bluetooth允許BlackBerry應(yīng)用程序在一個(gè)藍(lán)牙序列端口連接的基礎(chǔ)上與打開藍(lán)牙無線技術(shù)的設(shè)備進(jìn)行通信。為了得到更多信息，參看103頁的“使用藍(lán)牙序列端口連接”.

net.rim.device.api.browser.field允許程序在界面上顯示瀏覽器的字段。為了得到更多信息，參看BlackBerry應(yīng)用程序開發(fā)者指南第二卷：高級(jí)

net.rim.device.api.browser.plugin允許程序增加額外支持的MIME類型到BlackBerry瀏覽器上。為了得到更多信息，參看BlackBerry應(yīng)用程序開發(fā)者指南第二卷：高級(jí)

net.rim.device.api.collection
net.rim.device.api.collection.util為管理數(shù)據(jù)集合定義了接口和實(shí)用類。為了得到更多信息，參看13頁的“集合”.

net.rim.device.api.compress提供實(shí)用類來進(jìn)行GZip和ZLib數(shù)據(jù)壓縮。[1]

net.rim.device.api.i18n提供類來支持BlackBerry設(shè)備上應(yīng)用程序的本地化。為了得到更多信息，參看13頁的“本地化應(yīng)用程序”.

net.rim.device.api.io提供一個(gè)定制的BlackBerry類庫來管理數(shù)據(jù)的輸入和輸出。

net.rim.device.api.mime提供與MIME編碼的數(shù)據(jù)流一起工作的類。

net.rim.device.api.notification提供觸發(fā)事件的通知以及響應(yīng)系統(tǒng)以及程序的事件的方法。為了得到更多信息，參看BlackBerry應(yīng)用程序開發(fā)者指南第二卷：高級(jí)

net.rim.device.api.servicebook允許程序增加，刪除，以及訪問服務(wù)約定（ServiceBook）[2]的接口。為了得到更多信息，參看BlackBerry應(yīng)用程序開發(fā)者指南第二卷：高級(jí)

net.rim.device.api.system提供訪問系統(tǒng)級(jí)的功能，包括鍵盤和滑輪的事件監(jiān)聽者，圖像創(chuàng)建和支持，和應(yīng)用程序控制。

net.rim.device.api.ui提供增強(qiáng)的功能來控制BlackBerry用戶界面，包括屏幕和控件布局管理，控件類型支持，焦點(diǎn)，滾動(dòng)，以及改變監(jiān)聽者。為了得到更多信息，參看39頁的“用戶界面API”.

net.rim.device.api.ui.component提供了創(chuàng)建UI程序的界面組件庫。為了得到更多信息，參看39頁的“顯示用戶界面組件”。

net.rim.device.api.ui.container提供創(chuàng)建UI程序的界面管理組件的庫。為了得到更多信息，參看49頁的“管理用戶界面組件”。

net.rim.device.api.ui.text提供類對(duì)文本字符串進(jìn)行過濾，包含多種類型的數(shù)據(jù)，例如電話號(hào)碼或URL。

net.rim.device.api.util提供實(shí)用的方法和接口，包含數(shù)組，哈希表，字符匹配。#p#

CLDCAPICLDCAPI包

描述

java.io提供數(shù)據(jù)流的系統(tǒng)輸入和輸出。

java.lang提供Java編程語言基礎(chǔ)類。

java.lang.ref提供引用對(duì)象類，它們支持一定程度上的垃圾回收。

java.util包含集合類，時(shí)間，以及多樣的實(shí)用類。

javax.microedition.io包含一般連接的類。

BlackBerry開發(fā)中MIDPAPIMIDPAPI包

描述：

javax.microedition.lcdui包含MIDP用戶界面API，它為MIDP應(yīng)用程序的用戶界面實(shí)現(xiàn)提供了一組特性。

javax.microedition.lcdui.game包含了可以為BlackBerry設(shè)備進(jìn)行豐富游戲內(nèi)容開發(fā)的類。

javax.microedition.midlet定義了MIDP應(yīng)用程序以及應(yīng)用程序和應(yīng)用程序運(yùn)行的環(huán)境之間的交互。

注：BlackBerryIDE可以在啟動(dòng)時(shí)，使參數(shù)傳遞到一個(gè)BlackBerryCLDC應(yīng)用程序中。

javax.microedition.pki定義了用來驗(yàn)證安全連接信息的證書。

javax.microedition.rms為MIDlet提供一種機(jī)制來存儲(chǔ)和取得持久性數(shù)據(jù)。

BlackBerry開發(fā)中PDAPAPIMIDPAPI包

描述：

javax.microedition.pim.提供標(biāo)準(zhǔn)機(jī)制來訪問PIM信息。

在BlackBerry設(shè)備上使用Java編譯源代碼，打包為.cod文件，并將.cod文件加載到BlackBerry設(shè)備上，通過虛擬機(jī)運(yùn)行。

注：.cod文件名控制在128字節(jié)。

如CLDC中描述的那樣，BlackBerryIDE使用一個(gè)分割的VM架構(gòu)。為了降低內(nèi)存的數(shù)量以及BlackBerry設(shè)備需要的處理能力，部分類加載過程，稱為預(yù)驗(yàn)證，它在Java代碼加載到BlackBerry之前發(fā)生。在將源代碼打包為.cod文件之前，自動(dòng)驗(yàn)證它。在類加載到BlackBerry設(shè)備時(shí)完成驗(yàn)證的提示。

限制在CLDC1.1中描述的那樣BlackBerry虛擬機(jī)有以下限制：

沒有對(duì)象的析構(gòu)（finalization）
沒有用戶類的加載
沒有反射，因此不支持RMI和Jini網(wǎng)絡(luò)技術(shù)。
沒有原生方法（Nativemethod）
沒有Runtime.exec()執(zhí)行外部的進(jìn)程

多線程BlackBerryJava環(huán)境提供一個(gè)真正的多線程環(huán)境來運(yùn)行應(yīng)用程序。這個(gè)環(huán)境允許多個(gè)應(yīng)用程序同時(shí)運(yùn)行，允許事件廣播到多個(gè)應(yīng)用程序，以及長操作和監(jiān)聽線程在背后運(yùn)行。

持久數(shù)據(jù)存儲(chǔ)在閃存中的數(shù)據(jù)在BlackBerry重新設(shè)置之間持久保存。在BlackBerry設(shè)備上存儲(chǔ)數(shù)據(jù)可以采用以下二種方式中的一種：

使用MIDP記錄存儲(chǔ)
使用BlackBerry持久模型

為了得到關(guān)于使用BlackBerryAPI存儲(chǔ)持久數(shù)據(jù)的更多信息，參看BlackBerry應(yīng)用程序開發(fā)者指南第一卷：基礎(chǔ)第二卷：高級(jí)。

網(wǎng)絡(luò)通信BlackBerryJDE根據(jù)MIDP2.0，實(shí)現(xiàn)了網(wǎng)絡(luò)通信。它提供多種連接選項(xiàng)，包括通過使用HTTP代理連接在公司防火墻背后安全連接的能力。

BlackBerryJDE提供了以下幾種連接類型：

流連接（StreamConnection接口，包括：
1.HTTP連接（HttpConnection接口）

2.HTTPS連接（HttpsConnection接口）

3.Socket連接（SocketConnection接口）

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

5.序列連接到BlackBerry設(shè)備的一個(gè)通信接口（CoomConnection接口）

數(shù)據(jù)報(bào)連接（DtagramConnection接口），包含

1.UDP數(shù)據(jù)報(bào)連接（UDPDatagramConnection接口）

Javax.microedition.io.PushRegistry類對(duì)BlackBerry設(shè)備保持了一些進(jìn)入的連接。

流BlackBerryJDE為包含在CLDCjava.io包里的流提供了標(biāo)準(zhǔn)的接口和類。#p#

BlackBerry開發(fā)中MIME編碼

BlackBerryIDE提供了MIMEInputStream和MIMEOutputStream類來讀寫一個(gè)MIME編碼的數(shù)據(jù)流。

類

描述：

MIMEInputStream
實(shí)現(xiàn)一個(gè)流來讀取一個(gè)MIME消息，然后根據(jù)MIME標(biāo)準(zhǔn)格式化和分解這個(gè)消息為其部分

MIMEOutputStream

實(shí)現(xiàn)一個(gè)輸出流，這個(gè)流可以根據(jù)MIME標(biāo)準(zhǔn)格式化輸出為其部分。本類不會(huì)完成實(shí)際的數(shù)據(jù)編碼，因此你必須在寫入它到本數(shù)據(jù)流治安編碼它。

壓縮

在net.rim.device.api.compress包里，BlackBerryJDE提供類來讀取使用Zlib或者GZip格式壓縮的數(shù)據(jù)流。這些類的行為如Java標(biāo)準(zhǔn)版本里的java.util.zip包里對(duì)應(yīng)的類一樣。

缺省的，壓縮是允許的，BlackBerry設(shè)備可以寫有效的GZip和Zlib文件為這樣壓縮文件的內(nèi)容。解壓縮同樣也是支持的。

集合BlackBerryIDE提供了一組接口和實(shí)用類來管理BlackBerry設(shè)備上的集合。

net.rim.device.api.collection包包含了許多接口，這些接口為某些特定類型數(shù)據(jù)類型多定義了種類型的集合，例如列表，數(shù)組以及映射。這些接口定義了與Java標(biāo)準(zhǔn)版本集合框架的list,set和map接口類似的功能。

在你自己的類中實(shí)現(xiàn)這些接口，或者使用在net.rim.device.api.collection.util包里提供的使用類。

向量

標(biāo)準(zhǔn)的java.util.Vector實(shí)現(xiàn)了一個(gè)大小可以改變的對(duì)象數(shù)組。BlackBerryJDE也提供了合適的類，例如rim.device.api.util.IntVector和rim.device.api.util.ByteVector來對(duì)主要類型進(jìn)行工作。這些類看起來和普通的Vector一樣,除了它們優(yōu)化了在任何位置上插入的項(xiàng)。相反，如果你使用標(biāo)準(zhǔn)的大Vector作隨機(jī)的改變，大量的數(shù)據(jù)會(huì)在閃存和RAM移動(dòng)。

BlackBerry開發(fā)中列表

BlackBerryJDE在net.rim.device.api.collection.util包里提供了一些類來管理元素的列表

類

描述

SortedReadableList和UnsortedReadableList
使用這些類來維護(hù)已排序的和未排序的元素列表。SortedReadableList類需要你使用一個(gè)比較對(duì)象來排序列表中的元素。增加到列表中的每一個(gè)元素必須被比較對(duì)象視為有效的。

IntSortedReadableList和LongSortedReadableList使用這些類自動(dòng)排序整形列表或與長整形關(guān)鍵字相關(guān)的元素。

BigSortedReadableList和BigUnsortedReadableList使用這些類來存儲(chǔ)大的數(shù)據(jù)集合（大于10或者15K).這些類不會(huì)存儲(chǔ)數(shù)據(jù)到一個(gè)數(shù)組中，因此你可以對(duì)大數(shù)據(jù)集合更有效的做出隨意改變。

ReadableListCombiner
使用這個(gè)類合并2個(gè)或者更多的ReadableList對(duì)象并且將他們作為一單個(gè)ReadableList來存儲(chǔ)。

ReadableListUtil此類提供一些有用的方法如getAt()和getIndex()。我們可以使用此類得到只讀列表中的數(shù)。#p#

BlackBerry開發(fā)中哈希表

除了CLDC提供的標(biāo)準(zhǔn)java.util.Hashtable之外，BlackBerryJDE包含了特定的net.rim.device.api.collection.util.LongHashtableCollection類，這個(gè)類提供了使用長整形作為關(guān)鍵字的哈希表集合。一個(gè)LongHashtableCollection對(duì)象，寫操作作為一個(gè)映射（使用一個(gè)關(guān)鍵字-元素對(duì)），讀操作作為一個(gè)映射或者作為一個(gè)集合（在集合里作為一個(gè)數(shù)組來得到數(shù)據(jù)）。

事件監(jiān)聽者事件監(jiān)聽者接口根據(jù)事件類型劃分。每個(gè)應(yīng)用程序注冊(cè)來接收特定類型的事件。應(yīng)用程序事件隊(duì)列然后調(diào)度事件到一個(gè)合適的監(jiān)聽者。

應(yīng)用程序可以實(shí)現(xiàn)合適的監(jiān)聽者接口或者在各種Screen對(duì)象里重寫監(jiān)聽者方法。大多數(shù)應(yīng)用程序?qū)崿F(xiàn)了KeyListener和TrackwheelListener接口，而且注冊(cè)了監(jiān)聽者來接收鍵盤和滑輪的事件。鍵盤和滑輪是用戶和應(yīng)用程序交互的主要方式。

下列的事件監(jiān)聽者放在net.rim.device.api.system包中

監(jiān)聽者接口
事件類型

AlertListener實(shí)現(xiàn)接口來監(jiān)聽alert事件

BluetoothSerialPortListener實(shí)現(xiàn)接口來監(jiān)聽藍(lán)牙序列端口事件，例如打開一個(gè)藍(lán)牙序列端口連接作為服務(wù)器或者客戶端。

GlobalEventListener實(shí)現(xiàn)接口來監(jiān)聽可以廣播到所有應(yīng)用程序的全局事件。

HolsterListener實(shí)現(xiàn)接口來監(jiān)聽套裝事件，例如BlackBerry設(shè)備從套裝中插入和移開。

IOPortListener實(shí)現(xiàn)接口監(jiān)聽I/O端口事件。

KeyListener實(shí)現(xiàn)接口監(jiān)聽鍵盤事件，例如用戶按住或釋放一個(gè)鍵。

RealTimeClockListener實(shí)現(xiàn)本接口來監(jiān)聽實(shí)時(shí)時(shí)鐘事件，例如時(shí)鐘更新。

SerialPortListener實(shí)現(xiàn)此接口監(jiān)聽序列化端口事件，例如對(duì)于一個(gè)已經(jīng)和計(jì)算機(jī)序列端口連接的BlackBerry設(shè)備，一個(gè)在數(shù)據(jù)正在被發(fā)送到序列化端口連接狀態(tài)中的改變。

SystemListener實(shí)現(xiàn)此接口來監(jiān)聽系統(tǒng)事件，例如電池狀態(tài)和電源的改變。

TrackwheelListener實(shí)現(xiàn)本接口監(jiān)聽滑輪事件，例如按住滑輪。

USBPortListener實(shí)現(xiàn)本接口監(jiān)聽USB端口事件，例如對(duì)于一個(gè)已經(jīng)和計(jì)算機(jī)USB端口連接的BlackBerry設(shè)備，數(shù)據(jù)正被發(fā)送到USB端口連接的狀態(tài)。

系統(tǒng)功能net.rim.device.api.system包的類提供了訪問JavaVM和BlackBerry設(shè)備上系統(tǒng)資源的能力。

得到信號(hào)信息

RadioInfo提供了訪問信號(hào)狀態(tài)信息的能力。
得到設(shè)備信息

DeviceInfo類可以訪問下列BlackBerry設(shè)備的信息：

電池電源和狀態(tài)
Blackerry設(shè)備號(hào)
空閑時(shí)間
平臺(tái)版本

系統(tǒng)事件通知用戶

當(dāng)一個(gè)事件，例如一條新消息到來的時(shí)候，Alert類允許應(yīng)用程序通知用戶。

監(jiān)視內(nèi)存使用情況

使用一個(gè)Memory類提供的靜態(tài)方法來得到VM內(nèi)存使用統(tǒng)計(jì)信息。

Memory類很多實(shí)用方法返回一個(gè)MemoryStats對(duì)象。使用MemoryStats類提供的實(shí)用方法得到BlackBerry設(shè)備上內(nèi)存和可用存儲(chǔ)空間的詳細(xì)信息。
日志事件

EventLogger允許應(yīng)用程序在持久存儲(chǔ)里存儲(chǔ)事件日志。BlackBerry設(shè)備維護(hù)事件隊(duì)列，以至當(dāng)日志滿時(shí)，會(huì)刪除最早的事件，并增加新的事件。用戶可以按住Alt+lglg鍵來查看BlackBerry設(shè)備的系統(tǒng)事件日志。

使用工具BlackBerryJDE在net.rim.device.api.util包里提供了一組實(shí)用工具，這些類里的許多類提供了和Java標(biāo)準(zhǔn)版本里相似的功能

Comparator接口定義了對(duì)象集合上的順序的方法。
Arrays提供方法來操作數(shù)組，例如排序，查找，以及作為列表來查看數(shù)組。
BitSet類維護(hù)bit的集合。
net.rim.device.api.util包包含了多個(gè)類來管理特定類型的數(shù)據(jù)集合，包括向量，哈希表，映射以及棧。

應(yīng)用程序控制應(yīng)用程序控制允許系統(tǒng)管理員操作以下動(dòng)作：

控制內(nèi)部連接（公司防火墻背后的連接）
控制外部連接
控制本地連接（序列和USB連接）
控制訪問鍵存儲(chǔ)(keystore)
控制訪問特殊的API.
阻止第三方應(yīng)用程序存在BlackBerry設(shè)備上。
為了得到更多信息，參看BlackBerryEnterpriseServerHandheldManagementGuide的應(yīng)用程序管理。

受限制訪問的API,類,和方法

使用了下列受限的API,類，以及方法的應(yīng)用程序可以加載到BlackBerry設(shè)備，但是如果他們?cè)L問了一個(gè)沒有在應(yīng)用程序控制下得到允許的API時(shí)，在運(yùn)行時(shí)會(huì)拋出一個(gè)ControlledAccessException或者NoClassDefFoundError的異常。#p#

BlackBerry開發(fā)中類，方法或API

缺省值

應(yīng)用程序菜單項(xiàng)API(net.rim.blackberry.api.menuitem)允許

藍(lán)牙API(net.rim.device.api.bluetooth)允許

Connector.open()(javax.microedition.io)提示

注:內(nèi)部和外部的連接由不同的應(yīng)用程序控制策略來管理

DeviceKeyStore類(net.rim.device.api.crypto.keystore)允許

EventInjector類(net.rim.device.api.system)不允許

HTTPFilterAPI(net.rim.device.api.io.http)不允許

NotificationAPI(net.rim.device.api.notification)允許

電API和呼叫API(用來調(diào)用電話應(yīng)用程序)(net.rim.blackberry.api.phone和net.rim.blackberry.api.invoke)
允許(缺省，用戶提示)

電話日志API(net.rim.blackberry.api.phone.phonelogs)允許(缺省，用戶提示)