Crea tus anotaciones: @interface y @Retention
Tu propia anotación se declara con
@interface. Sus elementos parecen métodos sin parámetros y pueden traer un valor por default. Si un elemento no tiene default, es obligatorio darle valor al usar la anotación.@interface Auditar {
String value() default "general";
int nivel() default 1;
}
@Auditar("pagos") void cobrar() { } // value = "pagos"
@Auditar(value = "pagos", nivel = 2) void devolver() { }
@Auditar void consultar() { } // usa los default
Los elementos solo pueden ser primitivos (int, boolean…), String, Class, un enum, otra anotación o arreglos de ellos.
List u otros objetos no compilan: para varios valores usa un arreglo.String[] sabores(); // sí: un arreglo
List<String> sabores(); // no compila
@Retention dice hasta cuándo vive la etiqueta. Recibe un RetentionPolicy, un enum: SOURCE, solo la ve el compilador y luego la borra (así es @Override); CLASS, el valor por defecto, queda en el archivo .class que genera el compilador, pero no se ve al ejecutar; RUNTIME, se puede leer mientras el programa corre.import java.lang.annotation.*;
@Retention(RetentionPolicy.RUNTIME)
@Target(ElementType.METHOD) // solo en métodos
@interface Auditar { String value() default "general"; }
class Caja { @Auditar("pagos") void cobrar() { } }
Method m = Caja.class.getDeclaredMethod("cobrar");
m.isAnnotationPresent(Auditar.class); // true (si fuera CLASS: false)
@Target(ElementType.METHOD) limita dónde se puede poner: en una clase o un campo ya no compila. Leer anotaciones mientras el programa corre se llama reflexión. En el ejemplo, Caja.class es la clase como valor (no el archivo), getDeclaredMethod("cobrar") busca su método e isAnnotationPresent pregunta si trae la etiqueta.Así trabaja Spring:
@Component o @GetMapping("/hola") son RUNTIME. Al arrancar, Spring busca esas etiquetas y actúa. La anotación no hace nada sola: algo la lee.