🧠 Mapper Class – ব্রেইন-ফ্রেন্ডলি ব্যাখ্যা (Kotlin)

তুমি যদি কখনও এমন সিচুয়েশন দেখো যেখানে একটা ডাটা ক্লাসের ডাটা অন্য একটা ডাটা ক্লাসে ট্রান্সফার করতে হয়, তখন Mapper ক্লাস কাজে লাগে। 🤔

---

🎯 Mapper Class কী?

Mapper হল একটা কনভার্টার, যা একটা ডাটা টাইপকে আরেকটা ডাটা টাইপে রূপান্তর করে।

🔹 যখন দরকার?

• API থেকে আসা ডাটা (DTO) UI মডেলে কনভার্ট করতে
• Database Entity → UI Model
• UI Model → API Request
• এক ধরণের অবজেক্টকে আরেক ধরণের অবজেক্ট বানাতে

---

✨ একটা বাস্তব উদাহরণ

ধরো, তোমার অ্যাপে ইউজারের তথ্য API থেকে আসছে এই ফরম্যাটে:

data class UserDto(
    val id: Int,
    val fullName: String,
    val email: String
)

📌 কিন্তু তোমার UI-তে এই ফরম্যাট দরকার:

data class User(
    val userId: Int,
    val name: String,
    val email: String
)

---

🚀 Mapper Class তৈরি করা

এখন একটা Mapper ক্লাস বানাবো যা UserDto থেকে User বানাবে!

class UserMapper {
    fun map(dto: UserDto): User {
        return User(
            userId = dto.id,
            name = dto.fullName,
            email = dto.email
        )
    }
}

এখানে map() মেথডটা একটা UserDto ইনপুট নিয়ে User আউটপুট দিচ্ছে! 🚀

---

🏆 Extension Function দিয়ে আরও স্মার্ট ম্যাপিং

এখন UserMapper ক্লাস না রেখে একটা Extension Function দিয়ে সহজ করা যায়।

fun UserDto.toUser(): User {
    return User(
        userId = this.id,
        name = this.fullName,
        email = this.email
    )
}

এখন সহজেই UserDto থেকে User বানানো যাবে:

val userDto = UserDto(1, "John Doe", "john@example.com")
val user = userDto.toUser()

println(user) // Output: User(userId=1, name=John Doe, email=john@example.com)

🔥 আরও সহজ ও ক্লিন কোড!

---

🎭 List Mapping (Multiple Items)

একটা List<UserDto> কে List<User> বানাতে চাইলে সহজ উপায়:

fun List<UserDto>.toUserList(): List<User> {
    return this.map { it.toUser() }
}

এখন লিস্টের সব UserDto কে এক ক্লিকে User বানানো যাবে!

val userList = listOf(
    UserDto(1, "John Doe", "john@example.com"),
    UserDto(2, "Jane Smith", "jane@example.com")
)

val mappedUsers = userList.toUserList()

println(mappedUsers)

---

💡 আরও অ্যাডভান্সড Mapper

যদি বাই-ডাইরেকশনাল (উভয় দিক থেকে) ম্যাপিং দরকার হয়, তাহলে Mapper ইন্টারফেস বানানো যেতে পারে:

interface Mapper<I, O> {
    fun map(input: I): O
    fun reverseMap(output: O): I
}

এখন UserMapper ইমপ্লিমেন্ট করলে দুইদিকের ম্যাপিং সহজ হবে:

class UserMapper : Mapper<UserDto, User> {
    override fun map(input: UserDto): User {
        return User(
            userId = input.id,
            name = input.fullName,
            email = input.email
        )
    }

    override fun reverseMap(output: User): UserDto {
        return UserDto(
            id = output.userId,
            fullName = output.name,
            email = output.email
        )
    }
}

এখন দুই দিকের ম্যাপিং করা যাবে:

val userMapper = UserMapper()

val userDto = UserDto(3, "Alice", "alice@example.com")
val user = userMapper.map(userDto)
val backToDto = userMapper.reverseMap(user)

println(user)       // User(userId=3, name=Alice, email=alice@example.com)
println(backToDto)  // UserDto(id=3, fullName=Alice, email=alice@example.com)

---

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

✅ Separation of Concerns: Model ট্রান্সফর্মের কাজ আলাদা হয়ে যায়
✅ Code Reusability: একবার লিখলে বারবার ব্যবহার করা যায়
✅ Clean Architecture: Data Layer, Domain Layer, UI Layer আলাদা রাখতে সাহায্য করে

---

🔥 Mapper নিয়ে আরও কিছু আইডিয়া

• Room Database Entity → Domain Model
• API Response → UI Model
• Multiple Data Source মিক্সিং করতে

🔥 এখন বলো, তোমার অ্যাপে কোথায় Mapper দরকার? 😎

🧠 Mapper Class-Brain-Friendly Explanation (Kotlin)