MapStruct এবং Lombok Integration গাইড ও নোট

MapStruct এবং Lombok দুটি জনপ্রিয় লাইব্রেরি যা Java প্রোগ্রামিংয়ে খুবই কার্যকরী। MapStruct ডোমেইন অবজেক্ট এবং DTO (Data Transfer Object) এর মধ্যে ম্যাপিং করার জন্য ব্যবহৃত হয়, এবং Lombok ক্লাসের জন্য সাধারণভাবে ব্যবহৃত কনস্ট্রাক্টর, গেটার, সিটার, টু-স্ট্রিং এবং অন্যান্য ফাংশন অটোমেটিক্যালি তৈরি করে দেয়। একসাথে ব্যবহার করলে, MapStruct এবং Lombok আপনার কোডকে আরও ক্লিন এবং মেইনটেইনযোগ্য করে তোলে।

১. MapStruct এবং Lombok এর Integration এর সুবিধা

MapStruct এর মাধ্যমে ম্যাপিং কোড জেনারেট করা হয়, যেখানে আপনি Lombok এর মাধ্যমে আপনার ডোমেইন অবজেক্টের গেটার, সিটার এবং কনস্ট্রাক্টর অটোমেটিক্যালি তৈরি করতে পারেন। এটি কোড লেখার সময় কমিয়ে দেয় এবং ব্যবস্থাপনা সহজ করে তোলে। বিশেষত, Lombok ব্যবহার করে অ্যানোটেশন প্রক্রিয়া সরাসরি MapStruct এর সাথে সহজভাবে কাজ করে।

সুবিধা:

1. Code Cleanliness: Lombok এর মাধ্যমে ক্লাসের সাধারণ মেথডগুলি স্বয়ংক্রিয়ভাবে তৈরি হয়ে যায়, ফলে ক্লাসটি সোজা এবং পরিষ্কার হয়।
2. Less Boilerplate Code: Lombok এর মাধ্যমে গেটার, সিটার, কনস্ট্রাক্টর ইত্যাদি অটোমেটিক্যালি তৈরি হওয়ায় আপনার কোডের অপ্রয়োজনীয় অংশ কমে যায়।
3. Easy Integration: Lombok এবং MapStruct সহজেই একত্রিত করা যায় এবং একে অপরের সাথে সমন্বিতভাবে কাজ করে।

২. MapStruct এবং Lombok ব্যবহার করে ম্যাপিং কনফিগারেশন

MapStruct এবং Lombok একত্রে ব্যবহারের জন্য, আপনাকে দুটি লাইব্রেরি pom.xml বা build.gradle ফাইলে অন্তর্ভুক্ত করতে হবে।

Maven Dependency (pom.xml)

<dependencies>
    <!-- MapStruct Dependency -->
    <dependency>
        <groupId>org.mapstruct</groupId>
        <artifactId>mapstruct</artifactId>
        <version>1.5.2.Final</version>
    </dependency>

    <!-- Lombok Dependency -->
    <dependency>
        <groupId>org.projectlombok</groupId>
        <artifactId>lombok</artifactId>
        <version>1.18.22</version>
        <scope>provided</scope>
    </dependency>

    <!-- MapStruct Processor Dependency -->
    <dependency>
        <groupId>org.mapstruct</groupId>
        <artifactId>mapstruct-processor</artifactId>
        <version>1.5.2.Final</version>
        <scope>provided</scope>
    </dependency>
</dependencies>

Gradle Dependency (build.gradle)

dependencies {
    implementation 'org.mapstruct:mapstruct:1.5.2.Final'
    annotationProcessor 'org.mapstruct:mapstruct-processor:1.5.2.Final'

    compileOnly 'org.projectlombok:lombok:1.18.22'
    annotationProcessor 'org.projectlombok:lombok:1.18.22'
}

এখানে, Lombok এবং MapStruct এর জন্য প্রয়োজনীয় ডিপেনডেন্সি এবং প্লাগইন যোগ করা হয়েছে।

৩. Lombok অ্যানোটেশন ব্যবহার করা

MapStruct এর সাথে Lombok ব্যবহার করার জন্য, Lombok এর সাধারণ অ্যানোটেশন যেমন @Getter, @Setter, @AllArgsConstructor, এবং @NoArgsConstructor ব্যবহার করতে হবে। Lombok এই অ্যানোটেশনগুলি ব্যবহার করে স্বয়ংক্রিয়ভাবে প্রয়োজনীয় মেথডগুলি তৈরি করে।

উদাহরণ:

Employee.java (Domain Object):

import lombok.Getter;
import lombok.Setter;
import lombok.AllArgsConstructor;
import lombok.NoArgsConstructor;

@Getter
@Setter
@AllArgsConstructor
@NoArgsConstructor
public class Employee {
    private String name;
    private String department;
    private int age;
}

এখানে, @Getter, @Setter, @AllArgsConstructor, এবং @NoArgsConstructor অ্যানোটেশনগুলি Lombok দ্বারা স্বয়ংক্রিয়ভাবে গেটার, সিটার এবং কনস্ট্রাক্টর তৈরি করবে।

৪. MapStruct Mapper ইন্টারফেস কনফিগারেশন

এখন, MapStruct এর সাহায্যে Employee ডোমেইন অবজেক্ট এবং EmployeeDTO এর মধ্যে ম্যাপিং কনফিগার করা যাবে। এখানে, MapStruct এর Mapper ইন্টারফেস ব্যবহার করা হবে।

উদাহরণ:

EmployeeDTO.java (DTO):

import lombok.Getter;
import lombok.Setter;

@Getter
@Setter
public class EmployeeDTO {
    private String name;
    private String department;
}

