- Аннотация (Java)
-
Java-аннотация — в языке Java специальная форма синтетических метаданных, которая может быть добавлена в исходный код.
Аннотации используются для анализа кода, компиляции или выполнения. Аннотированы могут быть пакеты, классы, методы, переменные и параметры.
Содержание
Применение
Аннотация выполняет следующие функции:
- дает необходимую информацию для компилятора;
- дает информацию различным инструментам для генерации другого кода, конфигураций и т. д.;
- может использоваться во время работы кода;
Встроенные аннотации
- Аннотации, применяемые к java-коду:
-
- @Override — Проверяет, переопределен ли метод. Вызывает предупреждение компиляции, если метод не найден в родительском классе;
- @Deprecated — Отмечает, что метод устарел. Вызывает предупреждение компиляции, если метод используется;
- @SuppressWarnings — Указывает компилятору подавить предупреждения компиляции, определенные в параметрах аннотации;
- Аннотации, применяемые к другим аннотациям:
-
- @Retention — Определяет, как отмеченная аннотация может храниться — в коде, в скомпилированном классе или во время работы кода;
- @Documented — Отмечает аннотацию для включения в документацию;
- @Target — Отмечает аннотацию как ограничивающую, какие элементы java-аннотации могут быть к ней применены;
- @Inherited — Отмечает, что аннотация может быть расширенна подклассами аннотируемого класса;
Пример
public class Animal { public void speak() { } } public class Cat extends Animal { @Override // Аннотация говорящая о том, что этот метод переопределен public void speak() { System.out.println("Meow."); } }
История
Первоначально в платформе Java имелся механизм, предваряющий механизм аннотаций — например, модификатор transient или тэг @deprecated. В сентябре 2002 года сообществу Java представлен документ JSR-175, описывающий основные тезисы по аннотациям. Он был утвержден в 2004 году. Аннотации стали доступны в самом языке начиная с версии 1.5 JDK и описаны в JSR-269. В версии 1.6 аннотации были интегрированы в компилятор javac.
Ссылки
- Introduction to Java 5.0 Annotations by Joy Christy
- Of Java Annotations by John Hunt
- An Introduction to Java Annotations by M. M. Islam Chisty
- Introduction to Java 6 Annotations at Sun Developer Network Site
Для улучшения этой статьи желательно?: - Дополнить статью (статья слишком короткая либо содержит лишь словарное определение).
- Исправить статью согласно стилистическим правилам Википедии.
- Викифицировать статью.
Категория:- Java
Wikimedia Foundation. 2010.