专注于Blackberry

BlackBerry 应用程序开发者指南 第二卷:高级–第3章 集成PIM功能

3 第3章 集成PIM功能 PIM API 使用地址本 使用任务 使用日历 PIM API Java个人信息管理(Personal Information Manager,PIM) API(javax.microedition.pim)以及BlackBerry PDAP(Personal Digital Assistant Profile) API(net.rim.blackberry.api.pdap)允许你访问BlackBerry设备上的日历,任务,以及地址本. 注:在4.0版本里,net.rom.blackberry.api.pim包是不赞成使用的. 现在这个包里的类在javax.microedition.pim and net.rim.blackberry.api.pdap里可以得到. PIM类是一个抽象类,它提供了访问BlackBerry设备上的PIM数据的方法. 获取一个PIM对象 调用PIM.getInstance(). 注:当你的应用程序第一次访问PIM API时,它将检查一个ControlledAccessException.如果系统管理员使用应用程序控制限制访问PIM API,一个运行时异常将会抛出.为获取更多信息,参看”BlackBerry应用程序开发者指南 第2卷:高级 第一卷:基础”. PIM列表 PIM列的接口代表了所有联系人,事件以及任务列的常用功能.一个列包含0个或多个项,它们是PIMItem的子类.使用PIM列组织相关项,并且获取一些或所有列表的项. 注:在BlackBerry设备里,每个ContactList,ToDoList或EventList实例都会涉及到BlackBerry设备上的本地数据库.第三方应用程序不能创建自定义的列表. PIM项 PIMItem接口代表了一个列项常用的功能.Contact,Event,以及ToDo接口扩展了PIMItem.一个PIM项代表了单个入口的数据集合,例如一个约会或者一个联系人. 当你在一个指定的PIM列表上创建一个PIM项时,自从它存在开始,此项仍保留了和列表的关联.你也可以使用标准的格式,例如iCal和vCard,导入或导出PIM项里的数据. 字段 一个PIM项在字段里存储数据.每个PIMItem接口-Contact,Event,或ToDo-为每个支持的字段定义了唯一的ID.例如,Contact接口定义字段来存储一个internet消息地址(EMAIL),姓名(FORMATTED_NAME),以及电话号码(TEL). 在你试图设置或获取字段值之前,调用PIMList.isSupportedField(int)来确认是否支持方法. 一个字段可能有一个与之关联的具有描述性的标签显示给用户.为获取这个字段的标签,调用PIMList.getFieldLabel(int). 每个字段都有一个数据类型ID,例如INT,BINARY,DATE,BOOLEAN,或STRING.为了得到一个字段的数据类行,调用PIMList.getFieldDataType(int). 数据类型决定了你将使用哪一个方法得到或设置字段数据.例如: 如果字段的数据类型为STRING,为了加入一个值,调用PIMItem.addString(String). 为了改变已经存在的值,调用PIM.setString(String). 为了获取一个字段值,调用PIMItem.getString(). 监听者 当列表里的一个项发生变化时,你的PIMListListener接口实现会收到这个通知. PIMListListener接口提供了下面的方法: 方法 描述 itemAdded(PIMItem) 当加入一个项到列表时调用. item.Removed(PIMItem) 当从列表里删除时调用. [...]

继续阅读本文 →

Taigoo发表于 April 28, 2008 12:20 pm | 留言(1) |文档 

BlackBerry 应用程序开发者指南 第二卷:高级–第2章 集成消息

2   第2章 集成消息 Mail API 操作消息 管理文件夹 管理附件 Mail API BlackBerry Mail API在net.rim.blackberry.api.mail和net.rim.blackberry.mail.event中. Mail API类 BlackBerry Mail API在net.rim.blackberry.api.mail和net.rim.blackberry.mail.event包中.它允许应用程序使用消息应用程序发送,接收和访问消息.. 注:BlackBerry mail API提供访问消息列表里的消息的能力,但不能访问其他类型的消息,例如短消息,PIN消息,或者电话呼叫记录.为了访问电话呼叫记录,使用电话呼叫记录的API(net.rim.blackberry.phonelogs).为得到更多信息,参卡79也的”访问和管理电话记录”.       当你的应用程序首先访问mail API时,检查一个NoClassDefFoundEorror!.如果系统管理员使用程序控制限制访问mail API,此错误将抛出.为获得更多信息,参看BlackBerry应用程序开发者指南第二卷:高级 第一卷:基础的16页的”应用程序控制” 类 描述 Session 本类为消息操作表现了一个抽象模型.它提供访问消息服务,存储,以及传输的能力.应用程序获取一个新的Session对发送或接收消息.. Store 本类模型化BlackBerry设备的底层消息存储.为了获得一个Store实例,调用Session实例. Transport 本类代表了消息传输协议. 消息 一个Message对象包含了一组属性,例如主题(subject),发送者(sender),接收者(recipients),以及消息体(它的内容).为获取更多消息,参看14页的”多部分消息”. 下面的类和接口定义了支持的属性: 类或接口 描述 Address 本类代表了一个消息,ftp,http,或来自于(from),回复(reply to),接收属性以及消息体里的wap地址.Address类包含一些字段来存储完全许可的地址字符串,例如aisha.wahl@blackberry.com和显示名. Header 本类定义了支持的消息头字段,例如 TO,FROM,以及DATE. Message.Flag 本接口定义了消息标记,例如MOVED,OPENED,或SAVED. Message.Icons 本接口定义了多种状态图标的字符串表现形式,例如一个已发送消息的检查标记. Message.RecipientType 本接口定义了支持的接收类型,例如TO,CC或BCC. Message.Status 本接口为发送和接收消息定义了状态选项,例如RX_RECEIVED,EX_ERROR,TX_SENT,以及TX_READ. 多部分消息(Multipart [...]

继续阅读本文 →

Taigoo发表于 April 28, 2008 12:15 pm | 留言 |文档