EmployeeMapper.java (Mapper Interface):

import org.mapstruct.Mapper;
import org.mapstruct.factory.Mappers;

@Mapper(componentModel = "spring")
public interface EmployeeMapper {
    EmployeeMapper INSTANCE = Mappers.getMapper(EmployeeMapper.class);

    EmployeeDTO employeeToEmployeeDTO(Employee employee);
}

এখানে, @Mapper(componentModel = "spring") অ্যানোটেশন ব্যবহার করে MapStruct কে Spring Bean হিসেবে কনফিগার করা হয়েছে, যাতে Spring এর মধ্যে এটি অটোমেটিক্যালি ইনজেক্ট করা যায়।

৫. MapStruct এবং Lombok এর মধ্যে একত্রিত উদাহরণ

ধরা যাক, একটি Employee ক্লাস থেকে EmployeeDTO ক্লাসে ম্যাপিং করতে হবে। Lombok এর সাহায্যে Employee ক্লাসের জন্য গেটার, সিটার এবং কনস্ট্রাক্টর তৈরি করা হবে এবং MapStruct এর মাধ্যমে ম্যাপিং সম্পন্ন করা হবে।

Full Example:

Employee.java (Domain Object):

import lombok.Getter;
import lombok.Setter;
import lombok.AllArgsConstructor;
import lombok.NoArgsConstructor;

@Getter
@Setter
@AllArgsConstructor
@NoArgsConstructor
public class Employee {
    private String name;
    private String department;
    private int age;
}

EmployeeDTO.java (DTO):

import lombok.Getter;
import lombok.Setter;

@Getter
@Setter
public class EmployeeDTO {
    private String name;
    private String department;
}

EmployeeMapper.java (Mapper Interface):

import org.mapstruct.Mapper;
import org.mapstruct.factory.Mappers;

@Mapper(componentModel = "spring")
public interface EmployeeMapper {
    EmployeeMapper INSTANCE = Mappers.getMapper(EmployeeMapper.class);

    EmployeeDTO employeeToEmployeeDTO(Employee employee);
}

Main.java (Usage):

import org.springframework.beans.factory.annotation.Autowired;

public class Main {
    @Autowired
    private static EmployeeMapper employeeMapper;

    public static void main(String[] args) {
        Employee employee = new Employee("John Doe", "Engineering", 30);

        // MapStruct Mapping
        EmployeeDTO employeeDTO = employeeMapper.employeeToEmployeeDTO(employee);

        System.out.println("Employee DTO - Name: " + employeeDTO.getName());
        System.out.println("Employee DTO - Department: " + employeeDTO.getDepartment());
    }
}

এখানে:

• Lombok ব্যবহারের মাধ্যমে Employee এবং EmployeeDTO ক্লাসে গেটার, সিটার এবং কনস্ট্রাক্টর তৈরি করা হয়েছে।
• MapStruct ব্যবহৃত হয়েছে Employee থেকে EmployeeDTO এ ম্যাপিং করার জন্য।
• @Autowired ব্যবহার করে Spring এর মাধ্যমে EmployeeMapper ইনজেক্ট করা হয়েছে।

৬. Spring Boot এ MapStruct এবং Lombok ব্যবহার

Spring Boot এ MapStruct এবং Lombok একত্রে ব্যবহারের জন্য, আপনি @Mapper(componentModel = "spring") ব্যবহার করবেন, যা Spring Bean হিসেবে EmployeeMapper কে কনফিগার করবে। এর ফলে, এটি @Autowired এর মাধ্যমে Spring এর অন্যান্য অংশে ইনজেক্ট করা যাবে।

Spring Boot Example:

EmployeeMapper.java (Spring Configuration):

@Mapper(componentModel = "spring")
public interface EmployeeMapper {
    EmployeeDTO employeeToEmployeeDTO(Employee employee);
}

এখানে, componentModel = "spring" ব্যবহারের মাধ্যমে MapStruct কে Spring Bean হিসেবে কনফিগার করা হয়েছে, যাতে এটি Spring Application Context থেকে সরাসরি ইনজেক্ট করা যায়।

সারাংশ

MapStruct এবং Lombok একত্রে ব্যবহারের মাধ্যমে আপনি দ্রুত এবং কার্যকরী ম্যাপিং এবং ডোমেইন অবজেক্টের জন্য প্রয়োজনীয় মেথডগুলি অটোমেটিক্যালি তৈরি করতে পারবেন। MapStruct আপনাকে ডোমেইন অবজেক্ট এবং DTO এর মধ্যে ম্যাপিং সহজ করে দেয়, এবং Lombok গেটার, সিটার, কনস্ট্রাক্টর ইত্যাদি তৈরি করে কোড কমপ্লেক্সিটি কমায়। এই দুইটি লাইব্রেরি একত্রে ব্যবহারে আপনার কোড হবে আরও পরিষ্কার, কমপ্লেক্সিটি কম হবে এবং ডেভেলপমেন্টের সময় দ্রুত হবে।

Lombok হল একটি Java লাইব্রেরি যা ক্লাসের boilerplate কোড যেমন getters, setters, constructors, toString, equals, hashCode মেথড ইত্যাদি অটোমেটিক্যালি জেনারেট করে। Lombok ডেভেলপারদের জন্য কোড লেখার সময় সাশ্রয়ী এবং কোড আরও পরিস্কার ও সংক্ষিপ্ত করে। এটি মূলত annotation processor হিসেবে কাজ করে এবং কোড কমপাইল হওয়ার সময় অটোমেটিক্যালি কোড জেনারেট করে।

