This class contains methods for abstracting access to Record Management System (RMS). It is needed for saving the ID of the business card that the user has selected as his or her own card.
To create the class:
Create the Storage class
file.
Assign the
class to the bcexchanger package and import the required
classes.
package bcexchanger; import javax.microedition.rms.RecordEnumeration; import javax.microedition.rms.RecordStore;
Obtain the UID of the contact entry from the address book.
/** * * This class abstracts an RMS system for storing the uid of the * contact entry from the address book, selected by user as own entry. * * @version 1.0 29.09.2005 */ public class Storage { /** * Gets the stored uid * * @return string containing uid of the the contact entry from the * address book, selected by user as own entry or null if no * contact is previously selected * @exception Exception - * in case of errors occur */ static public String getBCUID() throws Exception { String uid = null; RecordStore db = RecordStore.openRecordStore("uid", true); RecordEnumeration e = db.enumerateRecords(null, null, false); if (!e.hasNextElement()) { uid = null; } else { byte[] record = e.nextRecord(); if (record == null) { uid = null; } else { uid = new String(record); } } db.closeRecordStore(); return uid; }
Store the UID.
/** * Stores the uid * * @param uid - * string containing uid of the the contact entry from the * address book, selected by user as own entry * @exception Exception - * in case of errors occur */ static public void setBCUID(String uid) throws Exception { RecordStore db = RecordStore.openRecordStore("uid", true); // delete all records if (db.getNumRecords() != 0) { db.closeRecordStore(); RecordStore.deleteRecordStore("uid"); db = RecordStore.openRecordStore("uid", true); } byte[] record = uid.getBytes(); db.addRecord(record, 0, record.length); db.closeRecordStore(); } }
This class provides an abstraction of the phone book to application. It implements access to the phone book of the device and provides information in the form the application needs.
The class makes use of the PIM API (JSR-75). For more information on using this API, see PIM API Implementation Notes and PIM - Event Handling.
To create the class:
Create the AddressBook class
file.
Assign the
class to the bcexchanger package and import the required
classes.
package bcexchanger; import java.io.ByteArrayInputStream; import java.io.ByteArrayOutputStream; import java.util.Enumeration; import java.util.Vector; import javax.microedition.pim.Contact; import javax.microedition.pim.ContactList; import javax.microedition.pim.PIM; import javax.microedition.pim.PIMItem;
Obtain all names from the address book.
/** * * This class provides an abstraction of the address book to * application. It implements the access to the phone address book and * provides information in the form the application needs */ public class AddressBook { /** * This method gets all names from the address book and * corresponding uids. * <p> * This method retrieves full names from the address book and * corresponding uinque identifiers (uids) * * @return two vectors: first is vector of names, second is the * vector of corresponding UIDs * @exception Exception - * in case any errors occur while working with address * book */ static public Vector[] getNamesUIDLists() throws Exception { Vector[] namesUIDs = new Vector[2]; namesUIDs[0] = new Vector(); namesUIDs[1] = new Vector(); // get the name of the address book PIM pim = PIM.getInstance(); String listNames[] = pim.listPIMLists(PIM.CONTACT_LIST); if (listNames.length == 0) { throw new RuntimeException("No available Contact lists"); } // opent the address book ContactList contactList = (ContactList) pim.openPIMList( PIM.CONTACT_LIST, PIM.READ_ONLY, listNames[0]); // veryfy the that the required list are supported if (!contactList.isSupportedField(Contact.UID)) { throw new RuntimeException( "Required field (UID) is not supported by the address book"); } // list of preferd order of the name fields Vector fieldOrder = new Vector(); fieldOrder.addElement(new Integer(Contact.FORMATTED_NAME)); // For Series40 fieldOrder.addElement(new Integer(Contact.NAME_FAMILY)); fieldOrder.addElement(new Integer(Contact.NAME_GIVEN)); fieldOrder.addElement(new Integer(Contact.NAME)); // fix Vector supportedFieldOrder = new Vector(); // create the supported list for(int i=0; i < fieldOrder.size(); i++) { Integer field = (Integer) fieldOrder.elementAt(i); if(contactList.isSupportedField(field.intValue())) { supportedFieldOrder.addElement(field); } } // in case none of the names is supported if(supportedFieldOrder.size() == 0) { throw new RuntimeException( "Required name field is not supported by the address book"); } // get the list of contacts and uids Enumeration e = contactList.items(); while (e.hasMoreElements()) { Contact contact = (Contact) e.nextElement(); try { // try to obtain any supported name String name = null; Enumeration e2 = supportedFieldOrder.elements(); while(e2.hasMoreElements()) { try { int field = ((Integer) e2.nextElement()).intValue(); if (field == Contact.NAME) { String[] nameArray = contact.getStringArray(field,0); if (nameArray != null) name = nameArray[0]; } else { name = contact.getString(field, 0); } if(name != null && name != "") { break; } else { name = null; } } catch (Exception exception) { name = null; } } // this contact does not have a suitable name, continue with the next if(name == null) { continue; } String uid = contact.getString(Contact.UID, 0); namesUIDs[0].addElement(name); namesUIDs[1].addElement(uid); } catch (IndexOutOfBoundsException ex) { // Ignore, this is a malformed contact and we'll omit it } } return namesUIDs; }
Search for vCards in an address book entry.
/** * Get vCard of the address book entry with the particular uid * <p> * Longer description * * @param uid - * unique identifier of the requested address book entry * @return byte array which contains a vCard * @exception Exception - * in case any error occur */ static public byte[] getVCard(String uid) throws Exception { ByteArrayOutputStream os = new ByteArrayOutputStream(); // create a search pattern (based on uid) ContactList contactList = (ContactList) PIM.getInstance() .openPIMList(PIM.CONTACT_LIST, PIM.READ_ONLY); Contact searchPattern = contactList.createContact(); searchPattern.addString(Contact.UID, PIMItem.ATTR_NONE, uid); Enumeration e = contactList.items(searchPattern); // get the first found contact if (e.hasMoreElements()) { Contact contact = (Contact) e.nextElement(); PIM.getInstance().toSerialFormat(contact, os, "UTF-8", "VCARD/2.1"); } else { throw new RuntimeException("No contacts found"); } return os.toByteArray(); } /** * Saves a vCard to the address book * <p> * Creates a new entry based on the infromation from the vCard in * the phones address book * * @param vCard - * byte array which contains a vCard * @exception Exception - * in case any errors occur */ static public void setVCard(byte[] vCard) throws Exception { ByteArrayInputStream in = new ByteArrayInputStream(vCard); // get address book entry from the input stream PIMItem[] items = PIM.getInstance().fromSerialFormat(in, "UTF-8"); // takes the first one discards the others ContactList contactList = (ContactList) PIM.getInstance() .openPIMList(PIM.CONTACT_LIST, /* PIM.WRITE_ONLY */ PIM.READ_WRITE); Contact newContact = contactList .importContact((Contact) items[0]); newContact.commit(); } }