MapStruct Java: पूर्ण गाइड उदाहरणों के साथ

MapStruct क्या है और इसकी आवश्यकता क्यों है?

MapStruct एक Java कोड जनरेटर है जो अलग-अलग प्रकार के ऑब्जेक्ट्स के बीच मैपर (कन्वर्टर) की इम्प्लीमेंटेशन को ऑटोमैटिकली बनाता है। आधुनिक Java डेवलपमेंट में अक्सर एक ऑब्जेक्ट को दूसरे में बदलने की ज़रूरत होती है: Entity को DTO में, DTO को VO में, एक API रिस्पॉन्स को दूसरे मॉडल में, और इसी तरह। ऐसा कोड मैन्युअली लिखना उबाऊ, समय लेने वाला और गलतियों से भरा काम है। MapStruct कंपाइलेशन के समय सारा boilerplate कोड जनरेट करके इस समस्या को हल करता है।

MapStruct के मुख्य लाभ:

• परफॉरमेंस: कंपाइल-टाइम पर कोड जनरेशन। कोई रिफ्लेक्शन नहीं, runtime में कोई परफॉरमेंस लॉस नहीं। MapStruct उतनी ही तेज़ी से काम करता है जितना कि आप मैन्युअली मैपिंग लिखते।
• टाइप सेफ्टी: सभी एरर (टाइप मिसमैच, फील्ड की कमी) runtime के बजाय कंपाइलेशन के समय ही पकड़ी जाती हैं।
• सरलता: न्यूनतम कॉन्फ़िगरेशन। बस एक इंटरफ़ेस या एब्सट्रैक्ट क्लास को मैपिंग मेथड्स के साथ डिफ़ाइन करें, और MapStruct खुद इम्प्लीमेंटेशन जनरेट कर देगा।
• लचीलापन: जटिल मैपिंग, टाइप कन्वर्ज़न, एक्सप्रेशन का उपयोग, मेथड कॉल और अन्य लाइब्रेरीज़ (Lombok, Spring आदि) के साथ इंटीग्रेशन का सपोर्ट।
• कोड की सफाई: मैपिंग कोड बिज़नेस लॉजिक से अलग होता है, जिससे कोड अधिक पढ़ने योग्य और मेंटेन करने योग्य बनता है।

MapStruct विशेष रूप से मल्टी-लेयर आर्किटेक्चर (Controller-Service-Repository) में उपयोगी है, जहाँ अक्सर लेयर्स के बीच ऑब्जेक्ट्स को बदलने की आवश्यकता होती है।

MapStruct की स्थापना (Installation)

MapStruct pip या npm के माध्यम से इंस्टॉल नहीं होता, क्योंकि यह Java के लिए एक लाइब्रेरी है। अपने प्रोजेक्ट में MapStruct को जोड़ने के लिए Maven या Gradle बिल्ड सिस्टम का उपयोग किया जाता है।

Maven के माध्यम से स्थापना

अपनी pom.xml फ़ाइल में निम्नलिखित डिपेंडेंसी जोड़ें:

<dependencies>
    <!-- मुख्य MapStruct लाइब्रेरी -->
    <dependency>
        <groupId>org.mapstruct</groupId>
        <artifactId>mapstruct</artifactId>
        <version>1.5.5.Final</version>
    </dependency>

    <!-- एनोटेशन प्रोसेसर (कोड जनरेशन के लिए) -->
    <dependency>
        <groupId>org.mapstruct</groupId>
        <artifactId>mapstruct-processor</artifactId>
        <version>1.5.5.Final</version>
        <scope>provided</scope>
    </dependency>
</dependencies>

Gradle के माध्यम से स्थापना

Gradle के लिए, build.gradle फ़ाइल में जोड़ें:

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

महत्वपूर्ण: सुनिश्चित करें कि mapstruct-processor का वर्जन mapstruct के वर्जन से मेल खाता हो। डिपेंडेंसी जोड़ने के बाद, प्रोजेक्ट को बिल्ड करें (जैसे, mvn clean compile) ताकि MapStruct मैपर की इम्प्लीमेंटेशन जनरेट कर सके।

कोड उदाहरण के साथ त्वरित शुरुआत

चलिए एक सरल मैपर बनाते हैं जो Car ऑब्जेक्ट (Entity) को CarDto ऑब्जेक्ट (DTO) में बदलता है।

चरण 1: स्रोत और लक्ष्य क्लास को परिभाषित करें

// Car.java
public class Car {
    private String make;
    private int numberOfSeats;
    private CarType type;

    // कंस्ट्रक्टर, गेटर, सेटर
    public Car() {}

    public Car(String make, int numberOfSeats, CarType type) {
        this.make = make;
        this.numberOfSeats = numberOfSeats;
        this.type = type;
    }

    public String getMake() { return make; }
    public void setMake(String make) { this.make = make; }
    public int getNumberOfSeats() { return numberOfSeats; }
    public void setNumberOfSeats(int numberOfSeats) { this.numberOfSeats = numberOfSeats; }
    public CarTy