ContactsContract.Directory Classe

Definizione

[Android.Runtime.Register("android/provider/ContactsContract$Directory", DoNotGenerateAcw=true)]
public sealed class ContactsContract.Directory : Java.Lang.Object

[<Android.Runtime.Register("android/provider/ContactsContract$Directory", DoNotGenerateAcw=true)>]
type ContactsContract.Directory = class
    inherit Object

Ereditarietà

Object

JavaObject

Object

ContactsContract.Directory

Attributi

RegisterAttribute

Commenti

Una directory rappresenta un insieme di contatti, ad esempio contatti locali, elenco indirizzi globali di Google Apps o elenco indirizzi globali aziendali.

Una directory viene implementata come provider di contenuti con l'autorità univoca e la stessa API del provider contatti principale. Tuttavia, non ci si aspetta che ogni provider di directory implementi il contratto nel suo complesso. Se un provider di directory non dispone di un'implementazione per una richiesta specifica, deve generare un'eccezione UnsupportedOperationException.

Il caso d'uso più importante per le directory è la ricerca. È previsto che un provider di directory supporti almeno ContactsContract.Contacts#CONTENT_FILTER_URI Contacts.CONTENT_FILTER_URI. Se un provider di directory vuole partecipare alle funzionalità di ricerca tramite posta elettronica e telefono, deve implementare CommonDataKinds.Email#CONTENT_FILTER_URI CommonDataKinds.Email.CONTENT_FILTER_URI e CommonDataKinds.Phone#CONTENT_FILTER_URI CommonDataKinds.Phone.CONTENT_FILTER_URI.

Un provider di directory deve restituire NULL per ogni campo di proiezione che non riconosce, anziché generare un'eccezione. In questo modo non verrà interrotto se ContactsContract viene esteso con nuovi campi in futuro.

Il client interagisce con una directory tramite il provider contatti fornendo un parametro di query facoltativo directory= .

Quando il provider contatti riceve la richiesta, trasforma l'URI e inoltra la richiesta al provider di contenuto della directory corrispondente. L'URI viene trasformato nel modo seguente: <ul><li>L'autorità URI viene sostituita con l'oggetto corrispondente#DIRECTORY_AUTHORITY.</li><li>I accountName= parametri e accountType= vengono aggiunti o sostituiti usando i valori e #ACCOUNT_TYPE corrispondenti#ACCOUNT_NAME.</li></ul>

I client devono inviare richieste di directory al provider contatti e consentire loro di inoltrarle ai rispettivi provider anziché costruire gli URI del provider di directory autonomamente. Questo livello di riferimento indiretto consente al provider di contatti di implementare funzionalità e ottimizzazioni aggiuntive a livello di sistema. L'accesso al provider contatti è protetto dall'autorizzazione READ_CONTACTS, ma l'accesso al provider di directory è protetto da BIND_DIRECTORY_SEARCH. Questa autorizzazione è stata introdotta al livello API 17, per le versioni precedenti della piattaforma il provider deve eseguire il controllo seguente per assicurarsi che la chiamata provena da ContactsProvider:

private boolean isCallerAllowed() {
              PackageManager pm = getContext().getPackageManager();
              for (String packageName: pm.getPackagesForUid(Binder.getCallingUid())) {
                if (packageName.equals("com.android.providers.contacts")) {
                  return true;
                }
              }
              return false;
            }

</p>

La tabella Directory è di sola lettura e viene gestita automaticamente dal provider contatti.

Contiene sempre almeno queste due righe: <ul><li> La directory locale. Ha Directory#_ID Directory._ID = Directory#DEFAULT Directory.DEFAULT. Questa directory può essere usata per accedere ai contatti archiviati in locale. È possibile ottenere lo stesso risultato omettendo completamente il directory= parametro . </li li><> I contatti invisibili locali. L'ID della directory corrispondente è Directory#LOCAL_INVISIBLE Directory.LOCAL_INVISIBLE. </li></ul>

Le directory personalizzate vengono individuate dal provider contatti seguendo questa procedura: <ul><li>Trova tutti i provider di contenuti installati con metadati che li identificano come provider di directory in AndroidManifest.xml: <meta-data android:name="android.content.ContactDirectory" android:value="true" />

Questo tag deve essere inserito all'interno della dichiarazione del provider di contenuti corrispondente.

</li><li> Then Contacts Provider invia una Directory#CONTENT_URI Directory.CONTENT_URI query a ognuna delle autorità di directory. Un provider di directory deve implementare questa query e restituire un elenco di directory. Ogni directory restituita dal provider deve avere una combinazione univoca per le #ACCOUNT_NAME colonne e #ACCOUNT_TYPE (sono consentiti valori Null). Poiché gli ID directory vengono assegnati automaticamente, il campo _ID non farà parte della proiezione della query. </li><li>Contacts Provider compila gli elenchi di directory ricevuti da tutti i provider di directory in uno, assegna a ogni singola directory un ID univoco globale e archivia tutti i record di directory nella tabella Directory. </li></ul></p>

Contacts Provider interroga automaticamente i pacchetti appena installati o sostituiti. L'installazione di un pacchetto contenente un provider di directory è quindi sufficiente per la registrazione di tale provider. Un pacchetto che fornisce un provider di directory non deve contenere attività avviabili.

Ogni riga nella tabella Directory viene associata automaticamente al pacchetto corrispondente (apk). Se il pacchetto viene disinstallato in un secondo momento, tutte le righe di directory corrispondenti vengono rimosse automaticamente dal provider contatti.

Quando l'elenco delle directory gestite da un provider di directory cambia (ad esempio quando l'utente aggiunge un nuovo account directory), il provider di directory deve chiamare #notifyDirectoryChange per notificare al provider contatti la modifica. In risposta, il provider contatti rieseguirà una query sul provider di directory per ottenere il nuovo elenco di directory.

Una riga di directory può essere facoltativamente associata a un account esistente (vedere android.accounts.AccountManager). Se l'account viene rimosso in un secondo momento, le righe di directory corrispondenti vengono rimosse automaticamente dal provider contatti.

per android.provider.ContactsContract.Directory.

Le parti di questa pagina sono modifiche basate sul lavoro creato e condiviso dalla e usati in base ai termini descritti in Creative License 2.5 Attribution License.