Java: el uso de anotaciones predefinidas
Los tipos y el contenido de las anotaciones en Java, al igual que los comentarios, sólo están limitadas por su imaginación. Sí, Java proporciona algunas anotaciones predefinidas, pero también se puede crear anotaciones que describen los elementos del programa en cualquier forma que desee. La idea es que usted describe cómo una anotación debería funcionar, facilita los datos por él, y el compilador se encarga del resto.
Anotaciones siempre comienzan con el símbolo @ (arroba). Por lo tanto, cuando vea @Documented, sabes que estás viendo una anotación. En las siguientes secciones se explica más acerca anotaciones predefinidos y personalizados.
Una anotación predefinida es la que existe como parte de Java. A encontrar estas anotaciones en el paquete java.lang.annotation. Para utilizarlos, se agrega java.lang.annotation importación * -. Al principio de su aplicación. La lista siguiente proporciona una visión general de las anotaciones predefinidas:
Video: 05. Anotaciones (ejemplo Java)
@deprecated: A veces, una elemento - una clase, método, campo, u otra característica de programación - está sustituida por un elemento nuevo o simplemente ya no es necesario.
Cuando esto sucede, se marca el elemento como obsoletos para que los desarrolladores saben que necesitan actualizar su código y dejar de usar ese elemento en particular. Adición de la anotación @Deprecated muestra el estado en desuso del elemento en la documentación generada por Javadoc (Una utilidad que se utiliza para crear la documentación automáticamente basándose en el contenido de los archivos de código).
@Documented: Cada vez que se marca un elemento como se documenta, las salidas de utilidad Javadoc al archivo de documentación que crea basan en el contenido del archivo fuente.
@FunctionalInterface: Especifica que la interfaz es una interfaz funcional utilizada para las clases anónimas y expresiones lambda.
@Heredado: Las clases pueden heredar características de una clase padre. Por defecto, esto incluye funcionalidades tales como los métodos, pero no incluye anotaciones de la clase padre. El uso de la anotación @Inherited dice Java para aplicar las anotaciones clase padre a la subclase también.
@ Override: Especifica que un elemento de clase hija es reemplazar un elemento superclase (clase padre). Si esta anotación está presente y la superclase carece de un elemento del mismo nombre, el compilador genera un error de modo que usted sabe que algo anda mal con la anulación.
@Repeatable: La mayoría de las anotaciones se aplican sólo una vez para un elemento en particular. Sin embargo, en algunos casos es necesario aplicar la anotación más de una vez. Esta anotación indica Java que es aceptable aplicar la anotación a un elemento particular más de una vez.
@Retention: Una anotación puede afectar sólo a la fuente de código- el código fuente y compiler- o el código fuente, compilador y la JVM. Esta anotación define qué efecto otra anotación debe tener. Por ejemplo, es posible que tenga solamente una anotación de documentación específica para afectar el código fuente y el compilador.
@SafeVarargs: Es posible realizar operaciones que no son seguros en los argumentos pasados a un método o constructor. Esta anotación dice que el código no hace nada inseguro y por lo tanto no requiere de todos los controles habituales. Reducir el número de controles hace que la aplicación se ejecute más rápido.
@SuppressWarnings: El compilador de Java genera una gran cantidad de advertencias para señalar los problemas potenciales. Por ejemplo, si intenta utilizar un método obsoleto en su código, el compilador genera un mensaje de advertencia al respecto. Esta anotación le dice al compilador que no salida de este tipo de advertencias para el elemento afectado.
@Target: Al crear sus propias anotaciones, puede ser útil para decirle al compilador que estas anotaciones deben afectar sólo a un tipo de elemento específico. Por ejemplo, si se crea un bloque de autor que está destinado a aparecer sólo en el nivel de paquete, entonces se puede limitar a la anotación sólo que tipo de elemento mediante el uso de la anotación @Target.
Video: Java 8 Tutorial - 6 Interfaces Funcionales