Pemproses anotasi adalah mekanisme lanjutan dalam peringkat penyusunan Java, yang digunakan untuk mengimbas dan memproses anotasi dalam kod sumber, dan dapat menghasilkan kod baru atau pra -prosesnya. Fungsi terasnya termasuk: 1. Apabila menentukan anotasi, anda perlu menentukan dasar pengekalan dan jenis elemen sasaran; 2. Melaksanakan kelas AbstrakProcessor dan menulis semula kaedah utama seperti GetSupportedAnnotationTypes, GetSupportedSourceVersion and Process; 3. Daftar pemproses untuk mengisytiharkan nama yang berkelayakan sepenuhnya melalui fail konfigurasi dalam direktori Meta-INF/Services. Pemproses anotasi digunakan secara meluas dalam kerangka, seperti pisau, pisau mentega dan bilik, dan digunakan untuk suntikan pergantungan, akses pangkalan data dan fungsi lain. Apabila menggunakannya, anda harus memberi perhatian untuk mengelakkan perintah ketergantungan, mengubah kod sedia ada, logik kompleks dan kesukaran ujian. Jika anotasi tidak berkuatkuasa, periksa tetapan @retention, status pendaftaran pemproses, dan sama ada pemprosesan anotasi diaktifkan oleh alat binaan.

Mekanisme pemprosesan anotasi di Java sebenarnya tidak misteri. Ia pada dasarnya adalah keupayaan pengembangan yang disediakan oleh pengkompil Java semasa peringkat penyusunan. Melalui pemproses anotasi, kami dapat membaca maklumat anotasi dalam kod semasa tempoh penyusunan, menghasilkan fail Java baru atau melakukan operasi pra -proses lain. Banyak rangka kerja seperti pisau, pisau mentega dan bilik bergantung pada mekanisme ini untuk melaksanakan suntikan ketergantungan atau akses pangkalan data.

Apakah pemproses anotasi?

Pemproses Anotasi adalah alat khas yang berjalan semasa fasa kompilasi Java dan boleh mengimbas dan memproses anotasi dalam kod sumber. Antara muka terasnya adalah javax.annotation.processing.Processor , yang kami dapat menyesuaikan pemproses dengan mewarisi kelas AbstractProcessor .

Pengkompil Java akan memanggil pemproses ini, lulus dalam semua elemen yang ditandai dengan anotasi tertentu (seperti kelas, kaedah, bidang, dll), dan kemudian pemaju akan memutuskan cara mengendalikan maklumat ini.

Untuk memberi contoh mudah: Apabila anda menggunakan anotasi @Override , pengkompil Java akan menyemak pada peringkat penyusunan sama ada kaedah itu sebenarnya mengatasi kaedah kelas induk. Ini adalah logik pemprosesan anotasi terbina dalam.

Bagaimana cara menulis pemproses anotasi tersuai?

Untuk melaksanakan pemproses anotasi, langkah -langkah berikut biasanya diperlukan:

• Anotasi definisi
• Melaksanakan AbstractProcessor
• Daftar pemproses

Anotasi definisi

Anda boleh membuat anotasi terpelihara runtime, atau ia hanya boleh digunakan untuk pemprosesan kompilasi. Contohnya:

 @Retention (RetentionPolicy.Source)
@Target (elementType.type)
public @interface myannotation {
    Nilai rentetan ();
}

Melaksanakan AbstrakProcessor

Seterusnya, anda perlu mewarisi AbstractProcessor dan menulis semula kaedah utama:

 Kelas Awam MyAnnotationProcessor memanjangkan AbstrakProcessor {
    @Override
    set awam <string> getSupportedAnnotationTypes () {
        pulangan koleksi.singleton (myannotation.class.getCanonicalName ());
    }

    @Override
    Sourceversion public getSupportedSourCeversion () {
        kembali sourceversion.release_8;
    }

    @Override
    Proses Boolean Awam (set <? Memperluaskan taper> Anotasi, Roundenvironment Roundenv) {
        untuk (anotasi taip: anotasi) {
            Tetapkan <? melanjutkan elemen> elemen = roundenv.getElementsAnnotatedWith (anotasi);
            untuk (elemen elemen: elemen) {
                // mengendalikan kelas, kaedah, dan lain -lain dengan anotasi}
        }
        kembali benar;
    }
}

Daftar pemproses

Anda boleh membuat fail META-INF/services/javax.annotation.processing.Processor dalam direktori sumber, dan tulis nama pemproses anda sepenuhnya, supaya pengkompil mengetahui pemproses mana yang akan dimuat.

Apa yang boleh dilakukan oleh pemproses anotasi?

Penggunaan pemproses anotasi yang paling biasa termasuk:

• Menghasilkan kod secara automatik (seperti butterknife)
• Sahkan struktur kod (seperti cek bukan nol Lombok)
• Adakah pemprosesan konfigurasi terlebih dahulu (seperti Pembinaan Grafik Ketergantungan Dagger)

Sebagai contoh, Dagger menganalisis @Inject Annotation melalui pemproses anotasi semasa penyusunan, menghasilkan kod suntikan ketergantungan yang sepadan untuk mengelakkan kerugian prestasi yang disebabkan oleh refleksi runtime.

Di samping itu, jika anda sedang membangunkan aplikasi Android, rangka kerja bilik juga menghasilkan kod yang berkaitan dengan pangkalan data melalui pemproses anotasi pada masa penyusunan, jadi anda tidak perlu menghuraikan pernyataan SQL semasa runtime.

Nota dan Soalan Lazim

Terdapat beberapa tempat yang rawan ralat untuk memberi perhatian apabila menggunakan pemproses anotasi:

• Jangan bergantung pada perintah : Perintah pelaksanaan antara pelbagai pemproses tidak pasti.
• Cuba jangan mengubah suai kod sedia ada : Pemproses anotasi lebih sesuai untuk menghasilkan kod baru dan bukannya mengubahsuai kelas sedia ada.
• Elakkan logik kompleks : Pemproses sedang berjalan pada peringkat penyusunan, dan pengiraan kompleks boleh menjejaskan kelajuan penyusunan.
• Ujian Kesukaran : Kerana ia berjalan semasa tempoh penyusunan, debugging tidak mudah seperti kod biasa.

Jika anda mendapati bahawa anotasi tidak berkesan, anda boleh menyemak perkara berikut:

• Adakah set @Retention ditetapkan ke SOURCE atau CLASS
• Adakah pemproses anotasi didaftarkan dengan betul?
• Adakah terdapat pemprosesan anotasi yang didayakan untuk alat bangunan (seperti Gradle)

Pada dasarnya itu sahaja. Menguasai prinsip dan penggunaan pemproses anotasi dapat memberi anda pemahaman yang lebih mendalam tentang mekanisme di sebalik kerangka Java moden.

Atas ialah kandungan terperinci Bagaimana pemprosesan anotasi berfungsi di java. Untuk maklumat lanjut, sila ikut artikel berkaitan lain di laman web China PHP!