Java: la creación de nuevas anotaciones

Usted ha visto los comentarios utilizados en muchos ejemplos de código Java. El compilador ignora los comentarios, por lo que cuando se crea un comentario que puede escribir cualquier cosa que usted se siente será útil más adelante en averiguar lo que la aplicación puede hacer. Comentarios documentar su código.

Sin embargo, hay otro tipo de documentación - la anotación. Una anotación es un tipo de documentación que el compilador también entiende. Cuando el compilador ve anotación en su código, que sabe que tiene que hacer algo especial con el código que sigue. Las anotaciones son útiles para documentar su código de una manera funcional para que el compilador puede ayudar a hacer cumplir cualquier documentación que usted proporcione.

El conjunto de anotaciones predefinidos que vienen con Java son relativamente limitado en su uso. Para crear anotaciones realmente útiles, usted tiene que diseñar usted mismo o conseguir que, como parte de un paquete de terceros. Creación de una nueva anotación es un proceso de tres pasos:

  1. Añadir la declaración de importación correspondiente:

    importar java.lang.annotation *. -
  2. Definir una interfaz que describe la anotación para el compilador:

    . // Crear una descripción de la anotación @ documentada @ interfaz AuthorData {Nombre String () - Fecha String () - Versión doble () por defecto 1.0-}

    En este caso, la anotación aparecerá en la documentación creado por Javadoc, ya que incluye la anotaciónDocumented. Cada anotación descripción comienza con la palabra claveinterface seguido por el nombre del tipo de anotación, que es AuthorData en este caso.

    Dentro de las llaves, se ven los campos utilizados para definir los datos de anotación. Este ejemplo incluye Nombre, Fecha y Versión. La palabra clave por defecto proporciona un valor para un campo en particular. Esto significa que el campo usará el valor si no se define como parte de la anotación en la aplicación.

  3. Utilice la anotación en la aplicación:

    AuthorData (Nombre = "John Smythe", Fecha = "01/04/2014")

    La anotación aparece antes de que el elemento que afecta, como una declaración de la clase. Debe definir cada campo que no tiene un valor predeterminado. Opcionalmente, también se definen los campos que tienen un valor por defecto. En este caso, el nombre del autor es John Smythe, y el código de la última actualización del 01/04/2014.




» » » » Java: la creación de nuevas anotaciones