51CTO首页
AI.x社区
博客
学堂
精品班
软考社区
免费课
企业培训
鸿蒙开发者社区
WOT技术大会
IT证书
公众号矩阵
移动端
短视频免费课程课程排行直播课软考学堂
全部课程厂商认证IT技术24年11月软考PMP项目管理免费题库
在线学习
文章资源问答课堂专栏直播
51CTO
鸿蒙开发者社区
51CTO技术栈
51CTO官微
51CTO学堂
51CTO博客
CTO训练营
鸿蒙开发者社区订阅号
51CTO软考
51CTO学堂APP
51CTO学堂企业版APP
鸿蒙开发者社区视频号
51CTO软考题库
账号设置 退出

BlackBerry应用开发者指南 PIM API

作者：乐雨天
移动开发
本文为《BlackBerry应用开发者指南 PIM API》，PIM API即个人信息管理的API，Java个人信息管理(Personal Information Manager,PIM) API(javax.microedition.pim)以及BlackBerry PDAP(Personal Digital Assistant Profile) API(net.rim.blackberry.api.pdap)允许你访问BlackBerry设备上的日历,任务,以及地址本.

在前文中我们讲过《BlackBerry应用开发者指南 Mail API》和《BlackBerry应用开发者指南 使用受控API》，本文我们将向大家介绍BlackBerry的PIM API，即Java个人信息管理(Personal Information Manager,PIM) API(javax.microedition.pim)以及BlackBerry PDAP(Personal Digital Assistant Profile) API(net.rim.blackberry.api.pdap)允许你访问BlackBerry设备上的日历,任务,以及地址本.

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,一个运行时异常将会抛出.）

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接口提供了下面的方法:

方法

描述

  1. itemAdded(PIMItem) 

当加入一个项到列表时调用.

  1. item.Removed(PIMItem) 

当从列表里删除时调用.

  1. itemUpdated(PIMItem,PIMItem) 

当一个项发生变化时调用.

  1. ContactList cl = (ContactList)PIM.getInstance().openPIMList(PIM.CONTACT_LIST, PIM.WRITE_ONLY);  
  2.  
  3. ((BlackBerryPIMList)cl).addListener(  
  4.  
  5.        new PIMListListener() {  
  6.  
  7.            public void itemAdded(PIMItem item) {  
  8.  
  9.               System.out.println(" ITEM ADDED: " +  
  10.  
  11.                      ((Contact)item).getString(Contact.UID, 0));  
  12.  
  13.               }  
  14.  
  15.             
  16.  
  17.            public void itemUpdated(PIMItem oldItem, PIMItem newItem) {  
  18.  
  19.               System.out.println(" ITEM UPDATED: " +  
  20.  
  21.                       ((Contact)oldItem).getString(Contact.UID, 0) + " to " +  
  22.  
  23.                      ((Contact)newItem).getString(Contact.UID, 0));  
  24.  
  25.               }  
  26.  
  27.             
  28.  
  29.            public void itemRemoved(PIMItem item) {  
  30.  
  31.               System.out.println(" ITEM REMOVED: " +  
  32.  
  33.                      ((Contact)item).getString(Contact.UID, 0));  
  34.  
  35.               }  
  36.  
  37. });  
  38.  

 （注:监听者仍然保持和BlackBerry设备数据库的关联,甚至是在相应的PIMList对象已经删除之后.为了删除一个监听者,调用BlackBerryPIMList.removeListener().）

远程地址查询

支持远程地址查询的应用程序应该实例化BlackBerryContactList接口.此节口扩展了ContactList接口,并且提供了下面额外的方法:

方法

描述

  1. choose(Contact, int, boolean) 

启动地址本以至用户可以选择一个地址.

  1. void lookup(Contact, RemoteLookupListener) 

初始化一个远程查询.

  1. void lookup(String, RemoteLookupListener) 

初始化一个远程查询.

RemoteLookupListener接口提供了一单个方法,items(),此方法返回一个远程地址查询结果的迭代.

使用地址簿

使用一个ContactList的实例增加或查看BlackBerry设备地址簿的联系人信息.创建Contact对象存储单独的联系人信息,此信息包含姓名,电话号码,Email,以及街道地址.

BlackBerry特定的地址字段

BlackBerryContact接口扩展了Contact,为了访问BlackBerry联系人特定的字段, 它定义了下面的常数:

常量

描述

BlackBerryContact.PIN

访问PIN字段.

BlackBerryContact.USER1 到 USER4

访问USER1到USER4字段.

为了定义USER1到USER4字段的标签,调用BlackBerryPIMList.setFieldLabel().

此改变立即生效.你不必要提交改变.

（注:改变一个标签将影响所有BlackBerry设备上的联系人.）

打开一个联系人列表

在你增加联系人之前,你必须创建一个联系人列表.调用PIM.openPIMList().将列表的类型作为参数提供给open(PIM.CONTACT_LIST),并且提供访问模式(READ_WRITE,READ_ONLY,或WRITE_ONLY)打开列表.

如果你正在为BlackBerry设备专门编写一个应用程序,将你的联系人列表转化为BlackBerryContactList,因为此接口提供了一个附加的方法来支持远程地址查询.为了让一个应用程序可以跨多个兼容的Java ME BlackBerry设备,使用PDAP实现.

  1. ContactList contactList = null;  
  2.  
  3. try {  
  4.  
  5.     contactList = (ContactList)PIM.getInstance().openPIMList(  
  6.  
  7.                           PIM.CONTACT_LIST, PIM.READ_WRITE);  
  8.  
  9. }  
  10.  
  11. catch (PimException e) {  
  12.  
  13.     return;  
  14.  
  15. }  
  16.  
  17.    
  18.  

（注:联系人不会加到数据库中,直到你提交它.）#p#

创建一个联系人

调用联系人列表的createContact().

  1. Contact contact = contactList.createContact(); 

增加联系人信息

Contact类定义了保存数据的字段,例如Contact.Name,Contact.ADDR,以及Contact.TEL.每个字段都有一个特定的数据类型,你可以调用PIMList.getFieldDataType(int)来获取它们.由于依赖字段的数据类型,通过调用下列方法创建一个新值: addString(), addStringArray(), addDate(), addInt(), addBoolean(), 或addBinary().

在你设置和获取一个字段之前,为了验证列表项是否支持字段,调用:

  1. ContactList.isSupportedField(int) 

通过使用属性来区分其值,某些字段可以存储多个值.例如,TEL字段支持ATTR_HOME,ATTR_WORK,ATTRMOBILE和ATTR_FAX属性存储工作,家庭,移动以及传真号码.

为了判断一个字段最多支持几个值,调用PIMList.maxValues(int field).