MapStruct এবং Lombok একসাথে ব্যবহার করার ফলে আপনি সহজেই object mapping এবং ডোমেইন মডেল তৈরি করতে পারেন, যেখানে Lombok আপনার ক্লাসের boilerplate কোড তৈরি করে, এবং MapStruct আপনার ডোমেইন অবজেক্টগুলির মধ্যে ম্যাপিং সম্পন্ন করে।

১. Lombok এর প্রয়োজনীয়তা

Java প্রোগ্রামিং ভাষায়, ডোমেইন অবজেক্ট (POJO) বা Plain Old Java Object তৈরি করতে গেলে বারবার একই ধরনের কোড লেখার প্রয়োজন হয়, যেমন:

• Getter এবং Setter মেথড
• Constructor (অথবা প্রপার্টি ভিত্তিক কনস্ট্রাক্টর)
• toString() মেথড
• equals() এবং hashCode() মেথড

এই সবকিছু ম্যানুয়ালি কোড করা ডেভেলপারদের জন্য অত্যন্ত সময়সাপেক্ষ এবং এটি কোডের পাঠযোগ্যতাকে কমিয়ে দেয়। এখানে Lombok আপনার সাহায্যে আসে, যেহেতু এটি আপনার জন্য এই কোডগুলো অটোমেটিক্যালি তৈরি করে, ফলে আপনার কোড আরো পরিষ্কার, সংক্ষিপ্ত এবং রিডেবল হয়।

২. Lombok এর প্রধান অ্যানোটেশন গুলি

Lombok এর কিছু গুরুত্বপূর্ণ অ্যানোটেশন নিম্নরূপ:

1. @Getter and @Setter: এই অ্যানোটেশনগুলি আপনার ক্লাসের সমস্ত ফিল্ডের জন্য getter এবং setter মেথড তৈরি করে।

   @Getter @Setter
   public class Person {
       private String name;
       private int age;
   }
   

   এই কোডের মাধ্যমে name এবং age ফিল্ডের জন্য getter এবং setter মেথড অটোমেটিক্যালি তৈরি হবে।

2. @AllArgsConstructor: এটি একটি কনস্ট্রাক্টর তৈরি করে যা ক্লাসের সমস্ত ফিল্ডকে প্যারামিটার হিসেবে গ্রহণ করে।

   @AllArgsConstructor
   public class Person {
       private String name;
       private int age;
   }
   

   এখানে, একটি কনস্ট্রাক্টর তৈরি হবে যা name এবং age ফিল্ড গ্রহণ করবে।

3. @NoArgsConstructor: এটি একটি ডিফল্ট কনস্ট্রাক্টর তৈরি করে যা কোন প্যারামিটার গ্রহণ করে না।

   @NoArgsConstructor
   public class Person {
       private String name;
       private int age;
   }
   

   এটি একটি ডিফল্ট কনস্ট্রাক্টর তৈরি করবে।

4. @ToString: এটি ক্লাসের একটি toString() মেথড তৈরি করে যা সমস্ত ফিল্ডের মান প্রিন্ট করবে।

   @ToString
   public class Person {
       private String name;
       private int age;
   }
   

   এতে toString() মেথড তৈরি হবে যা name এবং age ফিল্ডের মানকে একটি স্ট্রিং হিসাবে প্রদর্শন করবে।

5. @EqualsAndHashCode: এটি equals() এবং hashCode() মেথড তৈরি করে, যা অবজেক্টের তুলনা এবং হ্যাশিং কাজ সহজ করে।

   @EqualsAndHashCode
   public class Person {
       private String name;
       private int age;
   }
   

   এটি equals() এবং hashCode() মেথড তৈরি করবে, যা আপনার অবজেক্টের তুলনা এবং হ্যাশিং সঠিকভাবে পরিচালনা করবে।

6. @Builder: এটি একটি builder pattern তৈরি করে, যাতে আপনি অবজেক্টটি নির্মাণ করতে পারেন একাধিক ফিল্ড সহ।

   @Builder
   public class Person {
       private String name;
       private int age;
   }
   

   এতে একটি builder pattern তৈরি হবে, যার মাধ্যমে আপনি অবজেক্ট তৈরি করতে পারবেন যেমন: Person.builder().name("John").age(25).build();

৩. Lombok এবং MapStruct একসাথে ব্যবহার করা

MapStruct এবং Lombok একসাথে ব্যবহৃত হলে, Lombok আপনার POJOs (Plain Old Java Objects) বা DTOs (Data Transfer Objects) এর জন্য ফিল্ডের জন্য getters, setters, constructors তৈরি করবে, এবং MapStruct এই ক্লাসগুলির মধ্যে ডেটা ম্যাপিং সম্পন্ন করবে। এতে করে কোড ডেভেলপমেন্ট সহজ এবং দ্রুত হবে।

উদাহরণ:

Person.java (DTO Class)

import lombok.Getter;
import lombok.Setter;
import lombok.AllArgsConstructor;

@Getter
@Setter
@AllArgsConstructor
public class Person {
    private String name;
    private int age;
}

PersonDTO.java (DTO Class)

import lombok.Getter;
import lombok.Setter;

@Getter
@Setter
public class PersonDTO {
    private String fullName;
    private int age;
}

PersonMapper.java (MapStruct Mapper Interface)

import org.mapstruct.Mapper;
import org.mapstruct.factory.Mappers;

@Mapper(componentModel = "spring")
public interface PersonMapper {
    PersonMapper INSTANCE = Mappers.getMapper(PersonMapper.class);

    PersonDTO personToPersonDTO(Person person);
}

