BlackBerry 应用程序开发者指南 第二卷：高级–第10章 访问安装和配置信息

10
           第10章 访问安装和配置信息

服务定制API

服务定制API(Service Book API)
服务定制API(net.rim.device.api.servicebook)使应用程序可以和BlackBerry基础(infrastructure)进行交互.服务定制由服务记录组成,每个服务定义了一个在BlackBerry设备上有效的服务.
服务记录定义了通讯协议(WAP或IPPP),网关,以及配置信息,例如浏览器设置.

服务定制API功能

描述

管理MDS服务连接

浏览器应用程序API可以使用任何一个带有BrowserConfig 的UID的ServiceBook入口,连接到一个无线网络.例如, Browser类使用服务定制获取一个BrowserSession. Browser.getTransportUid()查询一个服务定制来获取和一个给定服务记录相关联的UID.

管理mail信息

允许应用程序指定一个频道, 它引用合适的服务记录并通过此频道发送一个email.例如,应用程序可以使用BES或一个BlackBerry Internet Service选择发送消息..为获取更多信息,参看12页的”Mail API”.

为了查看BlackBerry设备上的服务定制,单击选项下的Service Book.
ServiceBook类维护一个ServiceRecord对象的集合.每个ServiceRecord对象由一个唯一的ID(UID)和连接ID(CID)标识.

CID

描述

CMIME

CMIME(compressed multi-purpose mail extensions,压缩多意图邮件扩展) CID定义了消息连接

ALP

ALP(address lookup protocol,地址查询协议) CID为无线GAL(Global Address List,全局地址列表)查询定义连接.

IPPP

IPPP(IP Proxy Protocol)使用BlackBerry® MDS Services定义HTTP连接.

BrowserConfig

BrowserConfig(浏览器配置)CID定义BlackBerry和WAP浏览器连接.

Sync

数据同步(Sync) CID为无线数据同步定义连接.

WAP

WAP(wireless application protocol) CID定义了WAP网关连接.

CICAL

CICAL(compressed iCalendar,压缩的iCalendar)为无线日历同步定义连接.

 

服务记录

描述

Desktop [CMIME]

此服务记录包含了使用桌面发送消息需要的信息.,也包含了完成其他功能需要的消息,例如无线消息调解.

Desktop [ALP]

此服务记录包含了完成无线GAB(Global Address Book)查询所需要的信息.

Desktop [IPPP]

此服务记录包含了通过MDS服务使用并且浏览Internet所要的信息.

Desktop [CICAL]

此服务包含了进行无线日历操作所需要的信息.

Desktop [BrowserConfig]

此服务记录包含了BlackBerry浏览器的配置信息.

Web Client [CMIME]

此服务记录包含了发送消息需要的信息.,也包含了使用BlackBerry Internet Service.进行其他功能(例如无线消息调解)所需要的消息.

WAP Secure Transport [WAP]

此服务记录包含了连接到服务商WAP网关所需要的信息.

WAP Browser [BrowserConfig]

此服务记录包含了WAP浏览器的配置信息.

Desktop [Sync]

此服务记录包含了完成数据同步所需要的信息.

监听服务定制事件
GlobalEventListener接口(在net.rim.device.api.system 包里)的实现使应用程序可以监听服务定制事件. 当接收到一个全局事件时,GlobalEventListener.eventOccurred()的实现指定了进行的操作.
为了注册一个全局事件监听者,调用Application.addGlobalEventListener(GlobalEventListener).
ServiceBook类定义了下面的事件,它们由一个GUID标识.

GUID

描述

GUID_SB_ADDED

当增加一个服务定制时发送的全局事件的GUID.

GUID_SB_BR_END

当服务定制备份或恢复结束时发送的全局事件的GUID.

GUID_SB_BR_START

当服务定制备份或恢复开始时发送的全局事件的GUID.

GUID_SB_CHANGED

当一个服务定制改变时发送的全局事件的GUID.

GUID_SB_OTA_SWITCH

当所有服务记录因为一个移动的BES命令OTA而被插入时发送的全局事件的GUID.

GUID_SB_OTA_UPDATE

当OTA为一个UID更新所有服务记录时发送的全局事件的GUID.

GUID_SB_REMOVED

当删除一个服务定制时发送的全局事件的GUID.

Last Updated:2007年2月5日

继续阅读本文 →

  

Confach发表于 April 29, 2008 6:00 am | 留言 |文档