जावा में एनोटेशन, कक्षाओं, क्षेत्रों और विधियों का वर्णन करने के लिए एक साधन प्रदान करते हैं। अनिवार्य रूप से, वे जावा स्रोत फ़ाइल में जोड़े गए मेटाडेटा का एक रूप हैं, वे सीधे किसी कार्यक्रम के शब्दार्थ को प्रभावित नहीं कर सकते हैं। हालाँकि, एनोटेशन को रिफ्लेक्शन का उपयोग करके रन-टाइम पर पढ़ा जा सकता है और इस प्रक्रिया को आत्मनिरीक्षण के रूप में जाना जाता है। तब इसका उपयोग कक्षाओं, क्षेत्रों या विधियों को संशोधित करने के लिए किया जा सकता था।
यह सुविधा, अक्सर पुस्तकालयों और एसडीके (हाइबरनेट, ज्यूनीट, स्प्रिंग फ्रेमवर्क) द्वारा शोषण की जाती है, कोड की मात्रा को सरल या कम करने के लिए जो एक प्रोग्रामर तब तक इन पुस्तकालयों या एसडीके के साथ काम करने के लिए नहीं करेगा। इसके अलावा, इसे एनोटेशन कहना उचित है। परावर्तन कार्य जावा में हाथ से काम करता है।
हमें किसी एनोटेशन की उपलब्धता को या तो संकलन-समय या रनटाइम तक सीमित करना है। कस्टम एनोटेशन बनाने के लिए भी एक सरल उदाहरण है।
Driver.java
package io.hamzeen;
import java.lang.annotation.Annotation;
public class Driver {
public static void main(String[] args) {
Class<TestAlpha> obj = TestAlpha.class;
if (obj.isAnnotationPresent(IssueInfo.class)) {
Annotation annotation = obj.getAnnotation(IssueInfo.class);
IssueInfo testerInfo = (IssueInfo) annotation;
System.out.printf("%nType: %s", testerInfo.type());
System.out.printf("%nReporter: %s", testerInfo.reporter());
System.out.printf("%nCreated On: %s%n%n",
testerInfo.created());
}
}
}
TestAlpha.java
package io.hamzeen;
import io.hamzeen.IssueInfo;
import io.hamzeen.IssueInfo.Type;
@IssueInfo(type = Type.IMPROVEMENT, reporter = "Hamzeen. H.")
public class TestAlpha {
}
IssueInfo.java
package io.hamzeen;
import java.lang.annotation.ElementType;
import java.lang.annotation.Retention;
import java.lang.annotation.RetentionPolicy;
import java.lang.annotation.Target;
/**
* @author Hamzeen. H.
* @created 10/01/2015
*
* IssueInfo annotation definition
*/
@Retention(RetentionPolicy.RUNTIME)
@Target(ElementType.TYPE)
public @interface IssueInfo {
public enum Type {
BUG, IMPROVEMENT, FEATURE
}
Type type() default Type.BUG;
String reporter() default "Vimesh";
String created() default "10/01/2015";
}