এখানে, Lombok ব্যবহার করে Person এবং PersonDTO ক্লাসের জন্য getters, setters, এবং constructors তৈরি করা হয়েছে। এরপর, MapStruct এর মাধ্যমে Person থেকে PersonDTO তে ডেটা ম্যাপিং করা হয়েছে।

৪. MapStruct এবং Lombok এর সুবিধা

1. Boilerplate Code Reduction: Lombok এবং MapStruct একসাথে ব্যবহার করলে, আপনাকে ম্যানুয়ালি getter, setter, constructor, equals, hashCode এবং toString মেথড লেখার প্রয়োজন হয় না। এতে কোড আরও পরিষ্কার এবং কমপ্যাক্ট হয়।
2. Code Generation: Lombok অটোমেটিকভাবে কোড জেনারেট করে এবং MapStruct compile-time এ ম্যাপিং কোড তৈরি করে, যা পারফরম্যান্সে সাহায্য করে এবং ডেভেলপমেন্ট সময় কমিয়ে দেয়।
3. Type Safety: Lombok এবং MapStruct উভয়ই টাইপ সেফ কোড প্রডিউস করে, যার মাধ্যমে টাইপ সম্পর্কিত ত্রুটি কম হয়।
4. Integration with Frameworks: Lombok এবং MapStruct Spring, JPA, Hibernate ইত্যাদি জনপ্রিয় Java ফ্রেমওয়ার্কের সাথে সহজেই ইন্টিগ্রেট করা যায়।

সারাংশ

Lombok এবং MapStruct একসাথে ব্যবহারের মাধ্যমে আপনি JavaBeans বা POJOs এর মধ্যে দ্রুত এবং কার্যকরী ডেটা ট্রান্সফার সম্পন্ন করতে পারেন। Lombok আপনাকে ডোমেইন অবজেক্টের জন্য প্রয়োজনীয় boilerplate কোড অটোমেটিক্যালি তৈরি করতে সাহায্য করে, এবং MapStruct ডেটা ম্যাপিং এর কাজ সহজ ও দ্রুতভাবে সম্পন্ন করে। এই দুইটি লাইব্রেরি একসাথে ব্যবহৃত হলে কোডের পরিস্কারতা, কার্যকারিতা এবং পারফরম্যান্সের উন্নতি হয়।

Lombok এবং MapStruct একসাথে ব্যবহৃত হলে, Java কোড লেখার পরিমাণ উল্লেখযোগ্যভাবে কমে যায় এবং আপনি কোডের পঠনযোগ্যতা এবং কার্যকারিতা উন্নত করতে পারেন। Lombok একটি জেনারেটর লাইব্রেরি যা বিভিন্ন সাধারণ Java কোড যেমন getter, setter, constructor, toString() ইত্যাদি অটোমেটিকভাবে তৈরি করে, ফলে কম কোড লিখতে হয়। অন্যদিকে, MapStruct হল একটি annotation processor ভিত্তিক মডেল ম্যাপিং টুল যা compile-time এ কোড জেনারেট করে এবং ডোমেইন অবজেক্টগুলির মধ্যে ম্যাপিং সম্পন্ন করে।

এখানে, আমরা Lombok এবং MapStruct এর ইন্টিগ্রেশন নিয়ে আলোচনা করব এবং দেখব কিভাবে এই দুটি টুল একসাথে কাজ করে।

১. Lombok এবং MapStruct এর প্রয়োজনীয় ডিপেনডেন্সি

প্রথমেই আপনাকে Lombok এবং MapStruct এর জন্য ডিপেনডেন্সি pom.xml বা build.gradle ফাইলে যোগ করতে হবে।

Maven Dependency (pom.xml):

<dependencies>
    <!-- Lombok Dependency -->
    <dependency>
        <groupId>org.projectlombok</groupId>
        <artifactId>lombok</artifactId>
        <version>1.18.22</version>
        <scope>provided</scope>
    </dependency>

    <!-- MapStruct Dependency -->
    <dependency>
        <groupId>org.mapstruct</groupId>
        <artifactId>mapstruct</artifactId>
        <version>1.5.2.Final</version>
    </dependency>

    <!-- MapStruct Processor Dependency for compile-time code generation -->
    <dependency>
        <groupId>org.mapstruct</groupId>
        <artifactId>mapstruct-processor</artifactId>
        <version>1.5.2.Final</version>
        <scope>provided</scope>
    </dependency>
</dependencies>

<build>
    <plugins>
        <plugin>
            <groupId>org.apache.maven.plugins</groupId>
            <artifactId>maven-compiler-plugin</artifactId>
            <version>3.8.1</version>
            <configuration>
                <source>1.8</source>
                <target>1.8</target>
                <annotationProcessorPaths>
                    <path>
                        <groupId>org.mapstruct</groupId>
                        <artifactId>mapstruct-processor</artifactId>
                        <version>1.5.2.Final</version>
                    </path>
                </annotationProcessorPaths>
            </configuration>
        </plugin>
    </plugins>
</build>

Gradle Dependency:

dependencies {
    // Lombok Dependency
    compileOnly 'org.projectlombok:lombok:1.18.22'
    annotationProcessor 'org.projectlombok:lombok:1.18.22'

    // MapStruct Dependency
    implementation 'org.mapstruct:mapstruct:1.5.2.Final'
    annotationProcessor 'org.mapstruct:mapstruct-processor:1.5.2.Final'
}

এখানে Lombok এবং MapStruct উভয়ের জন্য প্রয়োজনীয় ডিপেনডেন্সি ও প্লাগইন কনফিগার করা হয়েছে।

২. Lombok এর সাথে MapStruct এর ইন্টিগ্রেশন

