Room ব্যবহার করে লোকাল ডেটাবেসে ডেটা সেভ করা   Android Jetpack-এর অংশ।

Kotlin Multiplatform-এর সাথে চেষ্টা করুন

Kotlin Multiplatform অন্যান্য প্ল্যাটফর্মের সাথে ডেটাবেস লেয়ার শেয়ার করার অনুমতি দেয়। KMP-তে কীভাবে রুম ডেটাবেস সেট-আপ করতে ও ব্যবহার করতে হয় তা জানুন

KMP-এর জন্য রুম ডেটাবেস সেট-আপ করুন →

যেসব অ্যাপে প্রচুর পরিমাণে স্ট্রাকচার্ড ডেটা ম্যানেজ করা হয়, সেগুলি ডেটা লোকাল স্টোরেজে সেভ করে রাখলে অনেক সুবিধা পেতে পারে। সবচেয়ে সাধারণ ব্যবহার হল প্রাসঙ্গিক ডেটার অংশ ক্যাশে করা যাতে ডিভাইস নেটওয়ার্ক অ্যাক্সেস করতে না পারলেও, আপনার ব্যবহারকারীরা অফলাইনে থাকাকালীন সেই কন্টেন্ট ব্রাউজ করতে পারেন।

রুম পারসিসটেন্স লাইব্রেরি SQLite-এর উপর একটি অ্যাবস্ট্রাকশন লেয়ার প্রদান করে যাতে SQLite-এর সম্পূর্ণ ক্ষমতা ব্যবহার করার সময় ডেটাবেস অ্যাক্সেস করা যায়। বিশেষ করে, Room নিম্নলিখিত সুবিধাগুলি প্রদান করে:

• SQL কোয়েরির কম্পাইল-টাইম যাচাইকরণ।
• সুবিধাজনক অ্যানোটেশন যা পুনরাবৃত্তিমূলক এবং ত্রুটি-প্রবণ বয়লারপ্লেট কোড কম করে।
• স্ট্রীমলাইনড ডেটাবেস মাইগ্রেশন পাথ।

সরাসরি SQLite API ব্যবহার করার পরিবর্তে আমরা Room ব্যবহার করার সাজেশন দিই।

সেট-আপ করুন

আপনার অ্যাপে Room ব্যবহার করতে, আপনার মডিউলের build.gradle.kts ফাইলে নিম্নলিখিত ডিপেন্ডেন্সি যোগ করুন। Room 3.0-এর জন্য অ্যানোটেশন প্রসেসিংয়ের ক্ষেত্রে KSP প্রয়োজন।

dependencies {
    val room_version = "3.0.3"

    implementation("androidx.room3:room3-runtime:$room_version")
    ksp("androidx.room3:room3-compiler:$room_version")
}

dependencies {
    def room_version = "3.0.3"

    implementation "androidx.room3:room3-runtime:$room_version"

    ksp "androidx.room3:room3-compiler:$room_version"
}

প্রাথমিক কম্পোনেন্ট

Room-এ তিনটি প্রধান কম্পোনেন্ট আছে:

• ডেটাবেস ক্লাস যা ডেটাবেস হোল্ড করে এবং আপনার অ্যাপের সেভ করা ডেটার সাথে অন্তর্নিহিত কানেকশনের জন্য প্রধান অ্যাক্সেস পয়েন্ট হিসেবে কাজ করে।
• ডেটা এন্টিটি যা আপনার অ্যাপের ডেটাবেসে টেবিলকে উপস্থাপন করে।
• ডেটা অ্যাক্সেস অবজেক্ট (DAO) যা এমন ফাংশন প্রদান করে যা আপনার অ্যাপ ডেটাবেসে ডেটা কোয়েরি, আপডেট, ইনসার্ট ও মুছে ফেলার জন্য ব্যবহার করতে পারে।

ডেটাবেস ক্লাস আপনার অ্যাপকে সেই ডেটাবেসের সাথে যুক্ত DAO-এর ইনস্ট্যান্স প্রদান করে। পরিবর্তে, অ্যাপটি সংশ্লিষ্ট ডেটা এন্টিটি অবজেক্টের ইনস্ট্যান্স হিসেবে ডেটাবেস থেকে ডেটা ফিরিয়ে আনতে DAO ব্যবহার করতে পারে। এছাড়াও, অ্যাপটি সংশ্লিষ্ট টেবিল থেকে সারি আপডেট করতে বা যোগ করার জন্য নতুন সারি তৈরি করতে নির্দিষ্ট ডেটা এন্টিটি ব্যবহার করতে পারে। ১ নম্বর চিত্রে Room-এর বিভিন্ন কম্পোনেন্টগুলির মধ্যে সম্পর্ক দেখানো হয়েছে।

প্রয়োগের নমুনা

