Adnotacje w Javie stanowią sposób na opisanie klas, pól i metod. Zasadniczo są one formą metadanych dodawanych do pliku źródłowego Java, nie mogą bezpośrednio wpływać na semantykę programu. Jednak adnotacje można odczytać w czasie wykonywania za pomocą Reflection, a proces ten nosi nazwę introspekcji. Następnie można go użyć do modyfikacji klas, pól lub metod.
Ta funkcja jest często wykorzystywana przez biblioteki i zestawy SDK (hibernacja, JUnit, Spring Framework) w celu uproszczenia lub zmniejszenia ilości kodu, który programista by zrobił, chyba że zrobiłby to inaczej, aby pracować z tymi bibliotekami lub zestawami SDK. Dlatego słusznie jest powiedzieć Adnotacje i Odbicie działa ręka w rękę w Javie.
Możemy również ograniczyć dostępność adnotacji do czasu kompilacji lub środowiska wykonawczego. Poniżej znajduje się prosty przykład tworzenia niestandardowej adnotacji
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";
}