Lombok এর সাথে MapStruct একত্রিত করতে কিছু বিশেষ টিপস রয়েছে যা নিশ্চিত করবে যে, আপনার কোড সঠিকভাবে কম্পাইল এবং ম্যাপ হয়।

২.১ Getter, Setter এবং Constructor অটোমেটিক্যালি তৈরি করা

Lombok এর @Getter, @Setter, @AllArgsConstructor এবং @NoArgsConstructor অ্যানোটেশন ব্যবহার করে আপনি অবজেক্টে কোড ডুপ্লিকেশন কমাতে পারেন।

Person.java (Domain Object):

import lombok.AllArgsConstructor;
import lombok.Getter;
import lombok.NoArgsConstructor;
import lombok.Setter;

@Getter
@Setter
@AllArgsConstructor
@NoArgsConstructor
public class Person {
    private String name;
    private int age;
}

এখানে @Getter, @Setter, @AllArgsConstructor, এবং @NoArgsConstructor অ্যানোটেশন ব্যবহার করা হয়েছে যা আপনার জন্য getter, setter, এবং কনস্ট্রাক্টর অটোমেটিকভাবে তৈরি করে।

২.২ DTO (Data Transfer Object) ক্লাসে Lombok ব্যবহার

PersonDTO.java (DTO Object):

import lombok.Getter;
import lombok.Setter;

@Getter
@Setter
public class PersonDTO {
    private String name;
    private String ageInString;
}

এখানে, DTO ক্লাসে @Getter এবং @Setter ব্যবহার করা হয়েছে, যা getter এবং setter মেথডগুলি অটোমেটিকভাবে তৈরি করবে।

৩. MapStruct Mapper Interface

MapStruct এর মাধ্যমে Person অবজেক্ট থেকে PersonDTO অবজেক্টে ডেটা ম্যাপিং করার জন্য একটি Mapper Interface তৈরি করা হবে।

PersonMapper.java (MapStruct Mapper Interface):

import org.mapstruct.Mapper;
import org.mapstruct.factory.Mappers;

@Mapper(componentModel = "spring")
public interface PersonMapper {
    PersonMapper INSTANCE = Mappers.getMapper(PersonMapper.class);

    PersonDTO personToPersonDTO(Person person);
}

এখানে, @Mapper অ্যানোটেশন দ্বারা MapStruct এর ম্যাপিং ইন্টারফেস তৈরি করা হয়েছে এবং componentModel = "spring" যুক্ত করা হয়েছে যাতে এটি Spring Bean হিসেবে কাজ করে।

৪. Lombok এবং MapStruct Integration - একটি উদাহরণ

এখন, Lombok এবং MapStruct একসাথে কাজ করার জন্য আমরা Person ডোমেইন অবজেক্টের মধ্যে থেকে ডেটা PersonDTO তে ম্যাপ করব। MapStruct ম্যাপিং কোডটি compile-time এ জেনারেট করবে এবং Lombok ডোমেইন এবং DTO অবজেক্টে অটোমেটিক মেথড তৈরি করবে।

Main.java (Testing the Mapping):

import org.springframework.beans.factory.annotation.Autowired;

public class Main {
    public static void main(String[] args) {
        Person person = new Person("John", 25);
        PersonMapper personMapper = PersonMapper.INSTANCE;

        // Mapping Person to PersonDTO
        PersonDTO personDTO = personMapper.personToPersonDTO(person);
        System.out.println("Name: " + personDTO.getName());
        System.out.println("Age in String: " + personDTO.getAgeInString());
    }
}

এখানে, আমরা Person অবজেক্ট থেকে PersonDTO অবজেক্টে ডেটা ম্যাপ করছি। MapStruct এ কোড জেনারেট করে এবং Lombok দ্বারা getter এবং setter মেথড তৈরি হয়ে যাবে।

৫. Lombok এবং MapStruct এর সুবিধা

1. Code Reduction: Lombok দিয়ে কোডের প্রয়োজনীয় অংশ যেমন getter, setter, কনস্ট্রাক্টর ইত্যাদি অটোমেটিক্যালি তৈরি হয়, ফলে কোড কম হয়।
2. Simplified Code Maintenance: MapStruct ব্যবহার করে আপনাকে ম্যাপিং কোড লিখতে হয় না, এটি কোড জেনারেট করে।
3. Compile-time Code Generation: MapStruct Compile-time এ কোড জেনারেট করে, ফলে রানটাইম পারফরম্যান্স বাড়ে।
4. Reduced Boilerplate Code: Lombok এর @Getter, @Setter ইত্যাদি অ্যানোটেশন ব্যবহার করে সাধারণ Java কোড কমিয়ে ফেলা যায়।
5. Easier Spring Integration: MapStruct এর componentModel = "spring" কনফিগারেশনের মাধ্যমে এটি Spring Bean হিসেবে সহজে ব্যবহৃত হতে পারে।

সারাংশ

Lombok এবং MapStruct একত্রে ব্যবহার করলে আপনার Java কোড লেখার প্রক্রিয়া সহজ এবং দ্রুত হয়। Lombok অটোমেটিক্যালি getter, setter, কনস্ট্রাক্টর ইত্যাদি তৈরি করে, ফলে কম কোড লেখা হয়। অন্যদিকে, MapStruct Compile-time এ কোড জেনারেট করে এবং আপনাকে ডোমেইন অবজেক্ট থেকে DTO তে ডেটা ম্যাপ করার জন্য manual কোড লিখতে হয় না। এই দুটি টুল একসাথে ব্যবহার করার মাধ্যমে কোডের জটিলতা কমে এবং উন্নত পারফরম্যান্স পাওয়া যায়।

