作者: 邓明轩、王恒进、王志刚
通过应用图标 提醒用 户
除了使 用主 屏幕 标记 以后 ， 开发 人员 还可 以使 用改 变应用 图标 的方 式提 醒用 户。 假 如下 图为正 常的 应用 图标 ：
开发人 员可 以通 过 AP I 修 改图标 ，提 示用 户该 应用 有新的 事件 发生 ，如 下图 ：
修改应 用图 标相 对比 较简 单， 只需 要调 用 n et .rim .b la ck berry .a pi .ho m e s cr ee n. Ho m eSc re en
的静态方 法 up da t eIc o n 就 可以更 改本 应用 的图 标， 参数为一 个 Bitm ap 图 片。 下面是 修改 应用 图标 的代 码片段 ：
Bitmap icon=Bitmap. getBitmapResource ( " cn/searb/test/unread.gif" );
net.rim.blackberry.api.homescreen.HomeScreen. updateIcon (icon);
网络连接调整
Bla ck Be rr y 接 口使 用 j2 m e 标准的 方法实 现 Ht t p 连接 或者 是 So ck et 连接 ， 在 MI Dl et 中的 网络连 接程 序可 以不 加修 改地 在 Bla ck Be rry 平台上 运行 。 然而 ， 因 为 Bla ck Ber ry 提 供更 多的 网络连 接选择 ， 开发 人员 可以对 网络 连接 代码 进行 调整 ， 使 用应 用的网 络连 接更加 稳定 ， 更 加符合 用户 的网 络选 择。
因为 Bla ck B er r y 需 要支持 标准 的 j2 m e ，所 以还 是通 过 ja v a x.m ic r o e dit io n. io . Co nn ect o r 类 实现各 种连 接。 为了 提供 更多的 网络 选择 ， Bla c kBer ry 平台 在 Co nn ect o r 的 o p en 方 法中 对 U RL 进行 了特 殊处 理，开 发人员 可以 在 U RL 后面加 上一些 特殊 的参 数以 标明 不同的 网络 连 接。比 如， 下面 的语 句在 U RL 后面 加上 了“ d ev ic e s id e= f als e ” ，表 明程 序希 望通 过 BE S MD S 连接网 络： Co nn ect o r .o pe n(“ h t t p://w ww .m y s er v er .co m ; d ev ic e s id e= f als e”) ;
需要了 解不 同参 数的 详细 情况， 可以参 考 AP I 文档 中 ja v a x.m ic r o e dit io n. io . Co nn ect o r 类 的说明 。
下面我 们根 据不 同的 链路 从整体 上简 单介 绍 Bla c kBe rry 上的 不同 连接 方式 。
B l ac kB erry En t e rprise S e rv er(B ES) 方式
这种方 式通 过使 用 BE S 的 Bla c kBe rry MDS S e r vic e s 来进 行网 络连 接， Bla ck B er ry MD S S er vic e s 负责 处理 所有 的浏 览器请 求或 者连 接请 求、 并负责 数据 加密 ，这 是黑 莓手机 的默 认 连接方 式， 如下 ：
( Ht t pCo nn ect io n) Co nn ect o r . o pen("h t t p://www . t e s t s er ve r .c o m" ) ;
以上代 码会 自动 将 Bla c kBe rry MD S S e rvice s 作 为它的 默认连 接路 径。 实际 开发 中，如 果 要确保 应用 程序使 用 us e s B la ck Be rry MDS S e r vic e s 作 为它的 连接 路径 ， 需要 在 U RL 最 后加 上 参数“ de vice s id e= f alse ” ， 这也是 我们 推荐 的方 式， 如下：
( Ht t pCo nn ect io n) Co nn ect o r . o pen(“ h t t p:/ /www . t e s t s er v e r .c om ; de vice s id e= f alse ”) ;
B l ac kB erry Int er ne t S erv ie 方式
这种方 式是 为第 三方 提供 的连接 接口 ， 它对 数据不 进行加密 ， 用 户可 以通过 使用 HT TP S
和 SS L 来 进行 安全的 连接 。 注 ： 目 前仅 对加 入了 Bla ck Be rry All ia nc e P r og r am 的 第三方 开放 合 作伙伴 开放 ，详 情参 考： h t t p://na .b la ck be rry .c om / eng /p art ne r s / al li an ce.js p 。
Di r ect T CP 方式
这种方 式允 许在 没有 使用 B la ck Be rry M DS 的黑莓 手机 上直接 T CP 连接。 为了 能启 用 di r ec t T CP 方式， 用户 需要 在手机 的 “选 项 - 高 级选 项 -T CP /IP ” 中设 置 AP N ， 以及 相应 的用户 名和 密 码。
运行 在 iD E N 网 络上 的黑莓 手机 （ 包括 6 5 1 0 、 7 51 0 、 7 5 2 0 和 7 10 0 i ）， 如 果不指 定 d e vice s id e 参数， 默认 的连 接是 di r ect T CP ； 非 运行在 iD EN 网络上 的其他 黑莓 手机 ， 如 果不指 定 de vice s id e 参数， 默认 的连接 是 Bla ck Berr y MDS 。
如果连接 时 Bla ck Be rry M D S 不存在 ，黑 莓手 机也会 自动采 用 di r ect T CP 方式 。 因此 ， 如果 要 将 di r ect T C P 作 为黑莓 手 机的默认连接方 式 ，我们建 议 在 U R L 中 加 入
“ de vice s id e=t ru e ” 参数， 如下：
( St re am Co nn ect io n)Con n ect o r .o pen("so ck et : //t e s t s er v er : 60 0; d e vice s id e =t ru e") ;
W i -Fi
如果需要 在 W i -F i 上创建 网络连 接， 不需 要在 应用 程序中 考虑 特别 的底 层逻 辑， 可 以在
U RL 中 加入 参数 “ in t er f ac e =wifi ” 就能实 现 W i -F i 连接 ，如下 ：
( St re am Co nn ect io n)Con nect o r .o pen(“ so ck et : / / t e s t s er v e r: 6 00 ; in t er f ac e =wi fi ”) ;
W AP 1.x
并不是 所有 的移 动运 营商 都支持通 过 W AP 网关 进行 连接的 ， 所 以如 果要 创建 W AP 连接 ，
开发者 需要 和移 动运 营商 联系， 获取 是否 提供 这种 支持、 并且 获取 他们 的 W A P 网管参 数。 以下是 一个基 于 W AP 网关 进行 HT TP 连接 的例子 ：
( Ht t pCo nn ect io n) Co nn ect o r . o pen("h t t p://w ap . g oog le.c om ; W AP G a t ew a yIP = 1 2 7 . 0 .0. 1 ; W AP G a t e w a yAP N= c ar rie r .c om . g pr s" ) ;
其中 W AP G a t ew a yIP 和 W A P G a t ew a yAP N 这两 项参数 必须指 定， 参数 之间 用“ ; ”隔开 ，
以下是 所有 的 W AP 参数列 表， 实 际开 发时 请根 据运营 商提供 的信 息决 定哪 些参 数需要 设置 。
| 参数 | 描述 |
|
W apGa t eway I P | 网关地址 |
|
W apGa t ewayAP N | AP N 的名称 |
|
W apGa t ewayPo r t | 网关端口号， 如果使用端口 号 920 3 的话， 会自动启用 “ W i r e le s s T r an s po r t La y e r Se c u r it y ” ( W TLS ) ， 除 非 指 定 了 W apE n ab l e WT LS= f a ls e 参数。 |
|
W apSou rc e I P | W a p 服 务器的地址。 |
|
W apSou rc ePo r t | W a p 服 务器的端口号 。 |
|
T u n ne lA u t hU s e r na me | AP N 的用户名，当网关启 用 Pa ss wo r d Au t hen t ic a t io n P r o t o c o l ( P AP ) 或 者 是 Cha lleng e H an d s ha k e A p p lic a t io n P r o t o c o l ( CHAP ) 时才需要提 供。 |
|
T u n ne lA u t hPa ss wo r d | AP N 密码，当网关启用 P A P 或 者是 CHA P 时才需要提 供。 |
|
W apEnab le W TL S | 指定是否启用 W TL S ， 如果没有 指定该参数， 当端 口号为 9203 时会自动应用 W TL S 。 |
W AP 2.0
如果手 机上 的 S e r vic e Boo k 上有 W AP 2 . 0 的 网关 记录 ， 可以通 过 AP N= <AP N Nam e > 的方法 指定网 关， 系统会 从 S er vic e Boo k 上找 到对 应的 信息 连接网 关。 不过 ，对 于不 同的运 营商 ， W AP 2 . 0 网 关的 名称 是不同 的， 如 果在 程序 里通 过网 关名称 指定 所需 要连 接的 网关， 则有 可 能在不同的 运营商环境 中出现连接问 题。有一个 相对通用的做 法是通过程 序遍历手机 上的 S er vic e Boo k ， 找 到 W AP 2 . 0 的 网关 记录 ， 然 后通 过该 记录 的 U ID 进 行连 接， 因为 在 Bla ck Be rry 上可以 在 RU L 后 面加 上 Co nn ect io nU ID =< G a t ew a yU ID> 的方式 指定 网关 。
具 体 的 做 法 是 先 通 过 S e r vic eBoo k 类 的 g et S B 方 法 获 得 S er vice Boo k ， 然 后 通 过 S er vic eBoo k 实例 的 fin dR ec o r ds B yCi d 方 法查 找在 Cid 中带“ WP T CP ”字 样的记 录。这 些记 录 里可能包 含 W ifi 或者 是 m m s 对应的 记录 ， 所 以要排 除这些 记录 ， 使 用的 方法 是判断 在 U id ， 查找 U id 里不 带“ W i fi ”和 “ mms ”字 样的 记录 。
代码片 段如 下：
ServiceBook sb = ServiceBook. getSB ();
ServiceRecord[] records = sb.findRecordsByCid( "WPTCP" ); String uid = null ;
for ( int i = 0; i < records. length ; i++) {
if (records[i].isValid() && !records[i].isDisabled()) {
if (records[i].getUid() != null
&& records[i].getUid().length() != 0) {
if ((records[i].getUid().toLowerCase().indexOf( "wifi" ) == -1)
&& (records[i].getUid().toLowerCase()
.indexOf( "mms" ) == -1)) {
uid = records[i].getUid();
break ;
}
}
}
}
if (uid != null ) {
// 在参数中指 定 Co nn ec t io nU ID
Connector.open (_url + ";ConnectionUID=" + uid);
} else {
// 没找到 Wap 2.0 的 se r vi ce bo ok , 做其它处 理 .
}
数据存储与共享
使 用 RM S 进行 存 储
j2 m e 提供 了 R MS 存储机 制， MI DP 规范 定义 了持久 的、基 于记 录的 存储 功能 ，叫记 录 管理存 储 ( RMS) 。一 个 MI D let 套 件可 以使 用 R MS 创 建一个 或多 个记 录存 储， 每个 记 录由一 个唯一 的名 字标 识。 在 j a v a x.m ic r o e dit io n. rm s 包中可 以找到 必要 的类 和接口 对 RMS 进 行操 作，其 中关 键是 的 R ec o r dSt o r e 。 R eco r dS t o r e 提供了 打开， 关闭 ，读 取， 写入 和更新 操作 ， 也提供方法删除单个记录或者整个存储。这个包包含 各种接口用于列举、排序和筛选 RMS 内容。
Bla ck Be rry 平台 提供 了对标 准 j2 m e 的支 持， 所以 也支 持标准 的 RMS 存储机 制， 开发人 员在 MI Dl et 中使 用的 RMS 存储代 码可 以不 加修 改直 接在 Bla ck B er r y 上 运行 。
在 MI DP 1 . 0 时候， 每 个 RM S 存储只 属于 创建 它的 MI D let 套 件， 不能 用于不 同程 序之间 的数据 共享 。 MI DP 2 . 0 规 范给 RMS 包增 加了 一个非 常有用 的能 力： 它允 许一 个 MI Dl et 套件 和另一 个 MI Dl et 套件 共享 记录存 储。
共享一 个 RMS 记 录存 储需 要两个 或者 多个 参与 者： 一 个拥有 者和 一个 或者 多个 消费者 。 拥有者 负责创 建和命 名存 储，建 立授权 模式指 定存 诸为“ 共享” 或者“ 不共 享 ” ，同 时可 以
指定它 的访问 模式“ 可写 ”或者 “不可 写” 。 消费者 通过名 字获得 记录存 储的 访问。 消费者 不能访 问没 有共 享的 存储 ，也不 能修 改不 可写 的存 储。
一个共享 的 RMS 被一 个三 元组标 识 ( 提供 者名 字， MI Dl et 套 件名 字， 记录 存储 名字 ) ：
l 提供者 名字 是 J AD 或者 m a ni f e s t 文 件里 面的 MI Dl et - V endo r 属 性的 值。
l MI Dl et 套 件名字 是 J AD 文 件里 面 MI Dl et -nam e 字段 的值
l 记录存 储名 字是一 个 1 到 3 2 位 长的 区分 大小写 的 U ni c o de 字符 串， 是当 你创 建记 录存储 时候 用的 名字 。
为了支 持共 享， MI DP 2 . 0 标准 在 ja v a x.m ic r o e dit io n. r m s 中添一 些方 法： 第一个 方法 用于 打开 一个 已经存 在的 记录 存储 ， 或者 创建一 个新 的记 录存 储并 设置它 的
授权和 可写 特性 。
s t a t ic R ec o r dS t o r e Op enR ec o r dS t o r e ( St rin g r ec o r d S t o r eN am e , boo le an c re a t e, i n t aut hmo de, boo le an w rit ab le ) ;
参数说 明如下 :
l r ec o r dS t o r eN am e 设置记 录存储 的名 字
l cre a t e ， 是否 强制 创建 ，如 果为 t ru e ， 存储 不存 在时 会强制 创建
l aut hmo de ， 用 于 指 定授权 模式 : 使 用 R eco r dS t o r e.A U TH MO D E_P RI V A TE 话 表示 不允 许共享 ， 使用 R ec o r dS t o r e . A U T HMO D E_A NY 则允许 共享 ， 如 果存 储已 经存在 这个 参数会 被忽 略。
l wr it e ab le ，是 否可 写，如 果为 t ru e, 指定 其他 MI Dl e t 套件可 以修 改这 个记 录存 储， 如果存 储已 经存 在这 个参 数会被 忽略 。
第二个 方法 用于 打开 共享 记录存 储：
s t a t ic R ec o r dS t o r e o penR ec o r dS t o r e( St rin g r ec o r dS t o r eN am e, St rin g v endo r Nam e , St rin g
s ui t eN am e)
参数说 明如 下：
l r ec o r dS t o r eN am e 是 要打开 的共享 记录 存储 的名 字
l v endo r Nam e 是拥有 者 MI D let 套 件的 MI Dl et - V endo r 属性的 值
l s ui t eN am e 是拥 有者 MI Dl e t 套件的 名字
仅当记 录存 储的 拥有 者设 置了 au t omo de 为 A U TH M OD E_A NY 时 这个 方法 才能 成功打 开 记录存 储。 需要 注意 的是 你不能 直接 检测 存储 的可 写属性 。 要 发现 一个 记录 存储是 否可 写的 唯一方 法是 试着 向记 录存 储写入 ，如 果不 可写 就捕 获相应 的异 常。
记住 在 J AD 或 者 m an i f e s t M ID let -V er s io n ， 并 不在 参数 列表中 。 这意 味着 拥有者 套件无 法 在影响 消费 者的 前提 下改 变共享 的存 储的 记录 格式 。
第三个 方法 用于 修改 存诸 的属性 ：
V o id s et Mo de( in t aut hmo de, boo le an w rit ab le ) ;
参数说 明如 下：
l aut hmo de 指定记录存储 的新的授权模式， 可以设 置为 A U T HMO D E_P RI V A T E 或者
是 A U TH MO DE_ AN Y 。
l wr it ab le 指定 存储 的信息 是否可 写。
注意只 有存 诸的 拥有 者才 能改变 aut hmo de 和 w rit ab le 属 性。 另外 ，没 有方 法能够 用 来查询 这些 设置 。
如上所述 ， Bla ck Be rry 平台 提供 j 2 m e 支持 ， 所以 开发 人员可以 在 Bla ck Be rry 平 台上使 用
RMS 方 法完 成数 据的 存诸 和共享 。
使 用 R u nT imeS t or e 进行存储
相对于 静态 的 R MS 的繁琐 配置和 不灵 活， Bla ck B er r y 提供了 R un T im eS t o r （ e 运行 时存储 ） ， 使用非 常灵 活和 方便 。
RunT im eSt o r e 在 平台 级别提供 了数据存储方 式和共享方 式，它提供了 一个中间区 域让 不同应 用可 以共 享对 象， 任何通 过数 字签 名的 应用 程序都 可以 访问 运行 时存 储。
对于 RunT im eSt o r e 的使用 需要注 意的 是：
l 对象可 以添 加到 运行 时存 储或者 从运 行时 存储 中替 换掉
l 运行时 存储 必须 以一 个独 一无二 的 ID 创建
l 任何类 型的 对象 都可 以放 到运行 时存 储中
l 设备掉 电的时 候 Run t im eSt o r e 中的 数据 会丢 失。 下面是 创建 运行 时存 储和 写入简 单数 据的 代码 示例 :
class CreateStoreDemo extends UiApplication {
// 通过包名 生成的 唯一的长 整型 ID
public static long STORE_ID = 0x23ad23489a243L;
public CreateStoreDemo() {
String msg = “S ha re d te xt f or a no th er a pp li ca ti on ” ; RuntimeStore st or e = RuntimeStore .getRuntimeStore(); try { store.put(S TORE_ID, msg);
} catch (Exception ex) {}
}
}
创建好 了以 后就 可以 通过 相应代 码获 取其 中的 数据 ， 下面 是读 取 RunT im eSt o r e 的 代码 示例 ：
class ReadStoreDemo extends UiApplication {
public ReadStoreD emo() {
RuntimeStore st ore = RuntimeStore.getRuntimeStore();
try {
//cast the r eturned object to a string
String msg = (String)store.get( CreateStoreDemo.STORE _ID);
} catch (E xc ep t io n ex ) {
//handle exc eption
}
}
}
BlackBerry SDK下载
3236
被折叠的 条评论
为什么被折叠?
到【灌水乐园】发言
