Java: Menggunakan Anotasi Pradefined - dummies

Jenis dan kandungan anotasi di Jawa, seperti komen, hanya terhad oleh imaginasi anda. Ya, Java menyediakan beberapa anotasi yang telah ditetapkan, tetapi anda juga boleh membuat penjelasan yang menggambarkan unsur-unsur program dalam apa jua cara yang anda mahukan. Idea ini ialah anda menerangkan bagaimana anotasi berfungsi, menyediakan data untuknya, dan pengkompil mengurus yang lain.

Anotasi sentiasa bermula dengan simbol @ (pada). Jadi, apabila anda melihat @ Dokumentasi, anda tahu bahawa anda melihat anotasi. Bahagian berikut memberitahu anda lebih lanjut mengenai penjelasan yang telah ditetapkan dan adat.

Anotasi yang dipratentukan adalah salah satu yang wujud sebagai sebahagian daripada Java. Anda dapati penjelasan ini di java. lang. pakej anotasi. Untuk menggunakannya, anda menambah java import. lang. anotasi. *; ke permulaan permohonan anda. Senarai berikut memberikan gambaran umum tentang penjelasan yang telah ditetapkan:

• @Deprecated: Kadang kala elemen - kelas, kaedah, medan, atau ciri pengaturcaraan lain - digantikan oleh elemen yang lebih baru atau tidak lagi diperlukan.

  Apabila ini berlaku, anda menandakan elemen tersebut sebagai usang supaya pemaju tahu bahawa mereka perlu mengemas kini kod mereka dan berhenti menggunakan elemen tertentu. Menambah anotasi @Depelasi yang dikeluarkan status status yang sudah lama digunakan dalam dokumentasi yang dihasilkan oleh Javadoc (utiliti yang digunakan untuk membuat dokumentasi secara automatik berdasarkan kandungan fail kod anda).

• @Documented: Pada bila-bila masa anda menandakan elemen seperti yang didokumentasikan, utiliti Javadoc akan mengeluarkannya ke fail dokumentasi yang dibuat berdasarkan kandungan fail sumber.

• @FunctionalInterface: Menentukan bahawa antara muka adalah antara muka fungsian yang digunakan untuk ungkapan anonim dan ungkapan lambda.

• @Inherited : Kelas boleh mewarisi ciri-ciri dari kelas induk. Secara lalai, ini termasuk kefungsian seperti kaedah tetapi tidak termasuk anotasi kelas induk. Menggunakan anotasi @Inherited memberitahu Java untuk menggunakan anotasi kelas ibu bapa kepada subclass juga.

• @Orrride: Menentukan bahawa elemen kelas kanak-kanak mengatasi unsur superclass (kelas induk). Jika anotasi ini hadir dan superclass tidak mempunyai unsur nama yang sama, pengkompil mengeluarkan ralat supaya anda tahu ada yang salah dengan penolakan itu.

• @Repeatable: Kebanyakan anotasi hanya digunakan sekali pada elemen tertentu. Walau bagaimanapun, dalam beberapa kes, anda perlu memohon anotasi lebih daripada sekali. Anotasi ini memberitahu Java bahawa ia boleh diterima menerapkan anotasi kepada elemen tertentu lebih dari satu masa.

• @Retensi: Anotasi hanya boleh menjejaskan kod sumber; kod sumber dan pengkompil; atau kod sumber, pengkompil, dan JVM. Anotasi ini menentukan apakah kesan anotasi lain yang perlu. Sebagai contoh, anda mungkin hanya memerlukan anotasi khusus dokumentasi untuk menjejaskan kod sumber dan pengkompil.

• @ SafeVarargs: Anda mungkin melakukan operasi yang tidak selamat pada argumen yang diberikan kepada kaedah atau pembina. Anotasi ini mengatakan bahawa kod itu tidak melakukan apa-apa yang tidak selamat dan oleh itu tidak memerlukan semua pemeriksaan biasa. Mengurangkan bilangan cek menjadikan aplikasi berjalan lebih cepat.

• @SuppressWarnings: Pengkompil Java menghasilkan banyak amaran untuk memberi isyarat masalah yang berpotensi. Sebagai contoh, jika anda cuba menggunakan kaedah yang tidak digunakan dalam kod anda, pengkompil mengeluarkan mesej amaran mengenainya. Penjelasan ini memberitahu pengkompil untuk tidak mengeluarkan amaran sedemikian untuk elemen yang terjejas.

• @ Target: Apabila anda membuat anotasi anda sendiri, boleh membantu memberitahu pengkompil bahawa anotasi ini hanya akan mempengaruhi jenis elemen tertentu. Sebagai contoh, jika anda membuat blok pengarang yang dimaksudkan untuk dipaparkan hanya pada tahap pakej, maka anda boleh membatasi penjelasan kepada hanya jenis elemen itu dengan menggunakan anotasi @ Target.