术语汇编 J2ME PIM概论(1)(2)

Contact和ContactList

一个Contact表示AddressBook中的单个条目。Contact中的主要字段是Name、Address、Email、Birthday、Photo和Telephone。

为了确保跨平台可移植性，建议使用SuperInterfacePIMList提供的方法isSupportedField()。

清单1展示如何向AddressBook添加一个Contact：

清单1.将Contact添加到AddressBook

ContactListaddressBook=null;  
try{  
addressBook=(ContactList)PIM.getInstance().openPIMList(PIM.CONTACT_LIST,  
PIM.READ_WRITE);  
}catch(PIMExceptione){  
//ExitApplication  
}  
 
ContactsingleContact=addressBook.createContact();  
String[]name=newString[addressBook.stringArraySize(Contact.NAME)];  
 
if(addressBook.isSupportedField(Contact.NAME_FORMATTED)  
singleContact.addString(Contact.NAME_FORMATTED,  
PIMItem.ATTR_NONE,"Mrs.JaneDoe");  
 
ThecreateContact()methodcreatesatemporaryemptyContact.Acommit()callmakes  
theContactdatapersistent.Itisadvisabletoclosethelistsbyinvokingtheclose()  
methodafternecessaryoperationshavebeenperformed.  
 
try{  
singleContact.commit();  
}catch(PIMExceptione){  
//Exceptionoccured  
}  
try{  
//Othercleanuptasks  
addressBook.close();  
}catch(PIMExceptione){  
 
}  
 
  
 

Event和EventList

一个Event表示Event数据库中的单个条目，比如，移动设备上的日历。Event中的关键字段是Location、Summary、Startdate、EndDate和Alarmnotification。清单2展示如何向Event数据库添加一个Event。

清单2.添加一个Event

EventListeventList=null;  
try{  
eventList=(EventList)PIM.getInstance().openPIMList(PIM.EVENT_LIST,  
PIM.READ_WRITE);  
}catch(PIMExceptione){  
return;  
}  
EventsingleEvent=eventList.createEvent();  
if(eventList.isSupportedField(Event.SUMMARY))  
singleEvent.addString(Event.SUMMARY,PIMItem.ATTR_NONE,"JavaTraining");  
if(eventList.isSupportedField(Event.START))  
singleEvent.addDate(Event.START,PIMItem.ATTR_NONE,aDate.getTime());  
if(eventList.isSupportedField(Event.END))  
singleEvent.addDate(Event.END,PIMItem.ATTR_NONE,aDate.getTime());  
 
try{  
singleEvent.commit();  
}catch(PIMExceptione){  
//Anerroroccured  
}  
try{  
eventList.close();  
}catch(PIMExceptione){  
 
}