MapStruct এবং Lombok দুটি জনপ্রিয় টুল যা Java ডেভেলপমেন্টে ব্যবহৃত হয়। MapStruct মডেল ম্যাপিং বা ডোমেইন অবজেক্টের মধ্যে ডেটা ট্রান্সফরমেশন সম্পন্ন করতে ব্যবহৃত হয়, এবং Lombok কোড লেখার প্রচেষ্টা কমাতে ব্যবহৃত হয়, বিশেষ করে Getter, Setter, Constructors, Equals, HashCode, toString ইত্যাদি অটো-জেনারেট করার জন্য।

এখানে, আমরা দেখব কিভাবে MapStruct এবং Lombok একসাথে ব্যবহার করে Object Mapping সম্পন্ন করা যায়।

১. Lombok এর Getter/Setter ব্যবহারের সুবিধা

Lombok ব্যবহার করলে আপনার Java ক্লাসে boilerplate কোড (যেমন Getter/Setter) অটোমেটিক্যালি জেনারেট করা হয়। এর ফলে ক্লাসের কোড আরও সংক্ষিপ্ত এবং পড়তে সহজ হয়ে ওঠে। MapStruct এর সাথে Lombok ব্যবহার করে, আপনি DTO (Data Transfer Object) এবং Entity ক্লাসের মধ্যে মডেল ম্যাপিং করতে পারবেন, যেখানে Lombok ক্লাসগুলির Getter, Setter এবং অন্যান্য মেথডগুলি স্বয়ংক্রিয়ভাবে জেনারেট করবে।

Lombok এর প্রধান অ্যানোটেশন:

• @Getter: ফিল্ডের জন্য getter মেথড স্বয়ংক্রিয়ভাবে তৈরি করে।
• @Setter: ফিল্ডের জন্য setter মেথড স্বয়ংক্রিয়ভাবে তৈরি করে।
• @NoArgsConstructor: প্যারামিটারহীন কন্সট্রাক্টর তৈরি করে।
• @AllArgsConstructor: সব ফিল্ডের জন্য কন্সট্রাক্টর তৈরি করে।

২. MapStruct এর মাধ্যমে Object Mapping

MapStruct এর মাধ্যমে আপনি Lombok ব্যবহৃত POJOs (Plain Old Java Objects) এর মধ্যে সহজে ডেটা ম্যাপিং করতে পারেন। MapStruct আপনাকে Mapper Interface তৈরি করতে সহায়তা করে যা DTO এবং Entity ক্লাসের মধ্যে ম্যাপিং কাজ করবে।

উদাহরণ: Lombok সহ MapStruct Object Mapping

ধরা যাক, আমাদের দুটি ক্লাস রয়েছে — একটি Employee (Entity) এবং একটি EmployeeDTO (DTO)। আমরা Lombok এর Getter/Setter অ্যানোটেশন ব্যবহার করব এবং MapStruct এর মাধ্যমে এই দুটি ক্লাসের মধ্যে ম্যাপিং করব।

২.১ Employee Entity (Lombok)

import lombok.Getter;
import lombok.Setter;

@Getter
@Setter
public class Employee {
    private Long id;
    private String name;
    private String department;
}

এখানে, Lombok এর @Getter এবং @Setter অ্যানোটেশন ব্যবহার করা হয়েছে, যার ফলে id, name, এবং department ফিল্ডের জন্য স্বয়ংক্রিয়ভাবে getter এবং setter মেথড তৈরি হবে।

২.২ EmployeeDTO (Lombok)

import lombok.Getter;
import lombok.Setter;

@Getter
@Setter
public class EmployeeDTO {
    private Long id;
    private String name;
    private String department;
}

এখানে EmployeeDTO ক্লাসে Lombok এর মাধ্যমে getter এবং setter মেথড তৈরি করা হয়েছে।

২.৩ EmployeeMapper Interface (MapStruct)

import org.mapstruct.Mapper;
import org.mapstruct.factory.Mappers;

@Mapper
public interface EmployeeMapper {
    EmployeeMapper INSTANCE = Mappers.getMapper(EmployeeMapper.class);

    EmployeeDTO employeeToEmployeeDTO(Employee employee);
}

এখানে, EmployeeMapper ইন্টারফেস তৈরি করা হয়েছে যা Employee এবং EmployeeDTO এর মধ্যে ম্যাপিং করবে। Mappers.getMapper(EmployeeMapper.class) ব্যবহার করে EmployeeMapper এর একটি ইনস্ট্যান্স তৈরি করা হয়েছে।

২.৪ Usage Example (MapStruct and Lombok Integration)

public class Main {
    public static void main(String[] args) {
        Employee employee = new Employee();
        employee.setId(1L);
        employee.setName("John Doe");
        employee.setDepartment("Engineering");

        // Using MapStruct to map Employee to EmployeeDTO
        EmployeeDTO employeeDTO = EmployeeMapper.INSTANCE.employeeToEmployeeDTO(employee);
        
        System.out.println("Employee DTO: ");
        System.out.println("ID: " + employeeDTO.getId());
        System.out.println("Name: " + employeeDTO.getName());
        System.out.println("Department: " + employeeDTO.getDepartment());
    }
}

এখানে, Employee অবজেক্টের Lombok এর মাধ্যমে setId, setName, এবং setDepartment ফিল্ডগুলো সেট করা হয়েছে এবং তারপর MapStruct এর মাধ্যমে সেই অবজেক্টকে EmployeeDTO তে ম্যাপ করা হয়েছে।

৩. MapStruct এবং Lombok এর সুবিধা

