Accedere a ContentProvider

I dispositivi Android gestiscono molti dati come contatti, file archiviati su disco, eventi del Calendario. Tutte queste informazioni possono essere lette e modificate dalle nostre applicazioni mediante ContentProvider. Il carattere particolarmente “personale” di questi dati segnala quanto la programmazione di un dispositivo mobile a volte si allontani dall'astrazione dell'informatica e si intrecci fortemente con la vita reale dell'utente.

Nel capitolo precedente abbiamo visto le caratteristiche dei ContentProvider, funzionamento e validità architetturale. Qui apprezzeremo molto la standardizzazione dei meccanismi di accesso che mettono a disposizione, agevolando la consultazione di basi di dati spesso molto diverse tra loro.

Aspetti cui si dovrà porgere particolare attenzione:

• gli URI non sono pi ù inventati dal programmatore classi Contract
• solitamente sarà necessario aggiungere delle permission

Per quanto riguarda l'accesso, si userà ugualmente il ContentResolver ed i suoi metodi che permetteranno di mettere in pratica le quattro operazioni CRUD: lettura, inserimento, modifica e cancellazione.

Alcuni ContentProvider di sistema

ContentProvider molto noti del sistema opearativo sono:

• Contacts
• MediaStore
• UserDictionary
• Calendar

Un esempio: gestire il Calendario

Le API Calendar possono essere davvero utili per fare in modo che le nostre applicazioni possano aiutare gli utenti a gestire i propri impegni.

Per utilizzare questo provider è necessario innanzitutto aggiungere al manifest le permission richieste, dipendentemente dal tipo di operazioni che si vogliono svolgere (lettura e/o scrittura):

<uses-permission
android:name="android.permission.READ_CALENDAR"/>
<uses-permission
android:name="android.permission.WRITE_CALENDAR"/>

Ricordiamo che, durante la sua storia, Android ha modificato l'approccio alle permission, soprattutto per quelle più delicate
a livello di protezione dei dati personali dell'utente. Pertanto, anche per l'impiego di quelle relative al Calendar
si rimanda alle indicazioni fornite nell'apposita lezione

Tutto il sistema ad oggetti del calendario verterà intorno alla classe Contract di competenza, ovviamente CalendarContract. Questa permetterà l'accesso ad una serie di tabelle, ognuna dedicata ad un aspetto. Ecco le più comuni:

• CalendarContract.Calendars
• CalendarContract.Events
• CalendarContract.Attendes
• CalendarContract.Reminders

Vediamo ora alcuni esempi di codice per interagire con il nostro calendario.

Recuperare i calendari disponibili nel sistema:

String[] projection =
  new String[] {
    CalendarContract.Calendars._ID,
      CalendarContract.Calendars.NAME,
      CalendarContract.Calendars.ACCOUNT_NAME,
      CalendarContract.Calendars.ACCOUNT_TYPE
  };
 
Cursor cursor = getContentResolver().
  query(CalendarContract.Calendars.CONTENT_URI,
        projection,
        CalendarContract.Calendars.VISIBLE + & quot; = 1 & quot;,
        null,
        null);

Per vedere tutti i calendari che possono essere trovati nel sistema, come presumibile, è necessario inviare una query mediante ContentResolver. Si faccia caso che l'URI da utilizzare sarà fornito direttamente dalla classe Calendars e così anche per quanto riguarda i campi. Per il resto non c'è niente di nuovo. Il risultato sarà un normale Cursor che si potrà gestire nelle modalità consuete, lettura diretta o CursorAdapter per citarne alcuni.

Inserire un evento in un determinato calendario:

Una volta utilizzato il codice precedente abbiamo a disposizione tutti i calendari registrati nel dispositivo. Come si può vedere osservando l'array projection, tra i campi recuperati dalla query c'è l'ID. A questo si potrà inserire un nuovo evento nel sistema collegandolo ad un calendario fornendone l'ID.

Calendar cal = new GregorianCalendar(2021, 4, 20);
                cal.setTimeZone(TimeZone.getDefault());
                cal.set(Calendar.HOUR, 15);
                cal.set(Calendar.MINUTE, 30);
                long dtstart = cal.getTimeInMillis();
                ContentValues values = new ContentValues();
                values.put(CalendarContract.Events.DTSTART, dtstart);
                values.put(CalendarContract.Events.DTEND, dtstart+3*3600*1000); // durata di tre ore
                values.put(CalendarContract.Events.TITLE, "Riunione con il capo");
                values.put(CalendarContract.Events.CALENDAR_ID, id);
                values.put(CalendarContract.Events.EVENT_TIMEZONE, TimeZone.getDefault().getDisplayName());
                Uri uri =
                        getContentResolver().
                                insert(CalendarContract.Events.CONTENT_URI, values);

Nell'esempio abbiamo salvato un promemoria per la riunione con il capo per il 20 maggio. Abbiamo annotato anche che l'impegno durerà tre ore a partire dalle 15:30.

Il salvataggio effettuato si preoccuperà di inserire solo i dati minimi indispensabili ossia quelli assolutamente obbligatori per un evento non ripetitivo. Tra gli altri vediamo che nel ContentValues preparato per l'inserimento è stato collocato anche l'ID del calendario, informazione che può essere recuperata mediante il primo esempio di codice.

Aprendo successivamente l'applicazione Calendar sul dispositivo Android vedremo che effettivamente il promemoria per la riunione è stato salvato ed è visibile nell'immagine seguente.