- Room vepron si një shtresë e fuqishme abstraksioni mbi SQLite që thjeshton qëndrueshmërinë e të dhënave të strukturuara.
- Arkitektura bazohet në tre shtylla themelore: Entitete për tabelat, DAO për pyetjet dhe një klasë Baze të Dhënash për menaxhim.
- Ai lejon zbatimin e strategjive "offline-first" duke u integruar me Flow, ViewModel dhe Jetpack Compose për të krijuar ndërfaqe reaktive.
Kur zhvillojmë aplikacione që duhet të trajtojnë një sasi të konsiderueshme të dhënash, nuk mund të mbështetemi gjithmonë te përdoruesi që ka një lidhje interneti perfekte. Imagjinoni aplikacionin tuaj të ngrijë ose të bjerë për shkak se përdoruesi ka hyrë në një ashensor; do të ishte një katastrofë për përvojën e përdoruesit. Kjo është arsyeja pse ruajtja e të dhënave në nivel lokal është zgjidhja ideale, duke lejuar që përmbajtja të ruhet në memorien e përkohshme dhe duke siguruar navigim të qetë edhe në modalitetin e aeroplanit.
Për ta zgjidhur këtë pa u zhytur në kod, Google ofron bibliotekën e persistencës Room. Në thelb, është një mbështjellës i sofistikuar që vendoset sipër SQLite, duke eliminuar punën e lodhshme manuale të shkrimit të pyetjeve të prirura për gabime. Room jo vetëm që kursen kohë, por edhe validon pyetjet SQL në kohën e kompajlimit , që do të thotë se nëse bëni një gabim, sistemi do t'ju paralajmërojë përpara se aplikacioni të arrijë në pajisjen e përdoruesit.
Shtyllat themelore të Dhomës

Që Room të funksionojë, duhet të krijojmë një strukturë të bazuar në tre komponentë kryesorë. Së pari, kemi Data Entities , të cilat janë klasa Kotlin që përcaktojnë strukturën e tabelave. Çdo veti e klasës përkthehet në një kolonë në bazën e të dhënave. Për ta bërë këtë të funksionojë, ne përdorim shënimin @Entity , dhe është thelbësore të caktojmë një çelës primar me @PrimaryKey në mënyrë që çdo regjistrim të jetë unik dhe të mos përsëritet.
Së dyti janë Objektet e Qasjes në të Dhëna (DAO) . Këtu ndodh gjithë magjia. Në vend që të hapim manualisht lidhjet, ne krijojmë një ndërfaqe të shënuar me @Dao ku përcaktojmë metodat për futjen, fshirjen ose kërkimin e informacionit. Mund të përdorim metoda të përshtatshme si @Insert, @Update ose @Delete për detyra të thjeshta, ose të përdorim @Query kur duhet të shkruajmë SQL të pastër për filtrim kompleks.
Së fundmi, na duhet klasa e bazës së të dhënave . Kjo duhet të jetë një klasë abstrakte që trashëgon nga RoomDatabase dhe vepron si pika qendrore e aksesit. Për të parandaluar që aplikacioni të konsumojë burime në mënyrë të pakontrollueshme ose të shkaktojë konflikte shkrimi, qasja më e zgjuar është ta zbatojmë atë duke përdorur modelin Singleton , duke siguruar që vetëm një instancë të jetë e hapur në çdo kohë të caktuar.
Konfigurimi teknik dhe varësitë

Për të filluar, hapi i parë është të konfiguroni skedarin build.gradle . Aktualisht, rekomandimi është të largoheni nga kapt dhe të kaloni në KSP (Kotlin Symbol Processing) , pasi ai përpunon shënimet shumë më shpejt dhe e bën vendosjen më efikase. Në varësi të versionit që po përdorni, do t'ju duhet të shtoni Room runtime dhe kompiluesin përkatës në seksionin e varësive.
Nëse e gjeni veten të nevojshme të ruani lloje të dhënash që SQLite nuk i kupton si parazgjedhje, siç janë datat (Date), mund të krijoni një klasë Type Converter . Duke përdorur shënimin @TypeConverter , mund t'i tregoni Room se si të transformojë, për shembull, një objekt Date në një Long dhe anasjelltas, në mënyrë që baza e të dhënave të mund ta ruajë atë pa problem.
Menaxhim i avancuar i të dhënave dhe marrëdhënieve