1. Boilerplate Code কমানো: Lombok স্বয়ংক্রিয়ভাবে Getter/Setter, Constructor, Equals, HashCode ইত্যাদি তৈরি করে, ফলে কোড সংক্ষিপ্ত এবং পরিষ্কার হয়।
2. Compile-Time Code Generation: MapStruct কোড জেনারেট করার জন্য compile-time এ কাজ করে, যা রানটাইম পারফরম্যান্সে প্রভাব ফেলে না।
3. Maintenance Friendly: Lombok ব্যবহার করার ফলে ক্লাসের কোড কমে এবং এটি রক্ষণাবেক্ষণ করতে সহজ হয়।
4. Type-Safety: MapStruct টাইপ-সেফ ম্যাপিং তৈরি করে, ফলে ভুল ডেটা টাইপের কারণে ত্রুটি হওয়ার সম্ভাবনা কমে।

৪. MapStruct এবং Lombok এর মধ্যে Integration

MapStruct এবং Lombok একসাথে ব্যবহারে অনেক সুবিধা পাওয়া যায়। Lombok আপনাকে শুধুমাত্র প্রয়োজনীয় ফিল্ডের জন্য getter/setter/constructor তৈরি করতে সহায়তা করে, আর MapStruct সেই ফিল্ডগুলির মধ্যে ডেটা ম্যাপিং সম্পন্ন করে। আপনি যখন Spring Framework বা অন্য কোনো ফ্রেমওয়ার্কের সাথে কাজ করেন, তখন এটি আরও কার্যকরী হয়ে ওঠে।

Spring Integration উদাহরণ:

@Mapper(componentModel = "spring")
public interface EmployeeMapper {
    EmployeeDTO employeeToEmployeeDTO(Employee employee);
}

এখানে, componentModel = "spring" ব্যবহার করে MapStruct কে Spring Bean হিসেবে কনফিগার করা হয়েছে। এরপর, Spring এর মাধ্যমে EmployeeMapper কে ইনজেক্ট করা যাবে।

সারাংশ

MapStruct এবং Lombok একসাথে ব্যবহারের মাধ্যমে আপনি Java প্রোজেক্টে কার্যকরী এবং পরিষ্কার কোড লিখতে পারবেন। Lombok ফিল্ডের জন্য getter/setter এবং কন্সট্রাক্টর স্বয়ংক্রিয়ভাবে তৈরি করে এবং MapStruct ওই ক্লাসের মধ্যে ম্যাপিং প্রক্রিয়া দ্রুত সম্পন্ন করে। এই দুটি টুল একসাথে ব্যবহারে আপনার ডেভেলপমেন্ট প্রক্রিয়া অনেক সহজ এবং কার্যকরী হয়ে ওঠে।

MapStruct একটি শক্তিশালী এবং পারফর্ম্যান্স ফ্রেন্ডলি Java লাইব্রেরি যা ডোমেইন অবজেক্ট এবং DTO (Data Transfer Object) এর মধ্যে ম্যাপিং করতে সহায়তা করে। Lombok একটি জনপ্রিয় Java লাইব্রেরি যা স্বয়ংক্রিয়ভাবে getter, setter, equals, hashcode, toString, এবং অন্যান্য মেথড তৈরি করতে সাহায্য করে, ফলে কোড কমপ্লেক্সিটি কমে এবং উন্নয়ন কার্যক্রম দ্রুত হয়।

MapStruct এবং Lombok একত্রে ব্যবহার করা যেতে পারে, যাতে আপনি সহজে এবং দ্রুত ডেটা ম্যাপিং সম্পন্ন করতে পারেন, এবং একই সাথে Lombok এর সুবিধাগুলি ব্যবহার করে আরও কম কোড লিখতে পারেন।

এই গাইডে, আমরা MapStruct এবং Lombok এর ইন্টিগ্রেশন এবং এর প্রয়োগ দেখব।

১. Lombok এবং MapStruct এর Integration এর প্রয়োজনীয়তা

Lombok এবং MapStruct একত্রে ব্যবহার করলে, আপনি ডোমেইন অবজেক্টের মধ্যে ডেটা ম্যাপিং করার সময় আরো সোজা এবং পরিষ্কার কোড পেতে পারেন। Lombok আপনার কোডে অপ্রয়োজনীয় getter, setter, constructor ইত্যাদি তৈরি করতে সাহায্য করে, আর MapStruct দ্রুত এবং সঠিকভাবে ম্যাপিং কোড জেনারেট করে।

এখানে আমরা দেখবো কিভাবে Lombok এবং MapStruct একত্রে কাজ করে।

২. Maven Dependency Configuration for Lombok and MapStruct

প্রথমে, আপনি Maven এর pom.xml ফাইলে Lombok এবং MapStruct এর প্রয়োজনীয় ডিপেনডেন্সি যোগ করতে হবে।

<dependencies>
    <!-- MapStruct Dependency -->
    <dependency>
        <groupId>org.mapstruct</groupId>
        <artifactId>mapstruct</artifactId>
        <version>1.5.2.Final</version>
    </dependency>

    <!-- MapStruct Processor for compile-time code generation -->
    <dependency>
        <groupId>org.mapstruct</groupId>
        <artifactId>mapstruct-processor</artifactId>
        <version>1.5.2.Final</version>
        <scope>provided</scope>
    </dependency>

    <!-- Lombok Dependency -->
    <dependency>
        <groupId>org.projectlombok</groupId>
        <artifactId>lombok</artifactId>
        <version>1.18.22</version>
        <scope>provided</scope>
    </dependency>
</dependencies>