এই বিভাগে একটি ডেটা এন্টিটি ও একটি DAO সহ Room ডেটাবেসের একটি উদাহরণ প্রয়োগ দেখানো হয়েছে।

ডেটা এন্টিটি

নিম্নলিখিত কোডটি একটি User ডেটা এন্টিটি সংজ্ঞায়িত করে। User-এর প্রতিটি ইনস্ট্যান্স অ্যাপের ডেটাবেসে user টেবিলের একটি সারিকে দেখায়।

@Entity
data class User(
    @PrimaryKey val uid: Int,
    @ColumnInfo(name = "first_name") val firstName: String,
    @ColumnInfo(name = "last_name") val lastName: String
)
IndexSnippets.kt

Room-এ ডেটা এন্টিটি সম্পর্কে আরও জানতে, Room এন্টিটি ব্যবহার করে ডেটা সংজ্ঞায়িত করা দেখুন।

ডেটা অ্যাক্সেস অবজেক্ট (DAO)

নিম্নলিখিত কোড UserDao নামের DAO-কে সংজ্ঞায়িত করে। UserDao সেইসব ফাংশন প্রদান করে যা অ্যাপের বাকি অংশ user টেবিলের ডেটার সাথে ইন্টার‍্যাক্ট করার জন্য ব্যবহার করে।

@Dao
interface UserDao {
    @Query("SELECT * FROM user")
    suspend fun getAll(): List<User>

    @Query("SELECT * FROM user WHERE uid IN (:userIds)")
    suspend fun loadAllByIds(userIds: IntArray): List<User>

    @Query(
        """
        SELECT * FROM user
        WHERE first_name LIKE :first AND last_name LIKE :last LIMIT 1
        """
    )
    suspend fun findByName(first: String, last: String): User

    @Insert
    suspend fun insertAll(vararg users: User)

    @Delete
    suspend fun delete(user: User)
}
IndexSnippets.kt

DAO সম্পর্কে আরও জানতে, Room DAO ব্যবহার করে ডেটা অ্যাক্সেস করা দেখুন।

ডেটাবেস

নিম্নলিখিত কোডটি ডেটাবেস ধরে রাখার জন্য একটি AppDatabase ক্লাসকে সংজ্ঞায়িত করে। AppDatabase ডেটাবেস কনফিগারেশন নির্ধারণ করে এবং অ্যাপের প্রধান অ্যাক্সেস পয়েন্ট হিসেবে পারসিস্টেড ডেটা প্রদান করে। ডেটাবেস ক্লাসকে অবশ্যই নিম্নলিখিত শর্তগুলি পূরণ করতে হবে:

• ক্লাসটিকে অবশ্যই এমন একটি @Database অ্যানোটেশন দিয়ে অ্যানোটেট করতে হবে যা একটি entities অ্যারে অন্তর্ভুক্ত করে যা ডেটাবেসের সাথে যুক্ত সমস্ত ডেটা এন্টিটির তালিকা তৈরি করে।
• ক্লাসটি অবশ্যই একটি অ্যাবস্ট্র্যাক্ট ক্লাস হতে হবে যা RoomDatabase এক্সটেন্ড করে।
• ডেটাবেসের সাথে যুক্ত প্রতিটি DAO ক্লাসের জন্য, ডেটাবেস ক্লাসকে অবশ্যই একটি অ্যাবস্ট্রাক্ট ফাংশন ডিফাইন করতে হবে যা কোনও আর্গুমেন্ট নেয় না এবং DAO ক্লাসের একটি ইনস্ট্যান্স রিটার্ন করে।

@Database(entities = [User::class], version = 1)
abstract class AppDatabase : RoomDatabase() {
    abstract fun userDao(): UserDao
}
IndexSnippets.kt

ব্যবহার

ডেটা এন্টিটি, DAO এবং ডেটাবেস অবজেক্ট সংজ্ঞায়িত করার পরে, আপনি ডেটাবেসের ইনস্ট্যান্স তৈরি করতে নিম্নলিখিত কোড ব্যবহার করতে পারবেন:

val db =
    Room.databaseBuilder<AppDatabase>(applicationContext, "database-name")
        .setDriver(AndroidSQLiteDriver())
        .build()
IndexSnippets.kt

তারপরে, DAO-এর একটি ইনস্ট্যান্স পেতে আপনি AppDatabase থেকে অ্যাবস্ট্রাক্ট ফাংশন ব্যবহার করতে পারবেন। এর পরিবর্তে, আপনি ডেটাবেসের সাথে ইন্টার‍্যাক্ট করতে DAO ইনস্ট্যান্স থেকে ফাংশন ব্যবহার করতে পারবেন:

val userDao = db.userDao()
val users: List<User> = userDao.getAll()
IndexSnippets.kt

অতিরিক্ত রিসোর্স

Room সম্পর্কে আরও জানতে, নিম্নলিখিত অতিরিক্ত রিসোর্স দেখুন:

নমুনা