JSR 75
Структурата на JSR 75 включва два допълнителни пакети:
Управление на личната информация (PIM) API
Три типа данни PIM наречени takzhePIM списъци, определени в PIM.
PIM API е определено в javax.microedition.pim пакет (или javax.microedition.io.pim). Този пакет съдържа осем интерфейси, шест класа, включително четири вида изключения:
PIM API интерфейси
Това изключение се случва, когато на полето не се поддържа от списъка PIM към който елемента.
За да сте сигурни, че устройството поддържа PIM API, трябва да използвате метод System.getproperty () с параметър microedition.pim.version. Методът трябва да връща номера на версията на API, или нула, има PIM не се поддържа от това устройство.
Използването на PIM API
Достъпът до данните е чрез PIM инстанция на класа:
PIM сек = PIM.getInstance ();
Всички списъци PIM представени PIMList интерфейс, съдържащ три subinterface: ContactList, EventList и ToDoList.
За да получите достъп до списъка, който искате да използвате PIM metodopenPIMList (инт par1, вътр PAR2, String par3). Първият параметър на този метод се определя от вида на списъка:
- PIM.CONTACT_LIST - с адреси
- PIM.EVENT_LIST - в списъка на събитията
- PIM.TODO_LIST - списък със задачи
Вторият параметър определя режима на работа:
- PIM.READ_ONLY - само за четене
- PIM.READ_WRITE - четене и писане
- PIM.WRITE_ONLY - само входната
Третият параметър е по избор и съдържа списък на PIM името, което искате да получите. Ако пропуснете този параметър, openPIMList () ще върне списък по подразбиране. Когато се опитате да отворите несъществуващ списък, по изключение се случва PIMException.
списък PIM съдържа елементи, представени PIMItem интерфейс и неговите subinterfaces контакти, събития, и със задачи. За да се получи набор от елементи списък PIM, ще трябва да използвате метода на елементи (). За движение по позиции използвайте metodnextElement ().
Следният пример показва как да отворите списъка с контакти и да намерите / добавите контакт.
Обърнете внимание на използването на metodacountValues (). връща броя стойности в областта. За да прочетете използвани стойностите на пикселите metodygetAttributes (полеви инт), getString (междинно поле, индекс инт), getDate (област вътр, индекс вътр) и getInt (област вътр, индекс вътр). където поле - определя необходимата областта, и индекса - желаната позиция.
За да създадете нов елемент PIMItems използвани методи createContact (), createEvent (), createToDo (). За да попълните в полетата - metodyaddDate (област вътр, Int атрибути, дълго стойност), addInt (междинно поле, вътр атрибути, вътр стойност), addString (област вътр, вътр атрибути, java.lang.String стойност).
Трябва да се отбележи, че устройството може да не поддържа всички на полето. В някои случаи това води до загуба на данни. За да се уверите, че задължителните полета са подкрепени, използвайте metodomisSupportedField ().
С помощта на емулатора J2ME Wireless Toolkit 2.2 за тестване PIM списъци
J2ME Wireless Toolkit 2.2 стандарт включва пример, илюстриращ PDAPDemo за експлоатация с PIM списъци.
По подразбиране, емулатора не задава контакти и календари. списъци PIM които физически се намират в papkahtoolkit / appdb / DefaultColorPhone / ПИМ / контакти / Контакти, инструментариум / appdb / DefaultColorPhone / ПИМ / събития / Събития и инструментариум / appdb / DefaultColorPhone / ПИМ / със задачи / ToDo. Контактите се съхраняват във формат картичка и календари, както и бизнес - в VCALENDAR.
Ето един пример файл във формат картичка. За да използвате тази информация на емулатора, запазите този файл kaktoolkit /appdb/DefaultColorPhone/pim/contacts/Contacts/sample.vcf
Ето и пример за даден файл във формат VCALENDAR. За да използвате тази информация на емулатора, запазите този файл kaktoolkit /appdb/DefaultColorPhone/pim/events/Eevnts/sample.vcs