Menggunakan mapstruct untuk pemetaan kacang yang tidak menyakitkan di java

Mapstruct adalah penjana kod kompilasi masa yang memudahkan pemetaan antara kacang Java. 1. Ia secara automatik menjana kelas pelaksanaan dengan menentukan antara muka untuk mengelakkan menulis secara manual set/mendapatkan kod pemetaan secara manual; 2. Ia mempunyai jenis selamat, tiada overhead runtime, menyokong pemetaan automatik medan nama yang sama, ekspresi tersuai, objek bersarang dan pemetaan pengumpulan; 3. Ia boleh diintegrasikan dengan Spring dan menyuntik mapper ke dalam kacang musim bunga menggunakan @mapper (ComponentModel = "Spring"); 4. Ia mempunyai konfigurasi yang mudah, hanya memperkenalkan kebergantungan mapstruct dan annotationprocessorpressorporporsaths plug-in; 5. Ia menyokong @named dan anotasi lain untuk melaksanakan logik pemetaan tersuai yang boleh diguna semula, meningkatkan kemasyhuran dan pemeliharaan Kod, yang merupakan salah satu amalan terbaik untuk mengendalikan pemetaan objek di Java.

Jika anda pernah mendapati diri anda menulis kod boilerplate yang tidak berkesudahan untuk menyalin data dari satu objek Java (seperti DTO) kepada yang lain (seperti entiti), anda tahu bagaimana membosankan dan rawan kesilapan itu. Di sinilah Mapstruct masuk-penjana kod kompilasi masa yang membuat pemetaan kacang di Java bukan hanya lebih mudah, tetapi praktikal menyakitkan.

Apa itu Mapstruct?

Mapstruct adalah penjana kod yang memudahkan pemetaan antara kacang Java (contohnya, dari entiti JPA hingga DTO rehat). Daripada menulis setX(getX()) secara manual untuk setiap bidang, anda menentukan antara muka, dan Mapstruct menghasilkan pelaksanaan pada masa penyusunan - tidak ada refleksi, tiada overhead runtime, hanya cepat, bersih, kod yang boleh dibaca.

Mengapa Mapstruct Over Pemetaan Manual atau Perpustakaan Lain?

• ✅ Jenis-selamat : Kesilapan yang ditangkap pada masa penyusunan, bukan runtime.
• ✅ Tiada overhead runtime : Kod yang dihasilkan adalah java biasa - tiada refleksi atau proksi.
• ✅ boilerplate minimum : Tulis antara muka, dapatkan pelaksanaan.
• ✅ Default Smart : Bidang peta secara automatik dengan nama yang sama.
• ✅ Disesuaikan : Mengendalikan nama tidak sepadan, objek bersarang, koleksi, dan juga logik tersuai.

Contoh cepat

Katakan anda mempunyai:

 pengguna kelas awam {
    ID panjang peribadi;
    Rentetan peribadi swasta;
    Rentetan peribadi lastname;
    e -mel rentetan peribadi;
    // penetas getters
}

UserDto kelas awam {
    Fullname String Private; // peta name firstname
    e -mel rentetan peribadi;
}

Dengan Mapstruct, buat antara muka Mapper:

 @Mapper
UserMapper antara muka awam {
    Contoh userMapper = Mapper.GetMapper (userMapper.class);

    @Mapping (sasaran = "fullName", expression = "java (user.getFirstName () \" \ "user.getLastName ())")
    Userdto todto (pengguna pengguna);
}

Kemudian gunakannya:

 Pengguna pengguna = pengguna baru ();
user.setFirstName ("John");
user.setLastName ("doe");
user.seteMail ("John@example.com");

Userdto dTO = userMapper.Instance.todTo (pengguna);
// dto.getfullName () → "John Doe"

Ciri -ciri utama yang anda gemari

1. Auto-pemetaan dengan nama

Jika nama medan sepadan (seperti email ), tiada konfigurasi tambahan diperlukan.

2. Logik pemetaan tersuai

Gunakan @Mapping dengan:

• expression untuk ekspresi java sebaris
• qualifiedByName untuk kaedah tersuai yang boleh diguna semula
• @AfterMapping untuk logik pasca pemprosesan

3. Objek & Koleksi bersarang

Mapstruct Handle List<User> ↔ List<UserDto> Secara automatik - tiada kod tambahan.

4. Integrasi dengan musim bunga

Cukup tambah componentModel = "spring" :

 @Mapper (ComponentModel = "Spring")
UserMapper antara muka awam {
    Userdto todto (pengguna pengguna);
}

Kini ia adalah kacang musim bunga - menyuntiknya seperti yang lain.

Persediaan (Maven)

Tambah ke pom.xml :

 <geterlihat>
    <groupId> org.mastruct </groupId>
    <stistfactid> Mastruct </artifactid>
    <versi> 1.5.5.final </versi>
</ketergantungan>

<sugin>
    <groupId> org.apache.maven.plugins </groupId>
    <stifactid> Maven-Compiler-Plugin </artifactid>
    <figuration>
        <NotationProcessorPaths>
            <sath>
                <groupId> org.mastruct </groupId>
                <stifactid> Mastruct-Processor </artifactid>
                <versi> 1.5.5.final </versi>
            </path>
        </AnnotationProcessorPaths>
    </konfigurasi>
</plugin>

Petua Pro: Gunakan @Named untuk logik yang boleh diguna semula

 @Mapper
UserMapper antara muka awam {
    @Mapping (sasaran = "fullName", kualifiedByName = "TOfullName")
    Userdto todto (pengguna pengguna);

    @Named ("tofullname")
    rentetan lalai tofullName (pengguna pengguna) {
        kembali user.getFirstName () "" user.getLastName ();
    }
}

Ini menjadikan pemetaan anda bersih dan boleh diguna semula di pelbagai pemetaan.

Mapstruct menghilangkan geseran dari pemetaan objek - tidak ada lagi penyalinan manual, tidak ada lagi kejutan runtime. Sebaik sahaja anda mula menggunakannya, anda akan tertanya -tanya bagaimana anda pernah hidup tanpa itu.
Pada asasnya, jika anda melakukan pemetaan kacang di Java dan tidak menggunakan mapstruct, anda melakukannya dengan cara yang sukar.

Atas ialah kandungan terperinci Menggunakan mapstruct untuk pemetaan kacang yang tidak menyakitkan di java. Untuk maklumat lanjut, sila ikut artikel berkaitan lain di laman web China PHP!