PIM为J2ME开发者提供了访问目标设备上存储的个人信息的API。
PIM共由8个接口和6个类(其中4个异常类)组成，定义在javax.microedition.pim包中。
PIM定义了3种类型的个人信息列表，包括：个人通讯录、日程表和任务表，通常他们都是以本地形式存储在设备上。PIM为每种类型的个人信息列表都提供了如下访问接口。
★ContactList接口用于访问设备中的个人通讯录、联系人列表。
★EventList接口用于访问日程表。
★ToDoList接口用于访问任务表。
这3个接口都是PIMList得子接口，PIMList接口定义了访问个人信息列表的公共方法。
PIM定义的个人信息列表由一些项目组成，列表类型不同，其中的项目类型也不同。PIM为每种类型的项目都定义如下访问接口。
★Contact接口用于访问联系人列表中的项目。
★Event接口用于访问日程表中的项目。
★ToDo接口用于访问任务表中的项目。
这3个接口都是PIMItem得子接口，PIMItem接口定义了访问个人信息项目的公共方法。
在使用PIM之前，需要先确定是否支持PIM。
System.getProperty(“microedition.pim.version”);
如果不支持，则返回null.
实战代码：
(这里是获取电话本中信息，其他类型数据过程类似)
- public class GetPIM implements Runnable {
- public void run() {
- String[] listNames = PIM.getInstance().listPIMLists(PIM.CONTACT_LIST);
- int size = listNames.length;
- String name = null;
- //获取联系人列表名称：
- form.append("****信息列表名称****\t");
- for (int i = 0; i < size; i++) {
- System.out.println(listNames[i] + "\n");
- form.append(listNames[i]);
- name = listNames[i];
- try {
- list = (ContactList) PIM.getInstance().openPIMList(PIM.CONTACT_LIST, PIM.READ_WRITE, name);
- int[] supportFields = list.getSupportedFields();
- int fieldSize = supportFields.length;
- form.append("\n***支持字段个数****\t" + fieldSize);
- for (int j = 0; j < fieldSize; j++) {
- String fieldLabel = list.getFieldLabel(supportFields[j]);
- // form.append("\n***支持的字段名称****\n"+j+".\t"+fieldLabel);
- allLabel.addElement(fieldLabel);
- int fieldType = list.getFieldDataType(supportFields[j]);
- // form.append("\n***支持的类型****\n"+j+".\t"+fieldType);
- allType.addElement(new Integer(fieldType));
- }
- //遍历电话本中所有条目：
- Enumeration items = list.items();
- while (items.hasMoreElements()) {
- form.append("\n****添加数据****\n");
- Contact contact = (Contact) items.nextElement();
- //添加电话：
- //try-catch 语句是防止某个条目没有内容，从而会抛出InvalidIndex的异常，使得程序无法继续。
- try {
- String tel = contact.getString(Contact.TEL, 0);
- if (tel != null) {
- form.append("电话" + tel + "\n");
- }
- } catch (Exception ex) {
- continue;
- }
- //获取联系人姓名
- //try-catch 语句是防止某个条目没有内容，从而会抛出InvalidIndex的异常，使得程序无法继续。
- try {
- String[] nameS = contact.getStringArray(Contact.NAME, 0);
- int nameSize = nameS.length;
- for (int m = 0; m < nameSize; m++) {
- if (nameS[m] != null) {
- form.append(nameS[m] + "\t");
- }
- }
- } catch (Exception ex) {
- continue;
- }
- }
- } catch (PIMException e) {
- form.append("\n异常了" + e.getMessage());
- } catch (NullPointerException npe) {
- form.append("\n异常了" + npe.getMessage());
- } catch (Exception e) {
- form.append("\n异常了" + e.getMessage());
- }
- }
- }
- }
流程小结：
1. String[] listNames = PIM.getInstance().listPIMLists(PIM.CONTACT_LIST);
获得列表名称，肯能有多个，所以是个数组。
2. ContactList list = (ContactList) PIM.getInstance().openPIMList(PIM.CONTACT_LIST, PIM.READ_WRITE, name);
根据列表名称，获取列表
3. Enumeration items = list.items();
while (items.hasMoreElements()) {
Contact contact = (Contact) items.nextElement();
}
遍历列表，获得实际条目。
4. 获得电话号码(其他字段内容类似)，需要在while循环里进行
String tel = contact.getString(Contact.TEL, 0);
我最近在玩和讯财经微博，很方便，很实用。
一句话，一张图，随时随地与我分享理财心得与亲历见闻。
点击以下链接xx，来和我一起玩吧！
