Java'daki ek açıklamalar, sınıfları, alanları ve yöntemleri açıklamak için bir yol sağlar. Temel olarak, bir Java kaynak dosyasına eklenen bir meta veri biçimidir, bir programın anlambilimini doğrudan etkileyemezler. Ancak ek açıklamalar Reflection kullanılarak çalışma zamanında okunabilir ve bu işlem Introspection olarak bilinir. Daha sonra sınıfları, alanları veya yöntemleri değiştirmek için kullanılabilir.
Bu özellik, bir programcının bu Kütüphaneler veya SDK'larla çalışmak için yapmadıkça kod miktarını basitleştirmek veya azaltmak için genellikle Kütüphaneler ve SDK'lar (hazırda beklet, JUnit, Spring Framework) tarafından kullanılır. Bu nedenle, Açıklamalar ve Yansıma çalışma el Java.
Ayrıca, bir ek açıklamanın kullanılabilirliğini derleme zamanı veya çalışma zamanı ile sınırlayabiliriz.Aşağıda, özel bir ek açıklama oluşturmanın basit bir örneği
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";
}