Java for Beginner

Аннотации в Java

Аннотации в Java — это метаданные, которые добавляются к коду для предоставления дополнительной информации. Они могут быть использованы компилятором, инструментами разработки и во время выполнения (через рефлексию). Аннотации не изменяют логики программы, но могут влиять на её поведение.

Основные встроенные аннотации

@ Override: Указывает, что метод переопределяет метод суперкласса.
@ Deprecated: Обозначает, что элемент (метод, класс, поле) устарел и не рекомендуется к использованию.
@ SuppressWarnings: Подавляет указанные предупреждения компилятора.
@ SafeVarargs: Обозначает, что метод с переменным числом аргументов не выполняет потенциально небезопасных операций с varargs.
@ FunctionalInterface: Указывает, что интерфейс является функциональным и содержит только один абстрактный метод.

Примеры использования встроенных аннотаций

public class AnnotationExample {

    @Override
    public String toString() {
        return "AnnotationExample";
    }

    @Deprecated
    public void oldMethod() {
        System.out.println("This method is deprecated");
    }

    @SuppressWarnings("unchecked")
    public void uncheckedOperation() {
        List rawList = new ArrayList();
        rawList.add("String");
    }

    @SafeVarargs
    public final void safeVarargsMethod(List<String>... lists) {
        for (List<String> list : lists) {
            System.out.println(list);
        }
    }

    @FunctionalInterface
    interface MyFunctionalInterface {
        void execute();
    }
}

Методы аннотаций

Аннотации могут содержать методы. Методы аннотаций могут иметь значения по умолчанию.

@interface MyAnnotation {
    String value();
    int number() default 42;
}

Аннотацию можно использовать с параметрами:

@MyAnnotation(value = "Example", number = 10)
public class AnnotatedClass {
}

Аннотации и рефлексия

Аннотации можно считывать во время выполнения с помощью рефлексии. Это позволяет динамически изменять поведение программы в зависимости от аннотированных элементов.

Пример использования рефлексии для чтения аннотаций

import java.lang.annotation.Annotation;
import java.lang.reflect.Method;

public class ReflectionExample {

    @MyAnnotation(value = "Test", number = 5)
    public void annotatedMethod() {
    }

    public static void main(String[] args) throws Exception {
        Method method = ReflectionExample.class.getMethod("annotatedMethod");

        if (method.isAnnotationPresent(MyAnnotation.class)) {
            MyAnnotation annotation = method.getAnnotation(MyAnnotation.class);
            System.out.println("Value: " + annotation.value());
            System.out.println("Number: " + annotation.number());
        }
    }
}

#Java #Training #Annotation #Medium

165 viewsДен, 05:57

Java for Beginner

Создание собственных аннотаций в Java

Создание собственных аннотаций позволяет добавлять метаданные к вашему коду, которые могут быть использованы компилятором, инструментами разработки или во время выполнения. Аннотации можно использовать для валидации данных, конфигурации и других задач.

Для создания аннотации используется ключевое слово @ interface.

import java.lang.annotation.Retention;
import java.lang.annotation.RetentionPolicy;

@Retention(RetentionPolicy.RUNTIME)
public @interface MyCustomAnnotation {
    String value();
    int number() default 42;
}

@ Retention: Указывает, насколько долго аннотация сохраняется (например, только в исходном коде, в классе или во время выполнения).
RetentionPolicy.SOURCE: Аннотация сохраняется только в исходном коде и отбрасывается компилятором.
RetentionPolicy.CLASS: Аннотация сохраняется в файле класса, но не доступна во время выполнения.
RetentionPolicy.RUNTIME: Аннотация сохраняется во время выполнения и может быть прочитана с помощью рефлексии.

Применение собственной аннотации

@MyCustomAnnotation(value = "Example", number = 10)
public class CustomAnnotatedClass {
}

Чтение аннотаций с помощью рефлексии

import java.lang.annotation.Annotation;

public class CustomAnnotationReflection {

    public static void main(String[] args) {
        Class<CustomAnnotatedClass> clazz = CustomAnnotatedClass.class;

        if (clazz.isAnnotationPresent(MyCustomAnnotation.class)) {
            MyCustomAnnotation annotation = clazz.getAnnotation(MyCustomAnnotation.class);
            System.out.println("Value: " + annotation.value());
            System.out.println("Number: " + annotation.number());
        }
    }
}

Методы аннотаций

Аннотации могут содержать методы, которые определяют параметры аннотации. Методы могут иметь значения по умолчанию.

public @interface DetailedAnnotation {
    String description();
    boolean enabled() default true;
}

Пример использования:

@DetailedAnnotation(description = "This is a detailed annotation", enabled = false)
public class DetailedAnnotatedClass {
}

Ограничения и мета-аннотации

Мета-аннотации — это аннотации, которые применяются к другим аннотациям. В Java существует несколько мета-аннотаций:

@ Retention: Указывает, насколько долго аннотация сохраняется.
@ Target: Указывает, где аннотация может быть применена (например, к методам, полям, классам).
@ Inherited: Указывает, что аннотация может быть унаследована подклассами.
@ Documented: Указывает, что аннотация должна быть задокументирована с помощью javadoc.

Пример использования мета-аннотаций:

import java.lang.annotation.ElementType;
import java.lang.annotation.Target;

@Target({ElementType.TYPE, ElementType.METHOD})
public @interface MultiTargetAnnotation {
    String value();
}

Пример практического использования собственных аннотаций

Валидация с помощью аннотаций

Создадим аннотацию для проверки полей класса:

import java.lang.annotation.ElementType;
import java.lang.annotation.Retention;
import java.lang.annotation.RetentionPolicy;
import java.lang.annotation.Target;

@Retention(RetentionPolicy.RUNTIME)
@Target(ElementType.FIELD)
public @interface NotNull {
}
Применим аннотацию к классу:

java
Копировать код
public class User {
    @NotNull
    private String name;

    public User(String name) {
        this.name = name;
    }
}

#Java #Training #Annotation #Medium

173 viewsДен, 13:59

Java for Beginner

Создадим метод для проверки полей:

import java.lang.reflect.Field;

public class Validator {

    public static void validate(Object object) throws IllegalAccessException {
        Field[] fields = object.getClass().getDeclaredFields();
        for (Field field : fields) {
            if (field.isAnnotationPresent(NotNull.class)) {
                field.setAccessible(true);
                Object value = field.get(object);
                if (value == null) {
                    throw new IllegalArgumentException(field.getName() + " cannot be null");
                }
            }
        }
    }

    public static void main(String[] args) {
        User user = new User(null);
        try {
            validate(user);
        } catch (IllegalArgumentException | IllegalAccessException e) {
            e.printStackTrace();
        }
    }
}

Этот пример показывает, как создавать и использовать собственные аннотации для выполнения валидации данных. Аннотации делают код более читаемым и структурированным, позволяя легко добавлять новые проверки и конфигурации.

#Java #Training #Annotation #Medium

171 viewsДен, 13:59

About

Blog

Apps

Platform