Трейт scala.reflect.api.Annotations

ЭКСПЕРИМЕНТАЛЬНО

Этот трейт предоставляет поддержку аннотаций для API рефлексии.

В Scala аннотации относятся к одной из двух категорий:

• Аннотации Java: аннотации на определениях, созданных компилятором Java, т.е. подтипы java.lang.annotation.Annotation, прикреплённые к определениям программы.
• Аннотации Scala: аннотации на определениях или типах, созданных компилятором Scala.

При компиляции аннотации Scala, наследующей от scala.annotation.StaticAnnotation, она хранится как специальные атрибуты в соответствующем файле класса, а не как аннотация Java. Обратите внимание, что наследования только от scala.annotation.Annotation недостаточно для сохранения соответствующих метаданных для рефлексии во время выполнения.

Как аннотации Java, так и аннотации Scala представлены в виде типизированных деревьев, содержащих вызовы конструкторов, соответствующих аннотации. Например, аннотация в @ann(1, 2) class C представлена как q"@new ann(1, 2)".

В отличие от рефлексии Java, рефлексия Scala не поддерживает оценку вызовов конструкторов, хранящихся в аннотациях, в базовые объекты. Например, невозможно перейти от @ann(1, 2) class C к ann(1, 2), поэтому необходимо анализировать деревья, представляющие аргументы аннотации, чтобы вручную извлечь соответствующие значения. Для этой цели аргументы аннотации можно получить с помощью annotation.tree.children.tail.

Для получения дополнительной информации об Annotation см. Руководство по рефлексии: аннотации, имена, области видимости и многое другое