La programación basada en anotaciones es un mecanismo extensible para generar
artefactos de aplicación, empaquetar la aplicación y leer la aplicación para la
ejecución. La programación basada en anotaciones ofrece un conjunto de códigos y un
mecanismo de proceso que permite incorporar metadatos adicionales en el código fuente de
Java. A continuación, la aplicación utiliza estos
metadatos adicionales para derivar los artefactos necesarios para ejecutar la aplicación
en un entorno J2EE.
Objetivo de la programación basada en anotaciones
El objetivo de la programación basada en anotaciones es minimizar el número de
artefactos que se deben crear y mantener, lo que simplifica
el proceso de desarrollo.
Por ejemplo, consideremos un EJB de sesión sin estado. Con la programación basada en
anotaciones, sólo tiene que crear un archivo de origen
Java individual que contenga la lógica de
implementación del bean, y varios códigos para indicar que desea desplegar esta clase como
un EJB y qué métodos deben hacerse públicos en la interfaz del EJB. Utilizando este
artefacto individual, el despliegue rápido de
WebSphere puede crear:
- las clases de interfaz inicial y remota
- una clase de derivador de implementación de sesión sin estado
- el descriptor de despliegue EJB (ejb-jar.xml)
- los datos de enlace específicos de WebSphere
- los restantes artefactos necesarios para producir una aplicación J2EE compatible
Lo único con lo que debe trabajar es con un artefacto
Java. Código de ejemplo de EJB de sesión:
/**
* @ejb.interface-method view-type=remote
*/
public String hello(String name)
{
return "Hello: " + name;
}
donde @ejb.interface-method view-type=remote es un ejemplo de un
código de anotación.
Códigos de anotación
Las anotaciones son comentarios de tipo Javadoc que se incorporan en el archivo de
origen Java. Puede incluir anotaciones en las
declaraciones de paquete, clase, campo o método. Asimismo, la sintaxis del código de
XDoclet está soportada. Para obtener más información, consulte
XDoclet.
Los códigos de anotación se correlacionan directamente con artefactos J2EE conocidos y
elementos del descriptor de despliegue, incluidos los códigos de los siguientes tipos de
artefactos y destinos de generación:
- EJB
- Servlets
- Clases Java
- Servicios web
Nota:
La documentación del XDoclet incluida en este producto
IBM se utiliza con permiso y se incluye en la
siguiente sentencia de atribución de copyright: Copyright (c) 2000-2004, XDoclet
Team. Reservados todos los derechos.