此方法返回支持的值的个数,返回-1意味着可以增加任意个数的值.为了验证一个字段是否支持特定的属性,调用isSupportedAttribute(int, int).

  1. // Create string array for name.  
  2.  
  3. try {  
  4.  
  5.     ContactList contactList = (ContactList)PIM.getInstance().openPIMList(PIM.CONTACT_LIST, PIM.WRITE_ONLY);  
  6.  
  7. }  
  8.  
  9. catch (PIMException e)  
  10.  
  11. {    
  12.  
  13. }  
  14.  
  15.    
  16.  
  17. Contact contact = contactList.createContact();  
  18.  
  19. String[] name = new String[5]; // 5 name elements  
  20.  
  21. try {  
  22.  
  23.     name[Contact.NAME_PREFIX] = "Mr.";  
  24.  
  25.     name[Contact.NAME_FAMILY] = "McPherson";  
  26.  
  27.     name[Contact.NAME_GIVEN] = "Scott";  
  28.  
  29.     }  
  30.  
  31. catch (IllegalArgumentException iae) {  
  32.  
  33.     // handle exception  
  34.  
  35. }  
  36.  
  37.    
  38.  
  39.    
  40.  
  41. // Add name.  
  42.  
  43. if(contactList.isSupportedField(Contact.NAME)) {  
  44.  
  45.     contact.addStringArray(Contact.NAME, Contact.ATTR_NONE, name);  
  46.  
  47. }  
  48.  
  49.    
  50.  
  51. // Create string array for address.  
  52.  
  53. String[] address = new String[7]; // 7 address elements  
  54.  
  55. try {  
  56.  
  57.     address[Contact.ADDR_COUNTRY] = "United States";  
  58.  
  59.     address[Contact.ADDR_LOCALITY] = "Los Angeles";  
  60.  
  61.     address[Contact.ADDR_POSTALCODE] = "632300";  
  62.  
  63.     address[Contact.ADDR_REGION] = "California";  
  64.  
  65.     address[Contact.ADDR_STREET] = "323 Main Street";  
  66.  
  67.     }  
  68.  
  69. catch (IllegalArgumentException iae) {  
  70.  
  71. // Handle exception.  
  72.  
  73. }  
  74.  
  75.    
  76.  
  77. // Add address.  
  78.  
  79. contact.addStringArray(Contact.ADDR, Contact.ATTR_NONE, address);  
  80.  
  81.    
  82.  
  83. // Add home telephone number.  
  84.  
  85. if (contactList.isSupportedField(Contact.TEL) &&  
  86.  
  87.     contactList.isSupportedAttribute(Contact.TEL, Contact.ATTR_HOME))  
  88.  
  89. {  
  90.  
  91.     contact.addString(Contact.TEL, Contact.ATTR_HOME, "555-1234");  
  92.  
  93. }  
  94.  
  95.    
  96.  
  97. // Add work telephone number.  
  98.  
  99. if (contactList.isSupportedField(Contact.TEL)) {  
  100.  
  101.     contact.addString(Contact.TEL, Contact.ATTR_HOME, "555-5555");  
  102.  
  103. }  
  104.  
  105.    
  106.  
  107. // Add work internet messaging address.  
  108.  
  109. if (contactList.isSupportedField(Contact.EMAIL)) {  
  110.  
  111.     contact.addString(Contact.EMAIL,  
  112.  
  113.                      Contact.ATTR_WORK,  
  114.  
  115.                      "aisha.wahl@blackberry.com");  
  116.  
  117. }  
  118.  

修改联系人信息

对于仅支持一个值的字段,调用合适的set方法用一个新值替代一个已存在的值.

（注:如果你调用一个增加方法,例如addString(),对于已经存在一个值的字段来说,将抛出一个FieldFullException异常.使用相应的set方法,例如setString(),修改一个已经存在的值.）

对于包含了一个字符数组的姓名和地址字段,获取此数组,然后将它加入之前,修改一个或多个数组上的索引.

  1. if (contact.countValues(Contact.NAME) > 0) {  
  2.  
  3.     String[] newname = contact.getStringArray(Contact.NAME, 0);  
  4.  
  5. }  
  6.  
  7. // Change the prefix to Dr. and add the suffix, Jr.  
  8.  
  9. newname[Contact.NAME_PREFIX] = "Dr.";  
  10.  
  11. newname[Contact.NAME_SUFFIX] = "Jr.";  
  12.  
  13. contact.setStringArray(Contact.NAME, 0, Contact.ATTR_NONE, newname);  
  14.  

