Introducción

Las anotaciones en Java son una forma poderosa de agregar metadatos a tu código. Estos metadatos pueden ser utilizados por el compilador, herramientas de desarrollo, o en tiempo de ejecución para influir en el comportamiento del programa. Las anotaciones son una característica clave que permite a los desarrolladores escribir código más limpio y manejable.

Conceptos Clave

Definición de Anotaciones: Las anotaciones son una forma de agregar información adicional a tu código. Se definen con el símbolo @ seguido del nombre de la anotación.
Tipos de Anotaciones: Java proporciona varias anotaciones predefinidas, y también permite a los desarrolladores crear sus propias anotaciones personalizadas.
Retención de Anotaciones: Las anotaciones pueden tener diferentes políticas de retención, que determinan en qué momento de la ejecución del programa estarán disponibles.
Objetivos de Anotaciones: Las anotaciones pueden aplicarse a diferentes elementos del código, como clases, métodos, campos, parámetros, etc.

Anotaciones Predefinidas

Java incluye varias anotaciones predefinidas que son ampliamente utilizadas:

@Override: Indica que un método está sobrescribiendo un método de una superclase.
@Deprecated: Marca un elemento como obsoleto, indicando que no debería ser usado.
@SuppressWarnings: Instruye al compilador para que suprima ciertas advertencias.

Ejemplo de Uso de Anotaciones Predefinidas

public class EjemploAnotaciones {

    @Deprecated
    public void metodoAntiguo() {
        System.out.println("Este método está obsoleto.");
    }

    @Override
    public String toString() {
        return "Ejemplo de uso de anotaciones predefinidas.";
    }

    @SuppressWarnings("unchecked")
    public void metodoConAdvertencias() {
        List lista = new ArrayList();
        lista.add("Elemento");
    }
}

Creación de Anotaciones Personalizadas

Puedes definir tus propias anotaciones en Java. Para ello, utilizas la palabra clave @interface.

Ejemplo de Anotación Personalizada

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.METHOD)
public @interface MiAnotacion {
    String valor() default "valor por defecto";
    int numero() default 0;
}

Uso de Anotaciones Personalizadas

public class EjemploAnotacionPersonalizada {

    @MiAnotacion(valor = "Ejemplo", numero = 5)
    public void metodoAnotado() {
        System.out.println("Método anotado con @MiAnotacion.");
    }
}

Retención de Anotaciones

La retención de anotaciones determina en qué momento de la ejecución del programa estarán disponibles. Las políticas de retención son:

SOURCE: La anotación se descarta después de la compilación.
CLASS: La anotación se guarda en el archivo .class pero no está disponible en tiempo de ejecución.
RUNTIME: La anotación está disponible en tiempo de ejecución.

Ejemplo de Retención

@Retention(RetentionPolicy.RUNTIME)
@Target(ElementType.METHOD)
public @interface AnotacionRuntime {
    String descripcion();
}

Ejercicio Práctico

Ejercicio

Define una anotación personalizada llamada @Informacion que tenga dos elementos: autor y fecha.
Aplica esta anotación a un método en una clase.
Escribe un programa que use reflexión para leer y mostrar los valores de la anotación en tiempo de ejecución.

Solución

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

@Retention(RetentionPolicy.RUNTIME)
@Target(ElementType.METHOD)
@interface Informacion {
    String autor();
    String fecha();
}

public class EjemploInformacion {

    @Informacion(autor = "Juan Pérez", fecha = "2023-10-01")
    public void metodoInformado() {
        System.out.println("Método con información de autor y fecha.");
    }

    public static void main(String[] args) {
        try {
            Method metodo = EjemploInformacion.class.getMethod("metodoInformado");
            if (metodo.isAnnotationPresent(Informacion.class)) {
                Informacion info = metodo.getAnnotation(Informacion.class);
                System.out.println("Autor: " + info.autor());
                System.out.println("Fecha: " + info.fecha());
            }
        } catch (NoSuchMethodException e) {
            e.printStackTrace();
        }
    }
}

Conclusión

Las anotaciones en Java son una herramienta poderosa para agregar metadatos a tu código. Pueden ser utilizadas para influir en el comportamiento del programa en tiempo de compilación y en tiempo de ejecución. Con la capacidad de crear anotaciones personalizadas, puedes extender esta funcionalidad para satisfacer las necesidades específicas de tu aplicación. En el siguiente tema, exploraremos la reflexión en Java, que te permitirá manipular y utilizar estas anotaciones de manera más avanzada.

Anotaciones

Introducción

Conceptos Clave

Anotaciones Predefinidas

Ejemplo de Uso de Anotaciones Predefinidas

Creación de Anotaciones Personalizadas

Ejemplo de Anotación Personalizada

Uso de Anotaciones Personalizadas

Retención de Anotaciones

Ejemplo de Retención

Ejercicio Práctico

Ejercicio

Solución

Conclusión

Curso de Programación en Java

Módulo 1: Introducción a Java

Módulo 2: Flujo de Control

Módulo 3: Programación Orientada a Objetos

Módulo 4: Programación Orientada a Objetos Avanzada

Módulo 5: Estructuras de Datos y Colecciones

Módulo 6: Manejo de Excepciones

Módulo 7: Entrada/Salida de Archivos

Módulo 8: Multihilo y Concurrencia

Módulo 9: Redes

Módulo 10: Temas Avanzados

Módulo 11: Frameworks y Librerías de Java

Módulo 12: Construcción de Aplicaciones del Mundo Real