Content Provider: ano ito, arkitektura ng komponent at prinsipyo ng paggana

Ano ang Content Provider?

Content Provider — ay isang komponent ng Android na namamahala ng access sa sentralisadong imbakan ng data at nagbibigay nito sa iba pang mga application sa pamamagitan ng pinag-isang interface ng kontrata. Itinatago nito ang mga detalye ng implementasyon ng imbakan: ang data ay maaaring itago sa SQLite, sa file system, sa cloud, o maging resulta ng isang network request.

Ang Android ay may kasamang mga built-in na Content Provider para sa system data — ContactsContract, MediaStore, CalendarContract, CallLog. Ang mga third-party na application ay maaari ring lumikha ng kanilang sariling mga provider para sa ligtas na pagpapalitan ng data. Ang bawat provider ay nirerehistro sa AndroidManifest.xml na may pagtukoy ng authority — isang natatanging string na bumubuo sa unang bahagi ng URI.

Paano Gumagana ang Content Provider

Ang Content Provider ay gumagana ayon sa modelong client-server. Ang provider ay gumaganap bilang server na nag-iimplementa ng anim na mandatoryong metodo: query, insert, update, delete, getType at onCreate. Ang client (ibang application) ay pumupunta sa provider sa pamamagitan ng ContentResolver na nagpapasa ng mga tawag sa kaukulang metodo ng provider sa pamamagitan ng IPC mechanism ng Android.

URI at authority

Ang bawat Content Provider ay tinutukoy ng URI ng schema content://. Halimbawa, content://com.example.app.provider/items. Ang unang bahagi authority (com.example.app.provider) ay nakatali sa klase ng provider sa manifest. Ang path /items ay tumutukoy sa table, at /items/5 — sa isang partikular na record na may ID=5.

Proseso ng pagtawag

Kapag ang isang application ay tumawag ng ContentResolver.query(URI), sinusuri ng Android ang mga pahintulot ng tumatawag na package, hinahanap ang provider sa pamamagitan ng authority at sinisimulan ang proseso nito kung hindi pa ito tumatakbo. Isinasagawa ng provider ang query at nagbabalik ng Cursor — isang object na naglalaman ng resulta at nagpapahintulot sa client na umulit sa mga record.

Mga Pangunahing Metodo ng Content Provider

Ang klase na ContentProvider ay nangangailangan ng implementasyon ng anim na abstract na metodo. Bawat metodo ay tumatanggap ng URI at nagbabalik ng resulta na naaayon sa uri ng operasyon. Tinatawag ng system ang mga metodong ito mula sa anumang proseso, kaya dapat silang maging thread-safe at hindi harangan ang execution nang mahabang panahon.

Metodo query

Ang metodo query ay tumatanggap ng URI, array ng mga column projection, string selection na may mga argumento, at order ng pag-uuri. Nagbabalik ito ng Cursor na may data. Sa implementasyon, kailangan i-parse ang URI gamit ang UriMatcher at isagawa ang kaukulang SQL query sa database.

Mga metodo insert, update, delete

Ang mga metodong ito ay nagbabago ng data sa imbakan. insert ay tumatanggap ng ContentValues — mga pares key-value — at nagbabalik ng URI ng bagong record. Ang update at delete ay tumatanggap ng selection para sa pag-filter ng mga record at nagbabalik ng bilang ng mga apektadong row. Pagkatapos baguhin ang data, ang provider ay dapat mag-notify sa pamamagitan ng ContentResolver.notifyChange.

ContentResolver at URI sa Android

ContentResolver — ay isang solong access point para sa pagtatrabaho sa lahat ng Content Provider sa system. Ang client application ay hindi kailanman direktang tumatawag ng mga metodo ng provider — sa pamamagitan lamang ng ContentResolver, na nakukuha ng Android mula sa context. Ang mga CRUD operation sa ContentResolver ay may parehong pangalan tulad ng sa provider, ngunit tumatanggap ng URI sa halip na direktang mga reference.

UriMatcher

Para sa pag-parse ng mga papasok na URI sa loob ng provider, ginagamit ang UriMatcher. Pinapayagan nito ang pagtugma ng URI sa isang numeric code — halimbawa, ang URI content://authority/items ay nagbibigay ng code 1, at ang content://authority/items/# — code 2. Ito ay nag-aalis ng pangangailangan para sa manu-manong pag-parse ng string URI sa bawat metodo.

// Paggamit ng ContentResolver para ma-access ang mga contact
val uri = ContactsContract.Contacts.CONTENT_URI
val cursor = contentResolver.query(
    uri,
    arrayOf(ContactsContract.Contacts.DISPLAY_NAME),
    null, null, null
)
cursor?.use {
    while (it.moveToNext()) {
        val name = it.getString(it.getColumnIndexOrThrow(
            ContactsContract.Contacts.DISPLAY_NAME
        ))
        Log.d("Mga Contact", "Pangalan: $name")
    }
}