এখানে, MapStruct এবং Lombok এর জন্য যথাক্রমে ডিপেনডেন্সি যোগ করা হয়েছে। MapStruct Processor কোড জেনারেট করতে ব্যবহৃত হবে, এবং Lombok এর প্রয়োজনীয় অ্যাট্রিবিউট (যেমন @Getter, @Setter) যুক্ত করতে সাহায্য করবে।

৩. Lombok এবং MapStruct এর উদাহরণ

ধরা যাক, আমাদের দুটি ক্লাস রয়েছে: Person এবং PersonDTO। আমরা Lombok এর সাহায্যে getter, setter এবং constructor জেনারেট করব এবং MapStruct এর মাধ্যমে তাদের মধ্যে ডেটা ম্যাপিং করব।

৩.১ Person.java (Domain Object with Lombok)

import lombok.Data;

@Data // Lombok annotation to generate getter, setter, equals, hashcode, and toString methods
public class Person {
    private String firstName;
    private String lastName;
    private int age;
}

এখানে, @Data অ্যাট্রিবিউট ব্যবহার করা হয়েছে, যা স্বয়ংক্রিয়ভাবে getter, setter, toString(), equals(), এবং hashCode() মেথডগুলো জেনারেট করে।

৩.২ PersonDTO.java (DTO with Lombok)

import lombok.Data;

@Data // Lombok annotation to generate getter, setter, equals, hashcode, and toString methods
public class PersonDTO {
    private String firstName;
    private String lastName;
    private int age;
}

এখানে, আবার @Data ব্যবহার করা হয়েছে যা DTO ক্লাসে একই ফিচার যুক্ত করেছে।

৩.৩ PersonMapper.java (MapStruct Mapper Interface)

import org.mapstruct.Mapper;
import org.mapstruct.factory.Mappers;

@Mapper(componentModel = "spring") // This enables Spring integration
public interface PersonMapper {
    PersonMapper INSTANCE = Mappers.getMapper(PersonMapper.class);

    // Mapping method
    PersonDTO personToPersonDTO(Person person);
}

এখানে, @Mapper অ্যানোটেশন ব্যবহার করা হয়েছে, যা PersonMapper ইন্টারফেসটিকে একটি MapStruct Mapper হিসেবে চিহ্নিত করেছে এবং personToPersonDTO মেথডে Person থেকে PersonDTO এ ম্যাপিং হবে।

৩.৪ Main.java (Usage Example)

import org.springframework.beans.factory.annotation.Autowired;

public class Main {

    @Autowired
    private static PersonMapper personMapper;

    public static void main(String[] args) {
        Person person = new Person();
        person.setFirstName("John");
        person.setLastName("Doe");
        person.setAge(30);

        // Mapping
        PersonDTO personDTO = personMapper.personToPersonDTO(person);
        System.out.println(personDTO.getFirstName()); // Output: John
        System.out.println(personDTO.getLastName());  // Output: Doe
        System.out.println(personDTO.getAge());       // Output: 30
    }
}

এখানে, MapStruct দ্বারা ম্যাপিং সম্পন্ন করা হয়েছে এবং Lombok এর সাহায্যে getter এবং setter মেথডগুলো স্বয়ংক্রিয়ভাবে জেনারেট করা হয়েছে।

৪. Spring Framework এ Lombok এবং MapStruct Integration

যদি আপনি Spring Framework বা Spring Boot ব্যবহার করেন, তবে MapStruct এবং Lombok খুব সহজে ইন্টিগ্রেট করা যায়। Spring এর সাথে MapStruct ব্যবহার করার জন্য @Mapper(componentModel = "spring") কনফিগারেশন ব্যবহার করতে হবে, যা MapStruct কে Spring Bean হিসেবে কনফিগার করে।

উদাহরণ:

@Mapper(componentModel = "spring")
public interface PersonMapper {
    PersonDTO personToPersonDTO(Person person);
}

এখানে, componentModel = "spring" ব্যবহার করে MapStruct এর মেপিং লজিককে Spring Bean হিসেবে কনফিগার করা হয়েছে। এতে @Autowired দিয়ে Spring তে PersonMapper ইন্টারফেসটি ইনজেক্ট করতে পারবেন।

৫. MapStruct এবং Lombok এর পারফরম্যান্স

Lombok এবং MapStruct একত্রে ব্যবহৃত হলে কোডের পরিমাণ অনেক কমে যায় এবং এটি কমপ্লেক্সিটি হ্রাস করতে সাহায্য করে। Lombok স্বয়ংক্রিয়ভাবে Getter, Setter, এবং অন্যান্য মেথড জেনারেট করার কারণে ম্যানুয়ালি এই মেথডগুলো লেখার প্রয়োজন পড়ে না, এবং MapStruct compile-time কোড জেনারেশন করে দ্রুত ম্যাপিং করতে সাহায্য করে। এর ফলে পারফরম্যান্সের দিক থেকে এটি খুবই সুবিধাজনক হয়।

সারাংশ

MapStruct এবং Lombok একত্রে ব্যবহৃত হলে, আপনি কম কোড লেখার মাধ্যমে কার্যকরী এবং দ্রুত ডেটা ট্রান্সফার অবজেক্ট (DTO) ম্যাপিং করতে পারেন। Lombok স্বয়ংক্রিয়ভাবে getter, setter, এবং অন্যান্য মেথড জেনারেট করে, এবং MapStruct compile-time কোড জেনারেশন করে, যা রানটাইমে পারফরম্যান্স বৃদ্ধিতে সাহায্য করে। Spring প্রোজেক্টের সাথে ইন্টিগ্রেট করতে হলে @Mapper(componentModel = "spring") ব্যবহার করতে হয়, যাতে MapStruct Spring Bean হিসেবে কাজ করতে পারে।