JSR 75

Structura JSR 75 include două pachete suplimentare:

Personal Information Management (PIM) API

Trei tipuri de date PIM numite liste de takzhePIM definite în PIM.

API PIM este definit în pachetul javax.microedition.pim (sau javax.microedition.io.pim). Acest pachet conține opt interfețe, șase clase, inclusiv patru tipuri de excepții:

Interfețe API PIM

Această excepție apare atunci când câmpul nu este acceptat de lista PIM la care elementul.

Pentru a vă asigura că dispozitivul acceptă PIM API, trebuie să utilizați metoda System.getproperty () cu parametrul microedition.pim.version. Metoda trebuie să returneze numărul de versiune al API, sau nul, nu există PIM nu este acceptat de acest dispozitiv.

Utilizarea PIM API

Accesul la date se face prin intermediul PIM instanță a clasei:

PIM singleton = PIM.getInstance ();

Toate listele PIM prezentate interfață PIMList având trei subinterface: ContactList, EventList și ToDoList.

Pentru a avea acces la lista pe care doriți să utilizați PIM metodopenPIMList (int PAR1, int PAR2, String par3). Primul parametru al acestei metode determină tipul de listă:

  • PIM.CONTACT_LIST - la lista de contacte
  • PIM.EVENT_LIST - la lista evenimentelor
  • PIM.TODO_LIST - to-do list

Al doilea parametru specifică modul de operare:

  • PIM.READ_ONLY - read-only
  • PIM.READ_WRITE - citire și scriere
  • PIM.WRITE_ONLY - numai de intrare

Al treilea parametru este opțional și conține lista PIM numele pe care doriți să le primiți. Dacă omiteți acest parametru, openPIMList () va returna lista implicită. Când încercați să deschideți o listă inexistentă, o excepție are loc PIMException.

Lista conține elemente PIM prezentate interfață PIMItem și subinterfaces sale de contact, Evenimente, și ToDo. Pentru a obține un set de liste elemente PIM, trebuie să utilizați metoda de articole (). Pentru a muta prin elemente utiliza metodnextElement ().

Următorul exemplu arată cum se deschide lista de contacte și de a găsi / adăuga o persoană de contact.

De notat utilizarea metodacountValues ​​(). returnează numărul de valori în domeniu. Pentru a citi metodygetAttributes valorile pixelilor folosite (câmp int), getString (câmp int, int index), getDate (câmp int, int index) și getint (câmp int, int index). în care câmpul - determină câmpul obligatoriu și indicele - intrarea dorită.

Pentru a crea un nou PIMItems articol folosit metode createContact (), createEvent (), createToDo (). Pentru a completa câmpurile - metodyaddDate (câmp int atribute, valoarea de lungă), addInt (câmp int, atribute int, int valoare), addString (câmp int, int atribute, valoarea java.lang.String).

Trebuie remarcat faptul că dispozitivul poate să nu accepte toate câmpului. În anumite situații, acest lucru duce la pierderea de date. Pentru a verifica dacă câmpurile obligatorii sunt acceptate, utilizați metodomisSupportedField ().

Utilizarea emulatorul J2ME Wireless Toolkit 2.2 pentru listele de testare PIM

J2ME Wireless Toolkit standard de 2.2 include un exemplu care ilustrează PDAPDemo operare cu liste PIM.

În mod implicit, emulatorul nu stabilește contactele și calendare. Listele PIM sunt localizate fizic în papkahtoolkit / appdb / DefaultColorPhone / pim / Contacte / Contacte, set de instrumente / appdb / DefaultColorPhone / pim / evenimente / Evenimente și set de instrumente / appdb / DefaultColorPhone / pim / todo / ToDo. Contactele sunt stocate în format vCard, și calendare, și de afaceri - în vCalendar.

Aici este un exemplu de fișier în format vCard. Pentru a utiliza aceste date pe emulator, salvați acest fișier kaktoolkit /appdb/DefaultColorPhone/pim/contacts/Contacts/sample.vcf

Aici este, de asemenea, un exemplu al unui fișier în format vCalendar. Pentru a utiliza aceste date pe emulator, salvați acest fișier /appdb/DefaultColorPhone/pim/events/Eevnts/sample.vcs kaktoolkit