Аннотация – это функциональность языка программирования Java появившейся в версии 2 5.0, который с ее помощью можно внедрять дополнительную информацию в исходный код. Эта информация, именуемая аннотациями или примечаниями (annotations), не изменяет алгоритм работы программы. Таким образом, аннотации оставляют семантику программы неизменной. Но эта информация может использоваться различными программными средствами, как во время разработки, так и во время установки программы. Например, аннотации могут обрабатываться генератором исходного кода. Хотя компания Sun называет это новое средство метаданными, более информативный термин "возможность аннотирования программ" так же применяется.
Метаданные реализованы с помощью средств, основанных на интерфейсах. Начнем с примера. В следующих строках приведено объявление аннотации с именем MyAnnо:
@interface MyAnno {
String str();
int val();
}
Во-первых, обратите внимание на то, что ключевому слову interfaceпредшествует символ @. Такая запись сообщает компилятору об объявлении аннотации. В объявлении также есть два метода-члена: String str() и int val (). Все аннотации содержат только объявления методов, но вы не должны добавлять тела этим методам. Их реализует язык Java. Кроме того, как Вы увидите, эти методы действуют скорее как поля.
Все типы аннотаций автоматически расширяют интерфейс Annotation. Следовательно, тип Annotation служит суперинтерфейсом для всех аннотаций. Он объявлен в пакете java.lang.annotation, В этом интерфейсе перегружены методы: hashCode(), equals () иtoString(), определенные в типе Object. В нем также определен метод annotationType(), который возвращает объект типа class, представляющий вызывающую аннотацию.
После того как Вы объявили аннотацию, Вы можете использовать ее для включения примечаний в объявления. Объявление любого типа может иметь аннотацию, связанную с ним. Например, можно снабжать примечаниями классы, методы, поля, параметры и константы типа enum. Даже к аннотации можно добавить аннотацию. Во всех случаях аннотация предшествует объявлению.
Когда Вы применяете аннотацию, Вы задаете значения для ее методов-членов. Далее приведен фрагмент, в котором аннотация MуАnnосопровождает объявление метода:
// Аннотация для метода,
@MyAnno(str = "Annotation Example", val = 100)
public static void myMeth{) {
|
