Java Annotation เป็นแท็กที่แสดงข้อมูลเมตา เช่น แนบกับคลาส อินเตอร์เฟส เมธอด หรือฟิลด์ เพื่อระบุข้อมูลเพิ่มเติมที่คอมไพเลอร์ Java และ JVM สามารถใช้ได้

คำอธิบายประกอบใน Java ถูกใช้เพื่อให้ข้อมูลเพิ่มเติม ดังนั้นจึงเป็นตัวเลือกทางเลือกสำหรับส่วนต่อประสานตัวทำเครื่องหมาย XML และ Java

เราจะเริ่มต้นด้วยคำอธิบายประกอบที่มีอยู่แล้วภายในก่อนที่จะสร้างและใช้คำอธิบายประกอบที่กำหนดเอง

คำอธิบายประกอบ Java ในตัว

Java มีคำอธิบายประกอบในตัวหลายรายการ คำอธิบายประกอบบางรายการใช้กับโค้ด Java ในขณะที่คำอธิบายประกอบอื่นๆ ใช้กับคำอธิบายประกอบอื่นๆ

คำอธิบายประกอบ Java ในตัวที่ใช้ในโค้ด Java

• @แทนที่
• จ่าฝูง
• @เลิกใช้

• @เป้า
• @การเก็บรักษา
• @ได้รับการถ่ายทอด
• @เอกสาร

เริ่มต้นด้วยคำอธิบายประกอบในตัว

@แทนที่

คำอธิบายประกอบ @Override ช่วยให้แน่ใจว่าเมธอดคลาสย่อยจะแทนที่เมธอดคลาสพาเรนต์ หากไม่เป็นเช่นนั้น จะเกิดข้อผิดพลาดในการคอมไพล์

บางครั้งเราทำผิดพลาดโง่ๆ เช่น การสะกดผิด ด้วยเหตุนี้ จึงควรใช้คำอธิบายประกอบ @Override เพื่อให้แน่ใจว่ามีการแทนที่เมธอด

class Animal{
void eatSomething(){System.out.println("eating something");}
}
class Dog extends Animal{
@Override
void eatsomething(){System.out.println("eating foods");}//should be eatSomething
}
class TestAnnotation1{
public static void main(String args[]){
Animal a = new Dog();
a.eatSomething();
}}

Compile Time Error

คำอธิบายประกอบ @SuppressWarnings ใช้เพื่อระงับคำเตือนของคอมไพเลอร์

import java.util.*;
class TestAnnotation2{
@SuppressWarnings("unchecked")
public static void main(String args[]){
ArrayList list = new ArrayList();
list.add("sonoo");
list.add("vimal");
list.add("ratan");
for(Object obj:list)
System.out.println(obj);
}}

Now no warning at compile time.

@เลิกใช้

คำอธิบายประกอบ @Deprecated บ่งชี้ว่าวิธีนี้เลิกใช้แล้ว และคอมไพเลอร์จะพิมพ์คำเตือน แจ้งผู้ใช้ว่าอาจถูกลบในเวอร์ชันต่อๆ ไป ดังนั้นจึงเป็นการดีกว่าที่จะไม่ใช้วิธีการดังกล่าว

class A{
void m(){System.out.println("hello m");}
@Deprecated
void n(){System.out.println("hello n");}
}
class TestAnnotation3{
public static void main(String args[]){
A a = new A();
a.n();
}}

Note: Test.java uses or overrides a deprecated API.

Note: Recompile with -Xlint:deprecation for details.

hello n

คำอธิบายประกอบแบบกำหนดเองของ Java หรือที่เรียกว่าคำอธิบายประกอบที่ผู้ใช้กำหนดเองของ Java นั้นง่ายต่อการสร้างและใช้งาน มีการประกาศคำอธิบายประกอบโดยใช้องค์ประกอบ @interface ตัวอย่างเช่น:

@interface MyAnnotations{}

มีบางจุดที่โปรแกรมเมอร์ควรจำไว้

1. ไม่ควรมีคำสั่งโยนในเมธอด

3. ไม่ควรมีพารามิเตอร์ในวิธีการ

4. ในการกำหนดคำอธิบายประกอบ เราควรเพิ่ม @ ก่อนคำหลักของอินเทอร์เฟซ

5. อาจทำให้วิธีการเป็นค่าเริ่มต้น