Introducción a las anotaciones de Java
El desarrollo de Java basado en anotaciones es sin duda la última tendencia de desarrollo [Nota del traductor: este es un artículo de 2005. En 2014, no hay duda de que el uso de anotaciones se ha convertido en una buena solución para el desarrollo colaborativo de varias personas. manera, la influencia mutua y el acoplamiento pueden ser muy bajos].
El desarrollo basado en anotaciones libera a los desarrolladores de Java de archivos de configuración engorrosos y engorrosos. Las anotaciones se introdujeron por primera vez en Java 5.0. Las anotaciones son una de las características de esta versión de JDK y transfieren el trabajo de los programadores para escribir archivos API de muestra de Java al compilador. El código y la documentación son más fáciles de mantener cuando ya no se mantienen el código fuente y la documentación de la API por separado. También es menos probable que los ejemplos de código generado contengan errores.
Las anotaciones de Java son una de las características principales de JDK 5, lo que hace que el desarrollo sea más simple y fácil. Las anotaciones son como una especie de metainformación (meta, que puede entenderse como información adicional para que la vean programas especiales) y se pueden agregar al código. , se puede utilizar en declaraciones de paquetes, declaraciones de tipos, constructores, métodos, campos, parámetros y variables. Proporcionan una forma eficaz de indicar si un método depende de otros métodos, si está completo, si la clase hace referencia a otras clases, etc.
Citando el sitio web oficial de Oracle, "(El desarrollo basado en anotaciones) nos permite evitar tener que escribir documentación API separada en muchos casos. Solo necesitamos habilitar herramientas para generar anotaciones a partir del código fuente. Este estilo de programación declarativa ha sido "Los programadores dicen que lo que hay que hacer es dejar que la herramienta lo haga de acuerdo con el código".
En pocas palabras, las anotaciones son un mecanismo que asocia metaetiquetas con elementos del programa, lo que permite al compilador o JVM extraer el comportamiento del programa de los elementos anotados y generar código interdependiente cuando sea necesario.
En la primera parte de esta serie de artículos, presentaré algunas anotaciones básicas de Java, sus beneficios y algunos ejemplos de uso.
Conceptos básicos de anotaciones en Java
Debe comprender dos cosas: una es la "anotación" (anotación, similar a un nuevo objeto) en sí misma y la otra es el "tipo de anotación" (tipo de anotación, similar a una definición de clase). usado en En su código, en realidad tiene un ciclo de vida y un alcance de aplicación. El tipo de anotación se usa para definir anotaciones. Lo usará cuando desee crear sus propias anotaciones. El tipo es el tipo construido real utilizado y la anotación es solo un uso específico de ese tipo.
Al definir un tipo de anotación, debe usar una marca "arroba" (@, algunas personas en China lo pronuncian como un círculo), seguida de la palabra clave interfaz, más el nombre de la anotación. Por otro lado, use el formulario. El tipo de anotación también es Primero escriba el símbolo "arroba" (@), seguido del tipo de anotación. Esta es la forma más simple de anotación. Además, cuando utilice anotaciones, puede agregar paréntesis después del nombre para incluir los parámetros necesarios. ser aprobado. A continuación verás ejemplos de ellos:
Ejemplo de definición de tipo de anotación: (Tipo de anotación, tipo de anotación, similar a definir una clase)
Copie el código de código de la siguiente manera:
public @interface Mi anotación {
Cadena hacer algo();
}
Usar anotaciones (instancias de anotaciones) en código normal
Copie el código de código de la siguiente manera:
@MyAnnotation (hacerAlgo="Qué hacer")
mi método público vacío() {
....
}
Tipos de anotaciones de Java (Tipos de anotaciones)
Hay tres tipos de anotaciones:
Marcador: Las anotaciones de tipo marcador no tienen elementos, solo un nombre.
definición:
Copie el código de código de la siguiente manera:
// Este tipo de anotación es como una etiqueta, sin estado
// Un poco como la interfaz Serializable sin definición de método
public @interface AMarkerAnnotation {
}
usar:
Copie el código de código de la siguiente manera:
@AMarkerAnnotation
mi método público vacío() {
....
}
Anotaciones de un solo elemento: las anotaciones de un solo elemento o de un solo valor contienen solo un dato. Se pueden expresar como datos = valor entre paréntesis, o solo se puede pasar un valor (método de escritura simple).
definición:
Copie el código de código de la siguiente manera:
@interfaz pública SingleElementAnnotation
{
Cadena hacer algo();
}
usar:
Copie el código de código de la siguiente manera:
@SingleElementAnnotation ("Solo puedes pasar valores del tipo correspondiente")
mi método público vacío() {
....
}
Anotaciones de valor completo o de valores múltiples: las anotaciones de tipo de valor completo tienen múltiples miembros de datos, por lo tanto, los parámetros se deben pasar utilizando el formato de sintaxis de datos=valor completo para cada miembro.
definición:
Copie el código de código de la siguiente manera:
public @interface Anotación de valor completo {
Cadena hacer algo();
recuento int;
Fecha de cadena();
}
usar:
Copie el código de código de la siguiente manera:
@FullValueAnnotation (doSomething="valor del parámetro", recuento=1,
fecha="09-09-2005")
mi método público vacío() {
....
}
Consideraciones para definir tipos de anotaciones Java
Cosas a tener en cuenta al definir tipos de anotaciones:
1. La declaración de anotación debe comenzar con un símbolo arroba (@), seguido de una palabra clave de interfaz y el nombre de la anotación.
2. La declaración del método en la anotación no acepta ningún parámetro (simplemente parece un método, pero es esencialmente un dominio de atributos).
3. La declaración del método en la anotación no puede tener una cláusula de lanzamiento.
4. Los tipos de retorno del método en las anotaciones solo pueden ser los siguientes:
@primitives (6 tipos de datos primitivos, int, byte, etc.)
@Cadena(cadena)
@Class(clase, como String.class)
@enum(enumeración)
@array de los tipos anteriores (matriz, los elementos de la matriz solo pueden ser uno de los tipos anteriores)
Tipos de anotaciones de Java
Hay dos tipos de anotaciones en JDK5:
1. Anotaciones simples (tipos de anotaciones simples): estos son los tipos básicos proporcionados por Tiger (¿Tiger es el nombre en clave de JDK1.5?) y solo se pueden usar para anotar código ordinario, no se pueden usar para crear otro tipo de anotación personalizada; .
2.Meta anotaciones: diseñadas específicamente para anotar declaraciones de otros tipos de anotaciones. En pocas palabras, se denominan anotaciones de anotaciones.