Получение аннотаций во время выполнения программы с помощью рефлексии
Несмотря на то, что аннотации созданы для других программных средств разработки и распространения или установки, их может запросить любая Java-программа во время выполнения с помощью средств рефлексии. Многие читатели, вероятно, знают, рефлексия — это функциональная возможность, позволяющая получать информацию о классе во время выполнения. Интерфейс рефлексии (Reflection API) содержится в пакете java.lang.reflect. Существует ряд способов применения рефлексии, но мы не будем обсуждать их все в этой книге. Рассмотрим несколько примеров применения этого программного средства для получения информации об аннотации.
Первый вариант использования рефлексии — получение объекта типа class, представляющего класс, аннотации которого Вы хотите получить. Существуют разные способы получения объекта типа class. Простейший — вызов метода getClass(), который определен в классе Object. В следующей строке приведен общий вид такого вызова:
final Class<-? Extends Object>getClass()
Метод возвращает объект типа Class, который представляет вызывающий объект. Учтите, что тип class теперь, настраиваемый.
После того, как Вы получили объект типа Class, можно использовать его методы для извлечения информации об отдельных элементах, объявленных в классе, включая аннотации. Если Вы хотите получить аннотации, связанные с конкретным элементом, определенным в пределах класса, то сначала необходимо извлечь объект, представляющий этот элемент. Например, тип класс предоставляет (среди прочих) методы: getMethod(), getField() и getConstructor(), получающие сведения о методе, поле и конструкторе соответственно. Эти методы возвращают объекты типа Method, Field и Constructor.
Для того чтобы лучше понять процесс, рассмотрим пример, в котором извлекаются аннотации, связанные с методом. Для этого Вы сначала получаете объект типа Class, представляющий класс, а затем вызываете метод get-Method о для этого объекта типа Class, задавая имя интересующего Вас метода. Синтаксическая запись вызова метода getMethod() приведена в следующей строке: Method getMethod(String methName, Class ... paramTypes)
Имя метода передается в параметре methName. Если у метода есть аргументы, то в параметре paramTypes следует указать объекты типа class, представляющие их типы. Обратите внимание на то, что paramTypes — параметр переменной длины (varargs parameter). Это означает, что можно задать столько параметров, сколько нужно, включая их отсутствие. Метод getMethod() возвращает объект типа Method, который представляет метод. Если метод не найден, генерируется исключение NoSuchMethodException.
Из объекта типа Class, Method, Field, Constructor или Package Вы можете получить конкретную аннотацию, связанную с объектом, с помощью вызова метода getAnnotation(), синтаксическая запись которого приведена в следующей строке:
<Т extends Annotation> T getAnnotation(classannoType)
Параметр аппоType — это объект типа Class, который представляет интересующую вас аннотацию. Он возвращает ссылку на аннотацию. Используя ее, Вы можете получить значения, связанные с методами-членами аннотации.
В листинге 7.1 собраны все приведенные ранее фрагменты кода и использована рефлексия для отображения аннотации, связанной с методом.
Листинг 7.1. Применение рефлексии для отображения аннотации, связанной с методом
// An annotation type declaration.
@Retention(RetentionPolicy.RUNTIME)
@interface MyAnno {
String str();
int val();
}
class Meta {
// Annotate a method.
@MyAnno(str = "Annotation Example", val = 100)
public static void myMeth() {
Meta ob = new Meta();
// Obtain the annotation for this method
// and display the values of the members.
try {
// First, get a Class Object that represents
// this class.
Class c = ob.getClass();
// Now, get a Method Object that represents
// this method.
Method m = c.getMethod("myMeth");
// Next, get the annotation for this class.
MyAnno anno = m.getAnnotation(MyAnno.class);
// Finally, display the values.
System.out.println(anno.str() + " " + anno.val());
} catch (NoSuchMethodException exc) {
System.out.println("Method Not Found.");
}
}
public static void main(String args[]) {
myMeth();
}
}
Далее приведен вывод результатов работы программы из листинга 7.1:
Annotation Example 100
В программе используется рефлексия для получения и отображения значений методов str и val аннотации типа MyAnno, связанной с методом myMeth() в классе Meta.
Листинг 7.2 Применение рефлексии для отображения аннотации, связанной с методом, имеющим аргументы
import java.lang.annotation.*;
import java.lang.reflect.*;
@Retention(RetentionPolicy.RUNTIME)
@interface MyAnno {
String str();
int val();
}
class Meta {
// myMeth now has two arguments.
@MyAnno(str = "Two Parameters", val = 19)
public static void myMeth(String str, int i)
{
Meta ob = new Meta();
try {
Class c = ob.getClass();
// Here, the parameter types are specified.
Method m = c.getMethod("myMeth", String.class, int.class);
MyAnno anno = m.getAnnotation(MyAnno.class);
System.out.println(anno.str() + " " + anno.val());
} catch (NoSuchMethodException exc) {
System.out.println("Method Not Found.");
}
}
public static void main(String args[]) {
myMeth("test", 10);
}
}
Листинг 7.3. Получение всех аннотаций для класса и метода
@Retention(RetentionPolicy.RUNTIME)
@interface MyAnno {
String str();
int val();
}
@Retention(RetentionPolicy.RUNTIME)
@interface What {
String description();
}
@What(description = "An annotation test class")
@MyAnno(str = "Meta2", val = 99)
class Meta2 {
@What(description = "An annotation test method")
@MyAnno(str = "Testing", val = 100)
public static void myMeth() {
Meta2 ob = new Meta2();
try {
Annotation annos[] = ob.getClass().getAnnotations();
// Display all annotations for Meta2.
System.out.println("All annotations for Meta2:");
for(Annotation a : annos)
System.out.println(a);
System.out.println();
// Display all annotations for myMeth.
Method m = ob.getClass( ).getMethod("myMeth");
annos = m.getAnnotations();
System.out.println("All annotations for myMeth:");
for(Annotation a : annos)
System.out.println(a);
}
catch (NoSuchMethodException exc) {
System.out.println("Method Not Found.");
}
} public static void main(String args[]) {
myMeth();
}
}
Далее приведен вывод результатов работы программы из листинга 7.3:
All annotations for Meta2:
@What (description=An annotation test class)
SMyAnno (str=Meta2, val=99)
All annotations for myMeth:
@What {description=An annotation test method)
@MyAnno (str=Testing, val=100}
В листинге 7.3 используется метод getAnnotations() для получения массива всех аннотаций, связанных с классом Meta2 и методом myMeth(). Как уже объяснялось, метод getAnnotations() возвращает массив объектов типа Annotation. Напоминаю, что Annotation — это суперинтерфейс всех интерфейсов аннотаций, в котором перегружены методы equals() и toString() класса Object. Следовательно, когда выводится ссылка на интерфейс Annotation, вызывается его метод toString() для генерации строки, описывающей аннотацию, как показано в выводе результатов программы из листинга 7.3.
Опубликовал Kest
January 13 2009 10:34:23 ·
0 Комментариев ·
16003 Прочтений ·
• Не нашли ответ на свой вопрос? Тогда задайте вопрос в комментариях или на форуме! •
Комментарии
Нет комментариев.
Добавить комментарий
Рейтинги
Рейтинг доступен только для пользователей.
Пожалуйста, залогиньтесь или зарегистрируйтесь для голосования.
Нет данных для оценки.
Гость
Вы не зарегистрированны? Нажмите здесь для регистрации.
Главная
Каталог файлов
