🛠️ Entity ক্লাস – সহজ ভাষায় বুঝুন

Android অ্যাপে Room Database ব্যবহারের সময় Entity ক্লাস তৈরি করা হয়, যা একটি টেবিলের কাঠামো (Structure) নির্ধারণ করে।

---

📌 Entity ক্লাস কী?

Entity হলো একটি মডেল ক্লাস যা Room Database-এ টেবিলের মত কাজ করে।
এটি একটি রিয়েল ডাটাবেস টেবিলের রিপ্রেজেন্টেশন, যেখানে প্রতিটি ফিল্ড (ভেরিয়েবল) ডাটাবেসের একটি কলামের মত আচরণ করে।

🏛️ যেমন: আপনি যদি একটি User Table বানাতে চান, তাহলে User নামে একটি Entity ক্লাস তৈরি করতে হবে।

---

🎯 Entity ক্লাস কেন দরকার?

✅ Room Database স্বয়ংক্রিয়ভাবে এই ক্লাসকে SQLite টেবিলে কনভার্ট করে।
✅ কোড আরও সহজ ও ক্লিন হয়।
✅ ডাটাবেসের জন্য আলাদা SQL লেখা লাগে না, কারণ Room নিজেই টেবিল তৈরি করে।

---

🛠️ Entity ক্লাসের স্ট্রাকচার

একটি সাধারণ User Entity ক্লাস দেখুন 👇

import androidx.room.Entity
import androidx.room.PrimaryKey

@Entity(tableName = "users")
data class User(
    @PrimaryKey(autoGenerate = true) val id: Int = 0,
    val name: String,
    val email: String,
    val age: Int
)

🚀 এখানে কী ঘটল?

✔ @Entity(tableName = "users") → এটি User ক্লাসকে একটি ডাটাবেস টেবিল বানিয়েছে।
✔ @PrimaryKey(autoGenerate = true) → id ফিল্ডটি প্রাইমারি কি এবং এটি স্বয়ংক্রিয়ভাবে বাড়বে।
✔ অন্য ফিল্ডগুলো (name, email, age) প্রতিটি কলামের মত কাজ করবে।

---

📌 Room Entity কীভাবে টেবিলে কনভার্ট করে?

ওপরের User Entity কে SQLite টেবিলে কনভার্ট করলে এরকম হবে 👇

CREATE TABLE users (
    id INTEGER PRIMARY KEY AUTOINCREMENT,
    name TEXT NOT NULL,
    email TEXT NOT NULL,
    age INTEGER NOT NULL
);

💡 Room নিজে থেকেই এই SQL রান করে! আপনাকে SQL লিখতে হয় না। 😍

---

🔹 অতিরিক্ত Entity Annotation সমূহ

Entity ক্লাসে আরও কিছু গুরুত্বপূর্ণ অ্যানোটেশন রয়েছে 👉

১️⃣ @PrimaryKey (প্রাইমারি কি নির্ধারণ করে)

@PrimaryKey(autoGenerate = true) val id: Int

✔ এটি প্রাইমারি কি সেট করে।
✔ autoGenerate = true দিলে এটি স্বয়ংক্রিয়ভাবে সংখ্যা ইনক্রিমেন্ট করে (1, 2, 3...)

---

২️⃣ @ColumnInfo (কলামের নাম কাস্টমাইজ করা যায়)

@ColumnInfo(name = "user_name") val name: String

✔ ডাটাবেজে কলামের নাম আলাদা রাখতে চাইলে এটি ব্যবহার করা হয়।

📌 যেমন, যদি আপনি চান Room টেবিলের কলামের নাম user_name হবে, কিন্তু ভেরিয়েবল নাম name থাকবে, তাহলে এটি ব্যবহার করবেন।

---

৩️⃣ @Ignore (ডাটাবেজে সংরক্ষণ না করার জন্য)

@Ignore val tempData: String

✔ এই ভেরিয়েবলটি Room Database-এ সংরক্ষণ হবে না।
✔ শুধু অ্যাপে লজিকের জন্য ব্যবহার করা যাবে।

---

৪️⃣ @Embedded (অন্য ক্লাসকে ইনক্লুড করা)

কখনও কখনও আমরা চাই একটি Entity-এর মধ্যে আরেকটি ক্লাস রাখতে। তখন @Embedded ব্যবহার করা হয়।

data class Address(
    val street: String,
    val city: String,
    val country: String
)

@Entity
data class User(
    @PrimaryKey(autoGenerate = true) val id: Int = 0,
    val name: String,
    @Embedded val address: Address
)

✔ এটি আলাদা Address টেবিল না বানিয়ে User টেবিলেই Address-এর তথ্য স্টোর করবে।

---

🔍 Entity ক্লাস ব্যবহারের উদাহরণ

এখন যদি আপনি একটি User Entity ডাটাবেজে ইনসার্ট করতে চান, তাহলে 👇

val user = User(name = "John Doe", email = "john@example.com", age = 25)
userDao.insertUser(user)

✔ Room Database এটি SQLite-তে সংরক্ষণ করবে! 🚀

---

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

✅ Entity ক্লাস হলো একটি টেবিলের ডিজাইন যা Room Database-এ সংরক্ষিত হয়।
✅ Room API স্বয়ংক্রিয়ভাবে Entity ক্লাস থেকে SQLite টেবিল তৈরি করে।
✅ Primary Key, Column Info, Ignore, Embedded – এই এনোটেশনগুলো Entity ক্লাস কাস্টমাইজ করতে সাহায্য করে।
✅ Room Entity ব্যবহার করলে ডাটাবেস সংক্রান্ত কোড অনেক সহজ ও মেইনটেইনেবল হয়।

🔥 তাহলে, এখন থেকে যখন Room Database ব্যবহার করবেন, তখন Entity ক্লাস তৈরি করাটা বাধ্যতামূলক! 😃🚀

🛠 Entity Class - Understand in simple language