CKTIS / Java
Vrste anotacija — @interface
Deklaracija @interface definira vrstu anotacije, odnosno metapodatke pridružene kodu. Elementi opisuju podatke anotacije, a meta-anotacije određuju dopuštena mjesta uporabe, zadržavanje, ponavljanje i nasljeđivanje.
Verzija: Java SE 21; repository runtime, production runtime not attested
Sintaksa
@Retention(RetentionPolicy.RUNTIME)
@Target({ElementType.TYPE, ElementType.FIELD, ElementType.METHOD, ElementType.CONSTRUCTOR})
@interface Label {
String value();
int priority() default 0;
}@interface definira vrstu anotacije. Element kao što je String value(); metoda je bez parametara i bez tijela. Dopušteni tipovi su primitivni tipovi, String, Class, enumovi, tipovi anotacija i njihova jednodimenzionalna polja; vrijednost ne može biti null. Element bez default je obvezan. @Label("demo") skraćeni je oblik zapisa @Label(value = "demo") kada ostali elementi imaju zadane vrijednosti.
@Retention određuje koliko se dugo metapodaci zadržavaju: RetentionPolicy.SOURCE znači da ih prevoditelj odbacuje; RetentionPolicy.CLASS znači da se zapisuju u datoteku klase, bez jamstva da će biti dostupni putem refleksije; RetentionPolicy.RUNTIME znači da se zadržavaju i tijekom izvođenja. Pristup putem refleksije ipak ovisi o mjestu uporabe anotacije. Na primjer, anotacija s RetentionPolicy.RUNTIME koja označava uporabu tipa pri eksplicitnoj pretvorbi (cast) može se zapisati u datoteku klase, ali standardni API za refleksiju u Java SE 21 ne omogućuje pristup toj anotaciji. Anotacije na deklaracijama lokalnih varijabli ili parametara lambda izraza ne zapisuju se u datoteku klase čak ni uz RetentionPolicy.RUNTIME. Ako nema @Retention, primjenjuje se RetentionPolicy.CLASS. Anotacija sama ne izvršava logiku: mora je protumačiti alat ili kod.
@Target ograničava dopuštena mjesta uporabe. ElementType.TYPE obuhvaća deklaracije klasa, sučelja, enumova i zapisa; ElementType.FIELD obuhvaća polja, uključujući konstante enumova; ElementType.METHOD obuhvaća metode; ElementType.CONSTRUCTOR obuhvaća konstruktore. ElementType.TYPE ne znači bilo kakvu uporabu tipa: za to služi ElementType.TYPE_USE.
@Repeatable navodi spremnik koji omogućuje ponavljanje anotacija iste vrste. Spremnik deklarira value(), koji vraća polje ponavljane vrste, a njegovi ostali elementi moraju imati zadane vrijednosti. Također mora zadovoljiti pravila kompatibilnosti JLS-a za zadržavanje, ciljeve i meta-anotacije.
@Inherited omogućuje odgovarajućim refleksijskim upitima za anotacije klasa da pretražuju nadklase. Ne prenosi anotacije s implementiranih sučelja niti uzrokuje nasljeđivanje anotacija metoda, polja ili konstruktora. Primjer prikazuje četiri dopuštena cilja te čita izričitu i zadanu vrijednost.
Primjeri
import java.lang.annotation.*;
public class Main {
@Retention(RetentionPolicy.RUNTIME)
@Target({ElementType.TYPE, ElementType.FIELD,
ElementType.METHOD, ElementType.CONSTRUCTOR})
public @interface Label {
String value();
int priority() default 0;
}
@Label("demo")
static class Item {
@Label("id")
int id;
@Label("create")
Item() {}
@Label(value = "read", priority = 2)
void read() {}
}
public static void main(String[] args) throws ReflectiveOperationException {
Label type = Item.class.getAnnotation(Label.class);
Label method = Item.class.getDeclaredMethod("read").getAnnotation(Label.class);
System.out.println(type.value() + ":" + type.priority());
System.out.println(method.value() + ":" + method.priority());
}
}Rezultat
demo:0 read:2
Prikazani kôd i navedeni rezultat provjereni su u izoliranom okruženju metodom zabilježenom u dokazu provjere za ovu točnu verziju.