作者:Confach 發(fā)表于March 19,200614:59 pm
版權(quán)信息:可以任意轉(zhuǎn)載, 轉(zhuǎn)載時(shí)請(qǐng)務(wù)必以超鏈接形式標(biāo)明文章原始出處和作者信息.
http://www.cnblogs.com/confach/articles/353363.html

1

第1章BlackBerry API

使用BlackBerry API

 BlackBerry Java 開(kāi)發(fā)環(huán)境（簡(jiǎn)稱JDE）的設(shè)計(jì)提供了一套完整的API和工具,來(lái)開(kāi)發(fā)在BlackBerry設(shè)備上運(yùn)行的Java應(yīng)用程序。

 BlackBerry設(shè)備包含了一個(gè)基于CLDC1.1以及MIDP的Java ME（Java Platform Micro Edition）運(yùn)行時(shí)環(huán)境。BlackBerry API擴(kuò)展提供了額外的功能,并且和BlackBerry集成得更緊密。

   你可以在你的應(yīng)用程序中使用CLDC/MIDP和BlackBerry API。為了能讓你的應(yīng)用程序在任何采用JTWI（Java Technology for Wireless Industry，無(wú)線領(lǐng)域的Java技術(shù)）的設(shè)備上運(yùn)行，你僅需要使用CLDC和MIDP API來(lái)編寫(xiě)標(biāo)準(zhǔn)的MIDP應(yīng)用程序。

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

BlackBerry手持設(shè)備軟件組件

為了查看API 參考。點(diǎn)擊任務(wù)欄的開(kāi)始>程序>Research In Motion>BlackBerry JDE 4.1.0>API Java Doc Reference

BlackBerry API

BlackBerry API為訪問(wèn)BlackBerry特性提供了用戶界面，本地化，網(wǎng)絡(luò)，以及其他功能。

  <!--[if !vml]--><!--[endif]-->注：訪問(wèn)某些特性，如高級(jí)的加密，同步，以及消息的額外API，是受限制的。為了使用這些API,你必須收到專門(mén)來(lái)自Research In Motion的認(rèn)證中心編寫(xiě)的許可。為了得到更多信息，參看 BlackBerry 應(yīng)用程序開(kāi)發(fā)者指南第一卷：基礎(chǔ) 第二卷：高級(jí)。

CLDC API

MIDP API

PDAP API

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

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

<!--[if !supportLists]-->        <!--[endif]-->注：.cod文件名控制在128字節(jié)。

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

限制

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

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

多線程

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

持久數(shù)據(jù)

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

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

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

網(wǎng)絡(luò)通信

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

BlackBerry JDE提供了以下幾種連接類(lèi)型：

• 流連接（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 類(lèi)對(duì)BlackBerry設(shè)備保持了一些進(jìn)入的連接。

流

 BlackBerry JDE為包含在CLDC java.io包里的流提供了標(biāo)準(zhǔn)的接口和類(lèi)。

MIME編碼

BlackBerry IDE提供了MIMEInputStream和MIMEOutputStream類(lèi)來(lái)讀寫(xiě)一個(gè)MIME編碼的數(shù)據(jù)流。

壓縮

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

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

集合

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

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

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

向量

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

列表

BlackBerry JDE在net.rim.device.api.collection.util包里提供了一些類(lèi)來(lái)管理元素的列表

哈希表

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

事件監(jiān)聽(tīng)者

事件監(jiān)聽(tīng)者接口根據(jù)事件類(lèi)型劃分。每個(gè)應(yīng)用程序注冊(cè)來(lái)接收特定類(lèi)型的事件。應(yīng)用程序事件隊(duì)列然后調(diào)度事件到一個(gè)合適的監(jiān)聽(tīng)者。
應(yīng)用程序可以實(shí)現(xiàn)合適的監(jiān)聽(tīng)者接口或者在各種Screen對(duì)象里重寫(xiě)監(jiān)聽(tīng)者方法。大多數(shù)應(yīng)用程序?qū)崿F(xiàn)了KeyListener 和TrackwheelListener 接口，而且注冊(cè)了監(jiān)聽(tīng)者來(lái)接收鍵盤(pán)和滑輪的事件。鍵盤(pán)和滑輪是用戶和應(yīng)用程序交互的主要方式。

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

系統(tǒng)功能

net.rim.device.api.system包的類(lèi)提供了訪問(wèn)Java VM和BlackBerry設(shè)備上系統(tǒng)資源的能力。
得到信號(hào)信息

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

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

• <!--[if !supportLists]--><!--[endif]-->電池電源和狀態(tài)
• <!--[if !supportLists]--> <!--[endif]-->Blackerry設(shè)備號(hào)
• <!--[if !supportLists]--> <!--[endif]-->空閑時(shí)間
• <!--[if !supportLists]--> <!--[endif]-->平臺(tái)版本

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

當(dāng)一個(gè)事件，例如一條新消息到來(lái)的時(shí)候，Alert類(lèi)允許應(yīng)用程序通知用戶。
監(jiān)視內(nèi)存使用情況

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

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

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

使用工具

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

• <!--[if !supportLists]-->Comparator接口定義了對(duì)象集合上的順序的方法。
• <!--[if !supportLists]-->Arrays提供方法來(lái)操作數(shù)組，例如排序，查找，以及作為列表來(lái)查看數(shù)組。
• <!--[if !supportLists]-->BitSet 類(lèi)維護(hù)bit的集合。

net.rim.device.api.util包包含了多個(gè)類(lèi)來(lái)管理特定類(lèi)型的數(shù)據(jù)集合，包括向量，哈希表，映射以及棧。

應(yīng)用程序控制

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

• <!--[if !supportLists]-->控制內(nèi)部連接（公司防火墻背后的連接）
• <!--[if !supportLists]-->控制外部連接
• <!--[if !supportLists]-->控制本地連接（序列和USB連接）
• <!--[if !supportLists]-->控制訪問(wèn)鍵存儲(chǔ)(key store)
• <!--[if !supportLists]-->控制訪問(wèn)特殊的API.
• <!--[if !supportLists]--> <!--[endif]-->阻止第三方應(yīng)用程序存在BlackBerry設(shè)備上。

為了得到更多信息，參看BlackBerry Enterprise Server Handheld Management Guide的應(yīng)用程序管理。

受限制訪問(wèn)的API, 類(lèi), 和方法

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