Ang Cursor ay dapat na isara pagkatapos gamitin — sa halimbawa sa itaas, ginagawa ito ng use (Kotlin extension function). Kung hindi isinara ang Cursor, magkakaroon ng memory leak dahil ito ay may hawak na reference sa data sa Binder pool. Para sa mga UI scenario, gamitin ang CursorLoader o Room na may LiveData/Flow.

Halimbawa ng Content Provider sa Kotlin

Ang paggawa ng sariling Content Provider ay nagsisimula sa pagmamana mula sa klase na ContentProvider. Ang provider ay gumagana sa SQLite database sa pamamagitan ng SQLiteOpenHelper at gumagamit ng UriMatcher para sa pagtukoy ng uri ng query. Tingnan natin ang isang minimal na implementasyon para sa pamamahala ng listahan ng mga tala.

Pagrehistro sa manifest

Ang provider ay nirerehistro sa AndroidManifest.xml sa loob ng application tag. Ang attribute authorities ay nagtatakda ng natatanging identifier, at exported ay tumutukoy kung ang ibang mga application ay maaaring pumunta sa provider. Kung walang exported=true, ang provider ay accessible lamang sa loob ng iyong application.

// Halimbawa ng Content Provider para sa mga tala
class NotesProvider : ContentProvider() {

    companion object {
        const val AUTHORITY = "com.example.app.notes"
        const val NOTES_PATH = "notes"
        const val NOTES_URI = "content://$AUTHORITY/$NOTES_PATH"
        const val NOTES_ID = "content://$AUTHORITY/$NOTES_PATH/#"

        private val uriMatcher = UriMatcher(UriMatcher.NO_MATCH).apply {
            addURI(AUTHORITY, NOTES_PATH, 1)
            addURI(AUTHORITY, "$NOTES_PATH/#", 2)
        }
    }

    override fun query(uri: Uri, projection: Array<String>?,
        selection: String?, args: Array<String>?, sort: String?): Cursor? {
        return when (uriMatcher.match(uri)) {
            1 -> dbHelper.readableDatabase.query(TABLE_NOTES,
                projection, selection, args, null, null, sort)
            2 -> dbHelper.readableDatabase.query(TABLE_NOTES,
                projection, "_id=?", arrayOf(uri.lastPathSegment), null, null, null)
            else -> throw IllegalArgumentException("Unknown URI: $uri")
        }
    }

    override fun insert(uri: Uri, values: ContentValues?): Uri? {
        val id = dbHelper.writableDatabase.insert(TABLE_NOTES, null, values)
        context?.contentResolver?.notifyChange(uri, null)
        return ContentUris.withAppendedId(uri, id)
    }

    override fun delete(uri: Uri, selection: String?, args: Array<String>?): Int {
        val count = dbHelper.writableDatabase.delete(TABLE_NOTES, selection, args)
        context?.contentResolver?.notifyChange(uri, null)
        return count
    }

    // getType, update, onCreate ay inalis para sa kaiklian
}

Pagkatapos gawin ang klase, ang provider ay kailangang irehistro sa manifest na may mga attribute na android:authorities at android:exported (true kung ang provider ay pampubliko). Gumagawa ang system ng instance ng provider sa unang pag-access — ito ay nangyayari sa UI thread, kaya ang onCreate ay dapat na mabilis na maisagawa.

Pagprotekta ng Data sa pamamagitan ng mga Pahintulot

Ang Content Provider ay nagpapahintulot ng pamamahala ng access sa data sa dalawang antas: mga pahintulot sa pagbasa at mga pahintulot sa pagsulat. Ang mga ito ay itinakda sa manifest gamit ang mga attribute na android:readPermission at android:writePermission. Kung ang client application ay walang kaukulang pahintulot, tatanggihan ng system ang tawag na may SecurityException.

Pahintulot sa antas ng URI

Ang Android ay sumusuporta sa pansamantalang mga pahintulot sa pamamagitan ng mga flag na FLAG_GRANT_READ_URI_PERMISSION at FLAG_GRANT_WRITE_URI_PERMISSION. Ito ay kapaki-pakinabang kapag ang isang application ay nagpapasa ng URI ng file sa ibang application sa pamamagitan ng Intent — ang receiver ay nakakakuha lamang ng access sa partikular na URI para sa limitadong oras. Binabawi ng system ang pansamantalang pahintulot pagkatapos ng pagtatapos ng receiving application.

Para sa mga system provider, ang Android ay nangangailangan ng pagtukoy ng mga konkretong pahintulot sa manifest ng application. Halimbawa, para sa pag-access sa mga contact, kinakailangan ang READ_CONTACTS, para sa kalendaryo — READ_CALENDAR. Simula sa Android 6, ang mga pahintulot na ito ay hinihiling sa runtime, hindi sa pag-install.