Në botën reale, të dhënat nuk janë të izoluara; ato janë të ndërlidhura. Dhoma ju lejon të trajtoni marrëdhënie një-me-një, një-me-shumë dhe shumë-me-shumë . Megjithatë, për të shmangur mbingarkesën e fijes kryesore të ndërfaqes dhe shkaktimin e ngrirjes së aplikacionit, nuk duhet të përdorni referenca të drejtpërdrejta midis entiteteve. Qasja e saktë është të krijoni klasa të ndërmjetme të të dhënave që përdorin shënimet @Relation dhe @Embedded për të grupuar në mënyrë efikase informacionin nga tabela të ndryshme.
Një pikë tjetër kritike është mirëmbajtja e skemës. Nëse vendosni të shtoni një kolonë të re në një tabelë ekzistuese, nuk mund ta fshini thjesht bazën e të dhënave të përdoruesit sepse do të humbisnit të gjitha të dhënat e tyre. Këtu hyjnë në lojë migrimet e bazës së të dhënave . Mund të përcaktoni shtigje manuale duke përdorur objektet e Migration ose, nëse përdorni versione të fundit, përfitoni nga @AutoMigration që Room të trajtojë automatikisht ndryshimet themelore.
Nga qasja e vjetër në epokën e Jetpack Compose

Duke parë prapa, ne përdornim SQLiteOpenHelper , një proces i lodhshëm ku shkruanim manualisht SQL dhe menaxhonim rezultatet me kursorë. Ishte një makth sepse çdo gabim shtypi në një varg do të shkaktonte bllokimin e aplikacionit gjatë kohës së ekzekutimit. Tani, integrimi me Jetpack Compose e ka ndryshuar plotësisht lojën. Duke kombinuar Room me Flow ose StateFlow , arrijmë një arkitekturë reaktive.
Në këtë rrjedhë pune moderne, ViewModel vepron si një urë: DAO kthen një rrjedhë të dhënash dhe ndërfaqja Compose rikompozohet automatikisht sa herë që të dhënat ndryshojnë në bazën e të dhënave. Zhvilluesi nuk ka më nevojë të rifreskojë manualisht ekranin; ndërfaqja e përdoruesit thjesht reagon ndaj ndryshimeve në ruajtjen lokale në kohë reale.
Strategji për një modalitet offline të pakrahasueshëm
Fuqia e vërtetë e Room zbulohet kur zbatoni një strategji "offline-first" . Ideja është që aplikacioni gjithmonë pyet fillimisht bazën e të dhënave lokale. Nëse informacioni mungon ose është i vjetëruar, depoja bën një kërkesë te një API e jashtme dhe e ruan rezultatin në Room. Për ta çuar këtë në nivelin tjetër, mund të kombinohet me WorkManager , duke lejuar që sinkronizimi i të dhënave të ndodhë në sfond, edhe nëse përdoruesi e ka mbyllur aplikacionin.
Për ata që tashmë kanë një bazë të dhënash të krijuar nga jashtë, Room ofron metodën .createFromAsset() . Kjo ju lejon të ngarkoni paraprakisht aplikacionin me të dhënat ekzistuese nga dosja e aseteve, duke shmangur nevojën për të ekzekutuar skripte komplekse insertimi kur e nisni aplikacionin për herë të parë.
Zotërimi i triadës së Entiteteve, DAO-ve dhe Bazave të të Dhënave, i kombinuar me reaktivitetin e Compose, ju lejon të ndërtoni aplikacione të fuqishme që garantojnë që informacioni të jetë gjithmonë i disponueshëm. Duke kaluar nga menaxhimi manual i kursorit në një shtresë inteligjente abstraksioni, ne jo vetëm që përmirësojmë performancën dhe stabilitetin e softuerit, por gjithashtu thjeshtojmë në mënyrë drastike mirëmbajtjen afatgjatë të kodit burimor.