Введение в аннотации Java
Разработка Java на основе аннотаций, несомненно, является последней тенденцией развития. [Примечание переводчика: это статья 2005 года. В 2014 году нет сомнений, что использование аннотаций стало хорошим решением для совместной разработки несколькими людьми. таким образом, взаимное влияние и связь могут быть очень низкими].
Разработка на основе аннотаций освобождает разработчиков Java от громоздких и громоздких файлов конфигурации. Аннотации были впервые представлены в Java 5.0. Аннотации являются одной из особенностей этой версии JDK, передавая компилятору работу программистов по написанию примеров API-файлов Java. Код и документацию легче поддерживать, если больше не ведется отдельный исходный код и документация по API. Сгенерированные примеры кода также с меньшей вероятностью будут содержать ошибки.
Аннотации Java — это одна из основных функций JDK 5, упрощающая и упрощающая разработку. Аннотации похожи на своего рода метаинформацию (мета, которую можно понимать как дополнительную информацию для просмотра специальными программами) и могут быть добавлены в код In. , его можно использовать в объявлениях пакетов, объявлениях типов, конструкторах, методах, полях, параметрах и переменных. Они предоставляют эффективный способ указать, зависит ли метод от других методов, является ли он полным, ссылается ли класс на другие классы и т. д.
Цитата с официального сайта Oracle: «Она (разработка на основе аннотаций) позволяет нам во многих случаях избежать необходимости писать отдельную документацию по API. Нам нужно только включить инструменты для генерации аннотаций из исходного кода. Этот декларативный стиль программирования был Программисты говорят: что нужно сделать, просто позвольте инструменту сделать это в соответствии с кодом».
Проще говоря, аннотации — это механизм, который связывает метатеги с элементами программы, позволяя компилятору или JVM извлекать поведение программы из аннотированных элементов и при необходимости генерировать взаимозависимый код.
В первой части этой серии статей я представлю некоторые основные аннотации Java, их преимущества и некоторые примеры использования.
Основы аннотаций Java
Вам необходимо понять две вещи: одна — это сама «аннотация» (аннотация, похожая на новый объект), а другая — «тип аннотации» (тип аннотации, аналогичный определению класса). используется в вашем коде и имеет жизненный цикл и область применения. Тип аннотации используется для определения аннотаций. Вы будете использовать его, когда захотите создать свои собственные аннотации. type — это фактически используемый сконструированный тип, а аннотация — это просто конкретное использование этого типа.
При определении типа аннотации вам необходимо использовать знак «at» (@, некоторые люди в Китае произносят его как кружок), за которым следует ключевое слово «интерфейс», а также имя аннотации. С другой стороны, используя форму. Кроме того, при использовании аннотаций после имени можно добавлять круглые скобки, чтобы включить необходимые параметры. Далее вы увидите их примеры:
Пример определения типа аннотации: (Тип аннотации, тип аннотации, аналогичный определению класса)
Скопируйте код кода следующим образом:
общественный @interface MyAnnotation {
Строка doSomething();
}
Использование аннотаций (экземпляров аннотаций) в обычном коде
Скопируйте код кода следующим образом:
@MyAnnotation (doSomething="Что делать")
общественный недействительный мой метод () {
....
}
Типы аннотаций Java (Типы аннотаций)
Существует три типа аннотаций:
Маркер. Аннотации типа маркера не имеют элементов, а имеют только имя.
определение:
Скопируйте код кода следующим образом:
// Этот вид аннотации похож на метку, без статуса
// Немного похоже на интерфейс Serializable без определения метода
общественный @interface AMarkerAnnotation {
}
использовать:
Скопируйте код кода следующим образом:
@AMarkerAnnotation
общественный недействительный мой метод () {
....
}
Одноэлементные аннотации. Одноэлементные аннотации или аннотации с одним значением содержат только одни данные. Они могут быть выражены как данные=значение в круглых скобках или может быть передано только одно значение (простой метод записи).
определение:
Скопируйте код кода следующим образом:
общественный @interface SingleElementAnnotation
{
Строка doSomething();
}
использовать:
Скопируйте код кода следующим образом:
@SingleElementAnnotation («Можно передавать только значения соответствующего типа»)
общественный недействительный мой метод () {
....
}
Аннотации с полным или множественным значением. Аннотации с полным значением имеют несколько элементов данных, поэтому параметры необходимо передавать с использованием полного синтаксического формата данные=значение для каждого элемента.
определение:
Скопируйте код кода следующим образом:
общественный @interface FullValueAnnotation {
Строка doSomething();
число интервалов;
Строковая дата();
}
использовать:
Скопируйте код кода следующим образом:
@FullValueAnnotation (doSomething="значение параметра", count=1,
дата="09-09-2005")
общественный недействительный мой метод () {
....
}
Рекомендации по определению типов аннотаций Java
На что следует обратить внимание при определении типов аннотаций:
1. Объявление аннотации должно начинаться с символа (@), за которым следует ключевое слово интерфейса и имя аннотации.
2. Объявление метода в аннотации не принимает никаких параметров (оно просто выглядит как метод, но по сути является атрибутивным доменом).
3. Объявление метода в аннотации не может содержать предложение throws.
4. Типы возвращаемых значений метода в аннотациях могут быть только следующими:
@primitives (6 примитивных типов данных: int, byte и т. д.)
@String(строка)
@Class(класс, например String.class)
@enum(перечисление)
@array вышеуказанных типов (массив, элементы массива могут быть только одного из указанных выше типов)
Типы аннотаций Java
В JDK5 есть два типа аннотаций:
1. Простые аннотации (простые типы аннотаций): это базовые типы, предоставляемые Tiger (Tiger — это кодовое имя JDK1.5?), и их можно использовать только для аннотирования обычного кода; их нельзя использовать для создания другого пользовательского типа аннотаций; .
2. Мета-аннотации: специально предназначены для аннотирования объявлений других типов аннотаций. Проще говоря, они называются аннотациями-аннотациями.