对于支持多个值的字段,在将另外一个值加入之前,先验证其没有超过值的最大个数。

  1. if (contact.countValues(Contact.EMAIL) < contactList.maxValues(Contact.EMAIL))  
  2.  
  3. {  
  4.  
  5.     contact.addString(Contact.EMAIL,Contact.ATTR_NONE, aisha.wahl@blackberry.com");  
  6.  
  7. } 

保存一个联系人信息

调用commit().在提交修改之前,为判断任何联系人字段自从最后保存以来是否已经发生变化,调用isModified().

  1. if(contact.isModified()) {  
  2.  
  3.     contact.commit();  
  4.  
  5. }  

获取联系人信息

调用PIMList.Items()

（注:当你调用PIMList.Items()获取一个列表项的迭代时,列表项的顺序没有定义.如果必要,你的应用程序必须将它们排序.）

对于一个特定的联系人,调用PIMItem.getFields()获取一个拥有数据的字段ID的数组.调用PIMItem.getString()获取字段值.

  1. ContactList contactList = (ContactList)PIM.getInstance().openPIMList(  
  2.  
  3.        PIM.CONTACT_LIST, PIM.READ_WRITE);  
  4.  
  5. Enumeration enum = contactList.items();  
  6.  
  7. while (enum.hasMoreElements()) {  
  8.  
  9.     Contact c = (Contact)enum.nextElement();  
  10.  
  11.     int[] fieldIds = c.getFields();  
  12.  
  13.     int id;  
  14.  
  15.     for(int index = 0; index < fieldIds.length; ++index) {  
  16.  
  17.        id = fieldIds[index];  
  18.  
  19.        if(c.getPIMList().getFieldDataType(id) == Contact.STRING)  
  20.  
  21.        {  
  22.  
  23.            for(int j=0; j < c.countValues(id); ++j) {  
  24.  
  25.               String value = c.getString(id, j);  
  26.  
  27.               System.out.println(c.getPIMList().getFieldLabel(id) + "=" + value);  
  28.  
  29.               }  
  30.  
  31.        }  
  32.  
  33.     }  
  34.  
  35. }  
  36.  

将一个联系人转化为序列化格式

为了导入或导出PIM项数据,使用一个输出写入流将BlackBerry设备中的任务导出为一个支持的序列化格式,例如vCard.

为了获取一个支持的格式的字符串数组,调用PIM.supportedSerialFormats(),并指定列表类型(PIM.Contact_LIST).为了将一个项写到一个支持的序列化格式里,调用toSerialFormat().

（注:当写到一个输出流时enc参数指定了字符编码格式.支持的字符编码格式包括"UTF8," "ISO-8859-1," 和 "UTF-16BE."此参数不能为空.）

  1. ContactList contactList = (ContactList)PIM.getInstance().openPIMList(  
  2.  
  3.        PIM.CONTACT_LIST, PIM.READ_ONLY);  
  4.  
  5. String[] dataFormats = PIM.getInstance().supportedSerialFormats(  
  6.  
  7.        PIM.CONTACT_LIST);  
  8.  
  9. ByteArrayOutputStream byteStream = new ByteArrayOutputStream();  
  10.  
  11. Enumeration e = contactList.items();  
  12.  
  13. while (e.hasMoreElements()) {  
  14.  
  15.     Contact c = (Contact)e.nextElement();  
  16.  
  17.     PIM.getInstance().toSerialFormat(c, byteStream, "UTF8", dataFormats[0]);  
  18.  
  19. }  
  20.  

导入一个联系人

为了返回一组PIM项,调用fromSerialFormat().使用PIM项为了创建一个新的联系人,调用ContactList.importContact()

（注:当写到一个输出流时enc参数指定了字符编码格式.支持的字符编码格式包括"UTF8," "ISO-8859-1," 和 "UTF-16BE."此参数不能为空.）

  1. // Import contact from vCard.  
  2.  
  3. ByteArrayInputStream is = new ByteArrayInputStream(outputStream.toByteArray());  
  4.  
  5. PIMItem[] pi = PIM.getInstance().fromSerialFormat(istream, "UTF8");  
  6.  
  7. ContactList contactList = (ContactList)PIM.getInstance()  
  8.  
  9.                         .openPIMList(PIM.CONTACT_LIST, PIM.READ_WRITE);  
  10.  
  11. Contact contact2 = contactList.importContact((Contact)pi[0]);  
  12.  
  13. contact2.commit();  
  14.  

删除一个联系人

在联系人列表上调用removeContact()方法.

  1. contactList.removeContact(contact); 

关闭一个联系人列表

调用close().

  1. try {  
  2.  
  3.     contactList.close();  
  4.  
  5. }  
  6.  
  7. catch(PIMException e) {  
  8.  
  9.     Dialog.alert(e.toString());  
  10.  
  11. }  
  12.  

代码实例

下面的实例描述了如何显示一个屏幕来允许用户增加一个新的联系人到地址本中.在你保存一个联系人之后,打开地址本确认该联系人是否已经保存.


例: ContactsDemo.java

  1. /**  
  2.  
  3. * ContactsDemo.java  
  4.  
  5. * Copyright (C) 2002-2005 Research In Motion Limited.  
  6.  
  7. */ 
  8.  
  9. package com.rim.samples.docs.contactsdemo;  
  10.  
  11. import java.io.*;  
  12.  
  13. import java.util.*;  
  14.  
  15. import javax.microedition.pim.*;  
  16.  
  17. import net.rim.device.api.ui.*;  
  18.  
  19. import net.rim.device.api.ui.component.*;  
  20.  
  21. import net.rim.device.api.ui.container.*;  
  22.  
  23. import net.rim.device.api.i18n.*;  
  24.  
  25. import net.rim.device.api.system.*;  
  26.  
  27. import net.rim.device.api.util.*;  
  28.  
  29. import com.rim.samples.docs.baseapp.*;  
  30.  
  31. import net.rim.blackberry.api.pdap.*;  
  32.  
  33.    
  34.  
  35. public final class ContactsDemo extends BaseApp {  
  36.  
  37.     private ContactScreen _contactScreen;  
  38.  
  39.     public static void main(String[] args) {  
  40.  
  41.        new ContactsDemo().enterEventDispatcher();  
  42.  
  43.     }  
  44.  
  45.     public ContactsDemo() {  
  46.  
  47.        _contactScreen = new ContactScreen();  
  48.  
  49.        pushScreen(_contactScreen);  
  50.  
  51.     }  
  52.  
  53.     protected void onExit() {  
  54.  
  55.     }  
  56.  
  57.      
  58.  
  59. // Inner class. Creates a Screen to add a contact.  
  60.  
  61. public static final class ContactScreen extends MainScreen {  
  62.  
  63.     private EditField _first, _last, _email, _phone, _pin;  
  64.  
  65.     private SaveMenuItem _saveMenuItem;  
  66.  
  67.      
  68.  
  69.     private class SaveMenuItem extends MenuItem {  
  70.  
  71.        private SaveMenuItem() {  
  72.  
  73.            super(null, 0, 100000, 5);  
  74.  
  75.            }  
  76.  
  77.         
  78.  
  79.        public String toString() {  
  80.  
  81.            return "Save";  
  82.  
  83.            }  
  84.  
  85.        public void run() {  
  86.  
  87.            onSave();  
  88.  
  89.            }  
  90.  
  91.        }  
  92.  
  93.      
  94.  
  95.     public ContactScreen() {  
  96.  
  97.        _saveMenuItem = new SaveMenuItem();  
  98.  
  99.        setTitle(new LabelField("Contacts Demo",  
  100.  
  101.               LabelField.ELLIPSIS | LabelField.USE_ALL_WIDTH));  
  102.  
  103.        _first = new EditField("First Name: ", "");  
  104.  
  105.        add(_first);  
  106.  
  107.        _last = new EditField("Last Name: ", "");  
  108.  
  109.        add(_last);  
  110.  
  111.        _email = new EditField("Email Address: ", "",  
  112.  
  113.               BasicEditField.DEFAULT_MAXCHARS, BasicEditField.FILTER_EMAIL);  
  114.  
  115.        add(_email);  
  116.  
  117.        _phone = new EditField("Work Phone: ", "",  
  118.  
  119.               BasicEditField.DEFAULT_MAXCHARS, BasicEditField.FILTER_PHONE);  
  120.  
  121.        add(_phone);  
  122.  
  123.        _pin = new EditField("PIN:", "", 8, BasicEditField.FILTER_HEXADECIMAL);  
  124.  
  125.        add(_pin);  
  126.  
  127.        }  
  128.  
  129.      
  130.  
  131.     protected boolean onSave() {  
  132.  
  133.        String firstName = _first.getText();  
  134.  
  135.        String lastName = _last.getText();  
  136.  
  137.        String email = _email.getText();  
  138.  
  139.        String phone = _phone.getText();  
  140.  
  141.        String pin = _pin.getText();  
  142.  
  143.         
  144.  
  145.        // Verify that a first or last name and email has been entered.  
  146.  
  147.        if ((firstName.equals("") && lastName.equals("")) || email.equals("")) {  
  148.  
  149.            Dialog.inform("You must enter a name and an email address!");  
  150.  
  151.            return false;  
  152.  
  153.            }  
  154.  
  155.        else {  
  156.  
  157.            try {  
  158.  
  159.               ContactList contactList = (ContactList)PIM.getInstance().  
  160.  
  161.                             openPIMList(PIM.CONTACT_LIST, PIM.WRITE_ONLY);  
  162.  
  163.               Contact contact = contactList.createContact();  
  164.  
  165.               String[] name = new String[contactList.stringArraySize(Contact.NAME)];  
  166.  
  167.                
  168.  
  169.               // Add values to PIM item.  
  170.  
  171.                
  172.  
  173.               if (!firstName.equals("")) {  
  174.  
  175.                   name[Contact.NAME_GIVEN] = firstName;  
  176.  
  177.                   }  
  178.  
  179.               if (!lastName.equals("")) {  
  180.  
  181.                   name[Contact.NAME_FAMILY] = lastName;  
  182.  
  183.                   }  
  184.  
  185.               contact.addStringArray(Contact.NAME, Contact.ATTR_NONE, name);  
  186.  
  187.               contact.addString(Contact.EMAIL, Contact.ATTR_HOME, email);  
  188.  
  189.               contact.addString(Contact.TEL, Contact.ATTR_WORK, phone);  
  190.  
  191.               if (contactList.isSupportedField(BlackBerryContact.PIN)) {  
  192.  
  193.                   contact.addString(BlackBerryContact.PIN, Contact.ATTR_NONE, pin);  
  194.  
  195.                   }  
  196.  
  197.                
  198.  
  199.               // Save data to address book.  
  200.  
  201.               contact.commit();  
  202.  
  203.               // Reset UI fields.  
  204.  
  205.               _first.setText("");  
  206.  
  207.               _last.setText("");  
  208.  
  209.               _email.setText("");  
  210.  
  211.               _phone.setText("");  
  212.  
  213.               _pin.setText("");  
  214.  
  215.               return true;  
  216.  
  217.               }  
  218.  
  219.            catch (PIMException e) {  
  220.  
  221.               return false;  
  222.  
  223.               }  
  224.  
  225.            }  
  226.  
  227.        }  
  228.  
  229.      
  230.  
  231.     protected void makeMenu(Menu menu, int instance) {  
  232.  
  233.        menu.add(_saveMenuItem);  
  234.  
  235.        super.makeMenu(menu, instance);  
  236.  
  237.        }  
  238.  
  239.     }  
  240.  
  241. }  
  242.  
  243.    
  244. <!--[if !vml]--><!--[endif]-->  
  245.  

使用任务

使用一个ToDoList类的实例来存储任务或计划项的列表. 为每个任务创建一个或多个ToDo对象来存储数据,例如主题(summary),优先级,持续的时间以及状态.

打开一个任务列表

调用PIM.openPIMList(),将列表的类型作为open (PIM.TODO_LIST)的参数

,并且指定访问的模式(READ_WRITE, READ_ONLY,或WRITE_ONLY)打开列表.

  1. ToDoList todoList = null;  
  2.  
  3. try {  
  4.  
  5.     todoList = (ToDoList)PIM.getInstance().openPIMList(PIM.TODO_LIST, PIM.READ_WRITE);  
  6.  
  7. }  
  8.  
  9. catch (PimException e) {  
  10.  
  11.     //an error occurred  
  12.  
  13.     return;  
  14.  
  15. }  
  16.  

创建一个任务

调用任务列表上的createToDo().

  1. ToDo task = todoList.createToDo();  
  2.  
  3. toSerialFormat().  
  4.  
  5. <!--[if !vml]--><!--[endif]-->  

（注:新增加的任务不会存到数据库,直到你提交它.“保存一个任务”.）

增加任务信息

ToDo类定义字段来存储数据,例如SUMMARY,PRIORITY以及DUE.每个字段都有一个特定的数据类型,你可以使用PIMList.getFieldDataType(int)调用它们.因为取决于字段的数据类型,调用以下方法设置数据:

addString(), addDate(), addInt(), addBoolean(), 或 addBinary().

在你设置或获取一个字段之前, 调用isSupportedField(int)来验证此项是否支持字段.

  1. if (todoList.isSupportedField(ToDo.SUMMARY)) {  
  2.  
  3.     task.addString(ToDo.SUMMARY, ToDo.ATTR_NONE, "Create project plan");  
  4.  
  5. }  
  6.  
  7. if (todoList.isSupportedField(ToDo.DUE)) {  
  8.  
  9.     Date date = new Date();  
  10.  
  11.     task.addDate(ToDo.DUE, ToDo.ATTR_NONE, (date + 17280000));  
  12.  
  13. }  
  14.  
  15. if (todoList.isSupportedField(ToDo.NOTE)) {  
  16.  
  17.     task.addString(ToDo.NOTE, ToDo.ATTR_NONE, "Required for meeting");  
  18.  
  19. }  
  20.  
  21. if (todoList.isSupportedField(ToDo.PRIORITY)) {  
  22.  
  23.     task.addInt(Todo.PRIORITY, ToDo.ATTR_NONE, 2);  
  24.  
  25. }  
  26.  

设置任务状态

使用PIM扩展字段ToDo.EXTENDED_FIELD_MIN_VALUE + 9.

常量

值

STATUS_NOT_STARTED

1

STATUS_IN_PROGRESS

2

STATUS_COMPLETED

3

STATUS_WAITING

4

STATUS_DEFERRED

5

task.addInt(ToDo.EXTENDED_FIELD_MIN_VALUE + 9, ToDo.ATTR_NONE, 2);

修改任务信息

为了用一个新值替换一个存在的值,调用合适的set方法,例如setString().为了判断一个字段已经设置其值,调用countValues().

（注:如果你调用一个增加方法,例如addString(),当一个值存在时,将抛出一个FieldFullException异常.使用相应的set方法,如setString()改变一个存在的值.）

  1. if (task.countValues(ToDo.SUMMARY) > 0) {  
  2.  
  3.     task.setString(ToDo.SUMMARY, 0, ToDo.ATTR_NONE, "Review notes");  
  4.  
  5. }  
  6.  

保存一个任务

调用commit()方法.在你保存之前,为了决定自从上一次保存任务之后任何字段是否发生变化,调用isModified().

  1. if(task.isModified())  
  2.  
  3. {  
  4.  
  5.     task.commit();  
  6.  
  7. }  
  8.  

获取任务信息

获取一个迭代

调用任务列表上的PIMList.items().

  1. ToDoList todoList = (ToDoList)PIM.getInstance().openToDoList(  
  2.  
  3.        PIM.TODO_LIST, PIM.READ_ONLY);  
  4.  
  5. Enumeration enum = todoList.items(); 

获取一个任务的字段ID以及值

对于某个特定的ToDo项,为获取一组包含其数据的字段ID，调用PIMItem.getFields().

为获取字段值,调用PIMItem.getString().

  1. while (enum.hasMoreElements()) {  
  2.  
  3.     ToDo task = (ToDo)enum.nextElement();  
  4.  
  5. }  
  6.  
  7. int[] fieldIds = task.getFields();  
  8.  
  9. int id;  
  10.  
  11. for(int index = 0; index < fieldIds.length; ++index) {  
  12.  
  13.     id = fieldIds[index];  
  14.  
  15.     if(task.getPIMList().getFieldDataType(id) == STRING) {  
  16.  
  17.        for(int j=0; j < task.countValues(id); ++j) {  
  18.  
  19.            String value = task.getString(id, j);  
  20.  
  21.            System.out.println(task.getFieldLable(id) + "=" + value);  
  22.  
  23.            }  
  24.  
  25.        }  
  26.  
  27. }  
  28.  

#p#将一个任务转化为序列化格式

为了导入或导出PIM项数据,使用一个输出写入流将BlackBerry设备中的任务导出为一个支持的序列化格式,例如vCard.

为了获取一个支持的格式的字符串数组,调用PIM.supportedSerialFormats(),并指定列表类型(PIM.TODO_LIST).

（注:当写到一个输出流时enc参数指定了字符编码格式.支持的字符编码格式包括"UTF8," "ISO-8859-1," 和 "UTF-16BE."此参数不能为空.）

  1. ToDoList todoList = (ToDoList)PIM.getInstance().openPIMList(  
  2.  
  3.        PIM.TODO_LIST, PIM.READ_ONLY);  
  4.  
  5. ByteArrayOutputStream byteStream = new ByteArrayOutputStream();  
  6.  
  7. String[] dataFormats = PIM.getInstance().supportedSerialFormats(PIM.TODO_LIST);  
  8.  
  9. Enumeration e = todoList.items();  
  10.  
  11. while (e.hasMoreElements()) {  
  12.  
  13.     ToDo task = (ToDo)e.nextElement();  
  14.  
  15.     PIM.getInstance().toSerialFormat(task, byteStream, "UTF8", dataFormats[0]);  
  16.  
  17. } 

导入一个任务

为返回一组PIMItem对象,调用fromSerialFormat().

使用PIM项创建一个新的任务,调用ToDoList.importToDo().

（注:当写到一个输出流时enc参数指定了字符编码格式.支持的字符编码格式包括"UTF8," "ISO-8859-1," 和 "UTF-16BE."此参数不能为空.）

  1. String[] dataFormats = PIM.toDoSerialFormats();  
  2.  
  3.    
  4.  
  5. // Write task to serial format.  
  6.  
  7. ByteArrayOutputStream os = new ByteArrayOutputStream();  
  8.  
  9. PIM.getInstance().toSerialFormat(task, os, "UTF8", dataFormats[0]);  
  10.  
  11. // Import task from serial format.  
  12.  
  13. ByteArrayInputStream is = new ByteArrayInputStream(outputStream.toByteArray());  
  14.  
  15. PIMItem[] pi = PIM.getInstance().fromSerialFormat(is, "UTF8");  
  16.  
  17. ToDoList todoList = (ToDoList)PIM.getInstance().openPIMList(  
  18.  
  19.        PIM.TODO_LIST, PIM.READ_WRITE);  
  20.  
  21. ToDo task2 = todoList.importToDo((ToDo)pi[0]); 

提示: importToDo()方法保存一个任务,因此你不必要调用commit()方法.

删除一个任务

调用任务列表上的removeToDo().

  1. todoList.removeToDo(task); 

关闭一个任务列表

调用todoList.close().务必捕捉应用的异常:

  1. try {  
  2.  
  3.     todoList.close();  
  4.  
  5.     }  
  6.  
  7. catch (PimException e) {  
  8.  
  9.     // Handle exception.  
  10.  
  11. }  
  12.  

代码实例

例: TaskDemo.java

  1. /**  
  2.  
  3. * TaskDemo.java  
  4.  
  5. * Copyright (C) 2002-2005 Research In Motion Limited.  
  6.  
  7. */ 
  8.  
  9. package com.rim.samples.docs.taskdemo;  
  10.  
  11. import java.io.*;  
  12.  
  13. import java.util.*;  
  14.  
  15. import javax.microedition.pim.*;  
  16.  
  17. import net.rim.device.api.ui.*;  
  18.  
  19. import net.rim.device.api.ui.component.*;  
  20.  
  21. import net.rim.device.api.ui.container.*;  
  22.  
  23. import net.rim.device.api.i18n.*;  
  24.  
  25. import net.rim.device.api.system.*;  
  26.  
  27. import net.rim.device.api.util.*;  
  28.  
  29. import com.rim.samples.docs.baseapp.*;  
  30.  
  31.    
  32.  
  33. public final class TaskDemo extends BaseApp {  
  34.  
  35.     private TaskScreen _taskScreen;  
  36.  
  37.     public static void main(String[] args) {  
  38.  
  39.        new TaskDemo().enterEventDispatcher();  
  40.  
  41.        }  
  42.  
  43.      
  44.  
  45.     private TaskDemo() {  
  46.  
  47.        _taskScreen = new TaskScreen();  
  48.  
  49.        pushScreen(_taskScreen);  
  50.  
  51.        }  
  52.  
  53.      
  54.  
  55.     protected void onExit() {  
  56.  
  57.         
  58.  
  59.     }  
  60.  
  61.      
  62.  
  63.     public final static class TaskScreen extends MainScreen {  
  64.  
  65.        // Members.  
  66.  
  67.        private EditField _summary, _note;  
  68.  
  69.        private DateField _due;  
  70.  
  71.        private ObjectChoiceField _priority, _status;  
  72.  
  73.        private SaveMenuItem _saveMenuItem;  
  74.  
  75.        private class SaveMenuItem extends MenuItem {  
  76.  
  77.            private SaveMenuItem() {  
  78.  
  79.               super(null, 0, 100000, 5);  
  80.  
  81.               }  
  82.  
  83.            public String toString() {  
  84.  
  85.               return "Save";  
  86.  
  87.               }  
  88.  
  89.            public void run() {  
  90.  
  91.               onSave();  
  92.  
  93.               }  
  94.  
  95.        }  
  96.  
  97.         
  98.  
  99.        public TaskScreen() {  
  100.  
  101.            _saveMenuItem = new SaveMenuItem();  
  102.  
  103.            setTitle(new LabelField("Tasks Demo",  
  104.  
  105.                   LabelField.ELLIPSIS | LabelField.USE_ALL_WIDTH));  
  106.  
  107.            _summary = new EditField("Task Summary: ", "");  
  108.  
  109.            add(_summary);  
  110.  
  111.             
  112.  
  113.            // In TODO.Priority, 0 to 9 is highest to lowest priority.  
  114.  
  115.            String[] choices = {"High", "Normal", "Low"};  
  116.  
  117.            _priority = new ObjectChoiceField("Priority: ", choices, 1);  
  118.  
  119.            add(_priority);  
  120.  
  121.            String[] status = { "Not Started", "In Progress", "Completed",  
  122.  
  123.                               "Waiting on someone else", "Deferred" };  
  124.  
  125.            _status = new ObjectChoiceField("Status: ", status, 0);  
  126.  
  127.            add(_status);  
  128.  
  129.            _due = new DateField("Due: ", System.currentTimeMillis() + 3600000,  
  130.  
  131.                   DateField.DATE_TIME);  
  132.  
  133.            add(_due);  
  134.  
  135.            _note = new EditField("Extra Notes: ", "");  
  136.  
  137.            add(_note);  
  138.  
  139.        }  
  140.  
  141.         
  142.  
  143.        protected boolean onSave() {  
  144.  
  145.            try {  
  146.  
  147.               ToDoList todoList = (ToDoList)PIM.getInstance().  
  148.  
  149.               openPIMList(PIM.TODO_LIST, PIM.WRITE_ONLY);  
  150.  
  151.               ToDo task = todoList.createToDo();  
  152.  
  153.               task.addDate(ToDo.DUE, ToDo.ATTR_NONE, _due.getDate());  
  154.  
  155.               task.addString(ToDo.SUMMARY, ToDo.ATTR_NONE, _summary.getText());  
  156.  
  157.               task.addString(ToDo.NOTE, ToDo.ATTR_NONE, _note.getText());  
  158.  
  159.               task.addInt(ToDo.PRIORITY, ToDo.ATTR_NONE,  
  160.  
  161.                      _priority.getSelectedIndex());  
  162.  
  163.                
  164.  
  165.               // ToDo.EXTENDED_FIELD_MIN_VALUE + 9 represents status.  
  166.  
  167.               // Add 1 to selected index so that values are correct.  
  168.  
  169.               // See the RIM Implementation Notes in the API docmentation for ToDo.  
  170.  
  171.               task.addInt(ToDo.EXTENDED_FIELD_MIN_VALUE + 9, ToDo.ATTR_NONE,  
  172.  
  173.                      _status.getSelectedIndex() + 1);  
  174.  
  175.                
  176.  
  177.               // Save task to handheld tasks.  
  178.  
  179.               task.commit();  
  180.  
  181.               _summary.setText("");  
  182.  
  183.               _note.setText("");  
  184.  
  185.               _due.setDate(null);  
  186.  
  187.               _priority.setSelectedIndex(1); // Reset to “Normal” priority.  
  188.  
  189.               _status.setSelectedIndex(0); // Reset to “Not Started” status.  
  190.  
  191.               return true;  
  192.  
  193.               }  
  194.  
  195.            catch (PIMException e) {  
  196.  
  197.               return false;  
  198.  
  199.                }  
  200.  
  201.            }  
  202.  
  203.         
  204.  
  205.        protected void makeMenu(Menu menu, int instance) {  
  206.  
  207.            menu.add(_saveMenuItem);  
  208.  
  209.            super.makeMenu(menu, instance);  
  210.  
  211.            }  
  212.  
  213.        }  
  214.  
  215. }  
  216.  

使用日历

使用一个EventList接口的实例访问日历.为一个约会创建一个或多个对象存储信息.对于每个事件.你可以存储类似主题,地点,开始和结束事件,以及提醒通知的数据.

打开一个事件列表

在可以增加事件之前你必须创建一个EventList.调用PIM.openPIMList().

调用PIM.openPIMList(),将列表的类型作为open (PIM.EVENT_LIST)的参数

,并且指定访问的模式(READ_WRITE, READ_ONLY,或WRITE_ONLY)打开列表.

  1. EventList eventList = null;  
  2.  
  3. try {  
  4.  
  5.     eventList = (EventList)PIM.getInstance().openPIMList(  
  6.  
  7.            PIM.EVENT_LIST, PIM.READ_WRITE);  
  8.  
  9. }  
  10.  
  11. catch (PimException e) {  
  12.  
  13.     // Handle exception.  
  14.  
  15. }  

创建一个约会

调用一个事件列表上的createEvent().

  1. Event event = eventList.createEvent(); 

（注:约会不会加到数据库中,直到你提交它.“保存一个约会”.）

增加约会信息

Event类定义了存储数据的字段,例如SUMMARY, LOCATION, START, END, 以及 ALARM.每个字段都有一个指定的类型,你可以调用PIMList.getFieldDataType(int)获得数据类型.

因为取决于字段的数据类型,调用以下方法设置数据:

addString(), addDate(), addInt(), addBoolean(), 或 addBinary().

在你设置或获取一个字段之前, 调用isSupportedField(int)来验证此项是否支持字段.

  1. if (event.isSupportedField(Event.SUMMARY)) {  
  2.  
  3.     event.addString(Event.SUMMARY, Event.ATTR_NONE, "Meet with customer");  
  4.  
  5. }  
  6.  
  7. if (event.isSupportedField(Event.LOCATION)) {  
  8.  
  9.     event.addString(Event.LOCATION, Event.ATTR_NONE, "Conference Center");  
  10.  
  11. }  
  12.  
  13. Date start = new Date(System.currentTimeMillis() + 8640000);  
  14.  
  15. if (event.isSupportedField(Event.START)) {  
  16.  
  17.     event.addDate(Event.START, Event.ATTR_NONE, start);  
  18.  
  19. }  
  20.  
  21. if (event.isSupportedField(Event.END)) {  
  22.  
  23.     event.addDate(Event.END, Event.ATTR_NONE, start + 72000000);  
  24.  
  25. }  
  26.  
  27. if (event.isSupportedField(Event.ALARM)) {  
  28.  
  29.     if (event.countValues(Event.ALARM) > 0) {  
  30.  
  31.         event.removeValue(Event.ALARM,0);  
  32.  
  33.        event.setInt(Event.ALARM, 0, Event.ATTR_NONE, 396000);  
  34.  
  35.        }  
  36.  
  37. }  
  38.  

#p#创建一个重复发生(recurring)的约会

为了定义一个重复发生的约会,使用一个RepeatRule对象.RepeatRule类为你可以设置的属性和值定义了字段,例如COUNT, FREQUENCY,和 INTERVAL.

为了获取一组支持的字段,调用RepeatRule.getFields().

定义重复模式

调用新的RepeatRule对象上的setInt(int, int) 或setDate(int, int, int, long).

  1. RepeatRule recurring = new RepeatRule();  
  2.  
  3. recurring.setInt(RepeatRule.FREQUENCY, RepeatRule.MONTHLY);  
  4.  
  5. recurring.setInt(RepeatRule.DAY_IN_MONTH, 14);  

指派约会一个重复模式

调用一个事件上的setRepeat(RepeatRule).

  1. EventList eventList = (EventList)PIM.getInstance().openPIMList(  
  2.  
  3. PIM.EVENT_LIST, PIM.READ_WRITE);  
  4.  
  5. Event event = eventList.createEvent();  
  6.  
  7. event.setRepeat(recurring);  
  8.  

修改约会信息

为使用一个新值代替已经存在的值,调用合适的set方法,例如setString().

为判断一个字段是否已经设置了一个值,调用countValues().

（注:当一个值已经存在时,如果你调用一个增加方法,抛出一个FieldFullException.使用相应的set方法,例如setString(),来修改一个已经存在的值.）

  1. if (event.countValues(Event.LOCATION) > 0) {  
  2.  
  3.     event.setString(Event.LOCATION, 0, Event.ATTR_NONE, "Board Room");  
  4.  
  5. } 

保存一个约会

提示: importEvent()方法保存一个约会,因此你没有必要调用commit().

调用commit()方法.在你保存之前,为了决定自从上一次保存任务之后任何字段是否发生变化,调用isModified().

  1. if(event.isModified()) {  
  2.  
  3.     event.commit();  
  4.  
  5. }  

获取约会信息

获取一个约会的迭代

调用PIMList.items().

  1. EventList eventList = (EventList)PIM.getInstance().openPIMList(  
  2.  
  3.        PIM.EVENT_LIST, PIM.READ_ONLY);  
  4.  
  5. Enumeration e = eventList.items(); 

获取字段的ID和值

对于某个特定的ToDo项,为获取一组包含其数据的字段ID.调用PIMItem.getFields().

获取字段值,调用PIMItem.getString().

  1. while (e.hasMoreElements()) {  
  2.  
  3.     Event event = (Event)e.nextElement();  
  4.  
  5.     int[] fieldIds = event.getFields();  
  6.  
  7.     int id;  
  8.  
  9.     for(int index = 0; index < fieldIds.length; ++index) {  
  10.  
  11.        id = fieldIds[index];  
  12.  
  13.        if(e.getPIMList().getFieldDataType(id) == STRING) {  
  14.  
  15.            for(int j=0; j < event.countValues(id); ++j) {  
  16.  
  17.               String value = event.getString(id, j);  
  18.  
  19.               System.out.println(event.getFieldLable(id) + "=" + value);  
  20.  
  21.               }  
  22.  
  23.            }  
  24.  
  25.        }  
  26.  
  27. }  

将约会转化为一个序列化格式

为了导入或导出PIM项数据,使用一个输出写入流将BlackBerry设备中的任务导出为一个支持的序列化格式,例如iCal.

为了获取一个支持的格式的字符串数组,调用PIM.supportedSerialFormats(),并指定列表类型(PIM.EVENT_LIST).

将一个项写为序列化格式

调用toSerialFormat().

  1. EventList eventList = (EventList)PIM.getInstance().openPIMList(  
  2.  
  3.        PIM.EVENT_LIST, PIM.READ_ONLY );  
  4.  
  5. ByteArrayOutputStream bytestream = new ByteArrayOutputStream();  

（注:当写到一个输出流时enc参数指定了字符编码格式.支持的字符编码格式包括"UTF8," "ISO-8859-1," 和 "UTF-16BE."此参数不能为空.）

  1. Enumeration e = eventList.items();  
  2.  
  3. while (e.hasMoreElements()) {  
  4.  
  5.     Event event = (Event)e.nextElement();  
  6.  
  7.     PIM.getInstance().toSerialFormat(event, byteStream, "UTF8", dataFormats[0]);  
  8.  
  9. }  

导入一个约会

为了返回一组PIMItem对象,调用fromSerialFormat(java.io.InputStream is, java.lang.String enc).

为了新增一个约会,调用EventList.importEvent().

（注:当写到一个输出流时enc参数指定了字符编码格式.支持的字符编码格式包括"UTF8," "ISO-8859-1," 和 "UTF-16BE."此参数不能为空.）

  1. // Convert an existing appointment into a iCal and then import the iCal as a new  
  2.  
  3. // appointment.  
  4.  
  5. String[] dataFormats = PIM.eventSerialFormats();  
  6.  
  7. // Write appointment to iCal.  
  8.  
  9. ByteArrayOutputStream os = new ByteArrayOutputStream();  
  10.  
  11. PIM.getInstance().toSerialFormat(event, os, "UTF8", dataFormats[0]);  
  12.  
  13. // Import appointment from iCal.  
  14.  
  15. ByteArrayInputStream is = new ByteArrayInputStream(outputStream.toByteArray());  
  16.  
  17. PIMItem[] pi = PIM.getInstance().fromSerialFormat(is, "UTF8");  
  18.  
  19. EventList eventList = (EventList)PIM.getInstance().openPIMList(  
  20.  
  21.        PIM.EVENT_LIST, PIM.READ_WRITE);  
  22.  
  23. Event event2 = eventList.importEvent((Event)pi[0]);  

关闭一个事件列表

调用 close().

  1. try {  
  2.  
  3.     eventList.close();  
  4.  
  5. }  
  6.  
  7. catch (PimException e) {  
  8.  
  9.     // Handle exception.  
  10.  
  11. } 

代码实例

下面的实例显示了一个屏幕,它允许用户在日历中创建一个新的,重复的约会.你可以将此例和ContactsDemo.java结合起来允许用户邀请参与者到这个会议中.

例:EventDemo.java

  1. /**  
  2.  
  3. * EventDemo.java  
  4.  
  5. * Copyright (C) 2002-2005 Research In Motion Limited.  
  6.  
  7. */ 
  8.  
  9. package com.rim.samples.docs.eventdemo;  
  10.  
  11. import java.io.*;  
  12.  
  13. import java.util.*;  
  14.  
  15. import javax.microedition.pim.*;  
  16.  
  17. import net.rim.device.api.ui.*;  
  18.  
  19. import net.rim.device.api.ui.component.*;  
  20.  
  21. import net.rim.device.api.ui.container.*;  
  22.  
  23. import net.rim.device.api.i18n.*;  
  24.  
  25. import net.rim.device.api.system.*;  
  26.  
  27. import net.rim.device.api.util.*;  
  28.  
  29. import com.rim.samples.docs.baseapp.*;  
  30.  
  31.  
  32.  
  33. public final class EventDemo extends BaseApp {  
  34.  
  35.     private EventScreen _eventScreen;  
  36.  
  37.     public static void main(String[] args) {  
  38.  
  39.        new EventDemo().enterEventDispatcher();  
  40.  
  41.        }  
  42.  
  43.      
  44.  
  45.     private EventDemo() {  
  46.  
  47.        _eventScreen = new EventScreen();  
  48.  
  49.        pushScreen(_eventScreen);  
  50.  
  51.        }  
  52.  
  53.      
  54.  
  55.     protected void onExit() {  
  56.  
  57.         
  58.  
  59.     }  
  60.  
  61.      
  62.  
  63.     public final static class EventScreen extends MainScreen {  
  64.  
  65.        private EditField _subject, _location;  
  66.  
  67.        private SaveMenuItem _saveMenuItem;  
  68.  
  69.        private DateField _startTime, _endTime;  
  70.  
  71.        private ObjectChoiceField _repeat;  
  72.  
  73.        private Event event;  
  74.  
  75.         
  76.  
  77.        private class SaveMenuItem extends MenuItem {  
  78.  
  79.            public SaveMenuItem() {  
  80.  
  81.               super(null, 0, 100000, 5);  
  82.  
  83.               }  
  84.  
  85.            public String toString() {  
  86.  
  87.               return "Save";  
  88.  
  89.               }  
  90.  
  91.            public void run() {  
  92.  
  93.               onSave();  
  94.  
  95.               }  
  96.  
  97.        }  
  98.  
  99.         
  100.  
  101.        public EventScreen() {  
  102.  
  103.            _saveMenuItem = new SaveMenuItem();  
  104.  
  105.            setTitle(new LabelField("Event Demo", LabelField.ELLIPSIS |  
  106.  
  107.                   LabelField.USE_ALL_WIDTH) );  
  108.  
  109.            _subject = new EditField("Subject: ", "");  
  110.  
  111.            add(_subject);  
  112.  
  113.            _location = new EditField("Location: ","");  
  114.  
  115.            add(_location);  
  116.  
  117.            _startTime = new DateField("Start: ", System.currentTimeMillis() +  
  118.  
  119.                   3600000, DateField.DATE_TIME);  
  120.  
  121.            _endTime = new DateField("End: ", System.currentTimeMillis() +  
  122.  
  123.                   7200000, DateField.DATE_TIME);  
  124.  
  125.            add(new SeparatorField());  
  126.  
  127.            add(_startTime);  
  128.  
  129.            add(_endTime);  
  130.  
  131.            add(new SeparatorField());  
  132.  
  133.            String[] choices = {"None", "Daily", "Weekly", "Monthly", "Yearly"};  
  134.  
  135.            _repeat = new ObjectChoiceField(“Recurrence: “, choices, 0);  
  136.  
  137.            add(_repeat);  
  138.  
  139.            }  
  140.  
  141.         
  142.  
  143.        protected boolean onSave() {  
  144.  
  145.            try {  
  146.  
  147.               EventList eventList = (EventList)PIM.getInstance().  
  148.  
  149.               openPIMList(PIM.EVENT_LIST, PIM.WRITE_ONLY);  
  150.  
  151.               event = eventList.createEvent();  
  152.  
  153.               event.addString(Event.SUMMARY, PIMItem.ATTR_NONE,  
  154.  
  155.                      _subject.getText());  
  156.  
  157.               event.addString(Event.LOCATION, PIMItem.ATTR_NONE,  
  158.  
  159.                      _location.getText());  
  160.  
  161.               event.addDate(Event.END, PIMItem.ATTR_NONE, _endTime.getDate());  
  162.  
  163.               event.addDate(Event.START, PIMItem.ATTR_NONE,startTime.getDate());  
  164.  
  165.               if(_repeat.getSelectedIndex() != 0) {  
  166.  
  167.                   event.setRepeat(setRule());  
  168.  
  169.                   }  
  170.  
  171.                
  172.  
  173.               // Save the appointment to the Calendar.  
  174.  
  175.               event.commit();  
  176.  
  177.               //reset fields on screen  
  178.  
  179.               _subject.setText("");  
  180.  
  181.               _location.setText("");  
  182.  
  183.               _endTime.setDate(null);  
  184.  
  185.               _startTime.setDate(null);  
  186.  
  187.               _repeat.setSelectedIndex(0);  
  188.  
  189.               return true;  
  190.  
  191.               }  
  192.  
  193.            catch (PIMException e) {  
  194.  
  195.                System.err.println(e);  
  196.  
  197.               }  
  198.  
  199.            return false;  
  200.  
  201.            }  
  202.  
  203.         
  204.  
  205.        private RepeatRule setRule() {  
  206.  
  207.            RepeatRule rule = new RepeatRule();  
  208.  
  209.            int index = _repeat.getSelectedIndex();  
  210.  
  211.            if (index == 0) {  
  212.  
  213.               rule.setInt(RepeatRule.FREQUENCY, RepeatRule.DAILY);  
  214.  
  215.               }  
  216.  
  217.            if (index == 1) {  
  218.  
  219.               rule.setInt(RepeatRule.FREQUENCY, RepeatRule.WEEKLY);  
  220.  
  221.               }  
  222.  
  223.            if (index == 2) {  
  224.  
  225.               rule.setInt(RepeatRule.FREQUENCY, RepeatRule.MONTHLY);  
  226.  
  227.               }  
  228.  
  229.            if (index == 3) {  
  230.  
  231.               rule.setInt(RepeatRule.FREQUENCY, RepeatRule.YEARLY);  
  232.  
  233.               }  
  234.  
  235.            return rule;  
  236.  
  237.            }  
  238.  
  239.         
  240.  
  241.        protected void makeMenu(Menu menu, int instance) {  
  242.  
  243.            menu.add(_saveMenuItem);  
  244.  
  245.            menu.addSeparator();  
  246.  
  247.            super.makeMenu(menu, instance);  
  248.  
  249.            }  
  250.  
  251.        }  
  252.  
  253. }  
  254.  

【编辑推荐】

  1. BlackBerry应用开发者指南 Mail API
  2. BlackBerry应用开发者指南 使用受控API
  3. 简介RIM最新官方BlackBerry JDE 4.7
  4. 简介BlackBerry API
  5. Java语言编写BlackBerry应用程序
责任编辑：佚名 来源： 10086
PIM APIBlackBerry
相关推荐
BlackBerry应用开发者指南 Mail API
本文为《BlackBerry应用开发者指南MailAPI》，BlackBerryMailAPI在net.rim.blackberry.api.mail和net.rim.blackberry.mail.event中.

2011-04-13 09:55:16

Mail APIBlackBerry
BlackBerry应用开发者指南 选项API
在前面我们已经介绍了《BlackBerry应用开发者指南》系列的使用受控API、MailAPI和PIMAPI，本文本系列的第四篇——选项API。

2011-04-13 13:38:57

选项APIBlackBerry
BlackBerry应用开发者指南 使用受控API
本文为《BlackBerry应用开发者指南》之“使用受控API”。在本文中我们将描述的BlackBerryAPI访问是受限制的.使用了受限API的应用程序可以在模拟器上运行.

2011-04-02 13:44:08

BlackBerry应用开发者指南 UI API篇之管理UI组件
本文为《BlackBerry应用开发者指南UIAPI篇之管理UI组件》，我们将介绍如何管理UI组件。使用BlackBerryAPI布局管理器来安排屏幕上的组件。

2011-04-14 10:05:16

BlackBerry
BlackBerry应用开发者指南 UI API篇之显示UI组件
如果你正在编写专门运行在BlackBerry设备上的应用程序，那就使用BlackBerryUIAPI吧。BlackBerryAPI提供了访问BlackBerry设备的特定特性的功能，并且也允许更成熟的UI布局（layout）和交互。

2011-04-14 10:03:32

UI组件BlackBerry
BlackBerry应用开发者指南基础附录 .alx文件
本文将介绍《BlackBerry应用开发者指南》的基础附录.alx文件。应用程序加载工具是BlackBerry桌面软件的一部分,它使用了一个应用程序加载文件(.alx)将应用程序加载到BlackBerry设备中去.利用BlackBerryIDE为你的工程生成一个.alx文件.

2011-04-13 14:10:27

.alx文件BlackBerry
BlackBerry应用开发者指南 创建客户定制的UI组件
本文依旧是介绍BlackBerryUIAPI篇，如何创建创建客户定制的UI组件。你仅能将定制的上下文菜单项和布局增加到一个定制的field中。

2011-04-14 10:34:08

BlackBerry
BlackBerry开发应用程序开发基础之BlackBerry API
BlackBerry开发的概念你是否了解，本文向大家简单介绍一下BlackBerry开发应用程序开发基础之BlackBerryAPI，希望本文介绍对你有所帮助。

2010-05-22 16:57:09

BlackBerry开
Sentry 开发者贡献指南 - Web API
SentryAPI用于向Sentrycollector提交事件以及导出和管理数据。本文档仅涉及WebAPI。

2022-01-17 19:34:43

SentryWeb APISentry API
BlackBerry应用开发指南 使用音频
我们已经讲过BlackBerry应用开发指南的前三部分：BlackBerryAPI、Java语言编写BlackBerry应用程序和UIAPI篇，本文为本文为BlackBerry应用开发指南的第四部分——使用音频。

2011-04-18 11:00:34

使用音频BlackBerry
Android应用开发者指南：性能优化
本文为致力于Android官方应用文档汉化的网友们发布的最新一章《Android应用开发者指南》，原文为(DevGuide)BestPracticesDesigningForPerformanc，这里译为“性能优化”，版本为Android3.1r1。

2011-07-19 09:51:32

性能优化Designing FAndroid
MWC2011：RIM开发者关系总监读解BlackBerry开发者日
北京时间2月16日消息，2011年移动世界大会第二日，RIM开发者关系总监MikeKirkup在采访中介绍说，BlackBerry开发者日相当于小型的BlackBerry开发者会议，讨论开发者如何结合BBM社会化平台，利用在BlackBerryAPPWorld上所开发的应用抓住商机。

2011-02-16 16:45:23

MWCRIMBlackBerry
BlackBerry 5.0整合更多内容 吸引开发者
BlackBerry5.0引入了对BlackBerry智能手机的几个特点。本机核心应用特性是最重要的一大特点，这一特性将吸引更多开发者的关注。

2011-04-26 10:19:46

BlackBerry
Paddle Fluid 开发者指南
本文将提高对各类机器学习任务的描述能力：能够描述潜在出现的任意机器学习模型。代码结构逻辑清晰，各模块充分解耦：内外部贡献者能够专注于自己所需的功能模块，基于框架进行再次开发……

2018-03-27 23:25:40

Paddle
优化移动应用性能的开发者指南
本文将讨论如何优化移动应用的性能，以便发挥移动应用的业务平台作用，并让用户只需几次触按，即可获得需要的服务。

2020-07-15 07:00:00

移动应用开发者指南
BlackBerry应用开发指南 使用图像对象画图
本文为《BlackBerry应用开发指南》UI设计篇的使用图像对象画图，使用Graphics类绘制整个屏幕或一个BitmapField。如果你的应用程序不包含任何field，调用Screen.getGraphics（）来获得整个屏幕的绘图上下文。

2011-04-15 15:16:28

使用图像对象画图BlackBerry
微软发布Windows 8.1系统应用开发者指南
微软官方已正式宣布将Windows8.1RTM提供给硬件合作伙伴，但是并未提前提供给开发人员，TechNet和MSDN订阅用户也需要和普通用户一起要等到10月18日正式发布。不过现在微软已经向开发者们提供了为Win8.1系统优化应用为目的的开发指南及资源。

2013-08-29 13:41:42

Windows 8.1
必读 | 开发者 AI 转型指南
转变成AI开者是一条漫长而艰难的道路，但这并不意味着你不能完成这个目标。

2019-08-16 10:55:37

开发者技能AI
开发者的LlamaIndex入门指南
虽然我们仍然缺乏一种全面的语言来描述模型内部发生的事情，但是通过LlamaIndex使用的RAG不乏一种可靠的途径。它既可以增强针对特定领域信息的大语言模型，也可以确保处理结果的可验证性。而这一切都旨在减少错误应答的可能，而这正是当前困扰人工智能的典型问题。

2024-05-07 08:45:16

OpenAILlamaIndex大语言模型
开发者的Kubernetes懒人指南
在类似的背景下，同样适用于“selfhealing”（自愈）一词。Kubernetes能够执行健康检查，然后终止无响应的pod，安排启动一个新的。这也是某种形式上一直存在的功能。你喜欢的Linux发行版本质上一直能够通过各种方式监视并重新启动服务尽管限于当前机器。

2024-02-01 09:37:42

Kubernetes服务网格• 命令
点赞
收藏

51CTO技术栈公众号

业务
速览
在线客服