🛠️ Converter Class – সহজ ভাষায় বুঝুন

Room Database সাধারণত প্রিমিটিভ টাইপের ডাটা (যেমন Int, String, Boolean, ইত্যাদি) সংরক্ষণ করতে পারে।
কিন্তু যদি আমরা কাস্টম অবজেক্ট বা জটিল ডাটা টাইপ (যেমন List, Date, Enum, Map) সংরক্ষণ করতে চাই তাহলে কী হবে? 🤔

✅ সেখানেই দরকার হয় @TypeConverter বা কনভার্টার ক্লাস!

---

📌 Converter Class কী?

🔹 Converter Class এমন একটি ক্লাস, যা Room Database-কে বলে দেয়, কীভাবে একটি জটিল ডাটা টাইপকে SQLite-এর জন্য সাপোর্টেড ফরম্যাটে রূপান্তর করতে হবে এবং পরে আবার আগের ফরম্যাটে ফিরিয়ে আনতে হবে।

💡 সহজ করে বললে – এটি একটি ডাটা ফরম্যাট পরিবর্তন করার মাধ্যম।

---

🎯 Converter Class কেন দরকার?

👉 Room Database সরাসরি List, Date, Map, বা Custom Object স্টোর করতে পারে না।
👉 তাই এগুলোকে String বা অন্য সাপোর্টেড ফরম্যাটে কনভার্ট করে স্টোর করতে হয়।
👉 পরে আবার সেগুলোকে আগের মতো রূপান্তর করতে হয়।
👉 এটাই Converter Class-এর কাজ!

---

🚀 কনভার্টার ক্লাস তৈরি করা শিখুন!

১️⃣ Date (তারিখ) কনভার্টার

Room Database সরাসরি Date সংরক্ষণ করতে পারে না।
তাই Date → Timestamp (Long) এবং Timestamp → Date কনভার্ট করতে হবে।

import androidx.room.TypeConverter
import java.util.Date

class DateConverter {
    @TypeConverter
    fun fromTimestamp(value: Long?): Date? {
        return value?.let { Date(it) }
    }

    @TypeConverter
    fun dateToTimestamp(date: Date?): Long? {
        return date?.time
    }
}

✔ fromTimestamp → SQLite থেকে Long নিয়ে Date বানায়।
✔ dateToTimestamp → Date থেকে Long বানিয়ে SQLite-তে সংরক্ষণ করে।

---

২️⃣ List (তালিকা) কনভার্টার

Room সরাসরি List<String> সংরক্ষণ করতে পারে না, তাই এটিকে String-এ কনভার্ট করতে হবে।

import androidx.room.TypeConverter
import com.google.gson.Gson
import com.google.gson.reflect.TypeToken

class ListConverter {
    @TypeConverter
    fun fromString(value: String): List<String> {
        return Gson().fromJson(value, object : TypeToken<List<String>>() {}.type)
    }

    @TypeConverter
    fun listToString(list: List<String>): String {
        return Gson().toJson(list)
    }
}

✔ fromString → String কে List<String> এ কনভার্ট করে।
✔ listToString → List<String> কে JSON String-এ কনভার্ট করে ডাটাবেসে সংরক্ষণ করে।

---

৩️⃣ Enum (এনাম) কনভার্টার

যদি আপনার অ্যাপে Enum টাইপের ডাটা থাকে, তাহলে এটিকেও String বা Int-এ কনভার্ট করতে হবে।

import androidx.room.TypeConverter

enum class UserType { ADMIN, MEMBER, GUEST }

class EnumConverter {
    @TypeConverter
    fun fromUserType(userType: UserType): String {
        return userType.name
    }

    @TypeConverter
    fun toUserType(value: String): UserType {
        return UserType.valueOf(value)
    }
}

✔ fromUserType → UserType কে String বানিয়ে SQLite-তে রাখবে।
✔ toUserType → String কে আবার UserType-এ রূপান্তর করবে।

---

🔹 কনভার্টার ক্লাস কীভাবে Room Database-এ যুক্ত করবেন?

👉 প্রথমে, কনভার্টার ক্লাস তৈরি করতে হবে।
👉 তারপর, @Database অ্যানোটেশন-এর মধ্যে TypeConverters ব্যবহার করতে হবে।

@Database(entities = [User::class], version = 1)
@TypeConverters(DateConverter::class, ListConverter::class, EnumConverter::class)
abstract class AppDatabase : RoomDatabase() {
    abstract fun userDao(): UserDao
}

✔ এটি Room কে বলে দেবে, কোন কোন কনভার্টার ক্লাস ব্যবহার করতে হবে।

---

🔍 উপসংহার (Final Thoughts)

✅ Room সরাসরি Custom Object বা Complex Data Type সংরক্ষণ করতে পারে না।
✅ Converter Class ব্যবহার করে এগুলোকে সাপোর্টেড ফরম্যাটে রূপান্তর করা যায়।
✅ Date, List, Enum, Map ইত্যাদির জন্য TypeConverter ব্যবহার করতে হয়।
✅ Room Database-এর @TypeConverters দিয়ে একাধিক কনভার্টার ক্লাস যুক্ত করা যায়।

🔥 এখন আপনি Converter Class-এর কাজ বুঝে ফেলেছেন! 😃🚀