CKTIS / Java
Типове анотации — @interface
Декларацията @interface дефинира тип анотация, тоест метаданни, прикрепени към кода. Елементите описват данните на анотацията, а метаанотациите управляват разрешените места за употреба, запазването, повторяемостта и наследяването.
Версия: Java SE 21; repository runtime, production runtime not attested
Синтаксис
@Retention(RetentionPolicy.RUNTIME)
@Target({ElementType.TYPE, ElementType.FIELD, ElementType.METHOD, ElementType.CONSTRUCTOR})
@interface Label {
String value();
int priority() default 0;
}@interface дефинира тип анотация. Елемент като String value(); е метод без параметри и без тяло. Разрешените типове са примитивни типове, String, Class, enum-и, типове анотации и едномерни масиви от тях; стойността не може да бъде null. Елемент без default е задължителен. @Label("demo") е съкратен запис на @Label(value = "demo"), когато останалите елементи имат стойности по подразбиране.
@Retention определя колко дълго се запазват метаданните: RetentionPolicy.SOURCE означава, че компилаторът ги премахва; RetentionPolicy.CLASS означава, че се записват във файла на класа, без гаранция, че ще са достъпни чрез рефлексия; RetentionPolicy.RUNTIME означава, че се запазват и по време на изпълнение. Достъпът чрез рефлексия обаче зависи от мястото, на което се използва анотацията. Например анотация с RetentionPolicy.RUNTIME, която се отнася до употребата на тип при явно преобразуване на тип (cast), може да бъде записана във файла на класа, но стандартният API за рефлексия в Java SE 21 не предоставя достъп до нея. Анотациите върху декларации на локални променливи или на параметри на ламбда изрази не се записват във файла на класа дори при RetentionPolicy.RUNTIME. Ако няма @Retention, се прилага RetentionPolicy.CLASS. Анотацията сама по себе си не изпълнява логика: инструмент или код трябва да я интерпретира.
@Target ограничава разрешените места за употреба. ElementType.TYPE обхваща декларации на класове, интерфейси, enum-и и записи; ElementType.FIELD обхваща полета, включително enum константи; ElementType.METHOD обхваща методи; ElementType.CONSTRUCTOR обхваща конструктори. ElementType.TYPE не означава произволна употреба на тип: за това служи ElementType.TYPE_USE.
@Repeatable посочва контейнер, който позволява повторение на анотации от един и същ тип. Контейнерът декларира value(), което връща масив от повтаряния тип, а останалите му елементи трябва да имат стойности по подразбиране. Той трябва също да спазва правилата за съвместимост на JLS относно запазването, целите и метаанотациите.
@Inherited позволява на подходящи рефлексивни заявки за анотации на класове да търсят и в суперкласовете. То не пренася анотации от имплементирани интерфейси и не води до наследяване на анотации върху методи, полета или конструктори. Примерът показва четири разрешени цели и прочита изрично зададена стойност и стойност по подразбиране.
Примери
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());
}
}Резултат
demo:0 read:2
Показаният код и заявеният резултат са проверени в изолирана среда по метода, записан в доказателството за проверка на тази точна версия.