Los procesadores de anotaciones son programas de utilidades que pueden generar código Java adicional u otros archivos y generar marcadores de problemas basados en anotaciones de Java 5 (JSR-175). Los procesadores pueden estar basados en las API de duplicación de Java 5 o en las API de proceso de anotación de Java 6. El panel de preferencias de Proceso de anotaciones permite configurar preferencias que se aplican a todos los procesadores de un proyecto o un espacio de trabajo. El panel de preferencias Vía de acceso de fábrica especifica qué procesadores están habilitados y permite la configuración de procesadores individuales.
El proceso de anotaciones está desactivado como valor predeterminado y debe activarse marcando este recuadro de
selección para cada proyecto que lo necesite. Solo es necesario habilitar el proceso de anotaciones en un proyecto para
que los procesadores de anotaciones operen sobre ese código del proyecto. La mera presencia de anotaciones en el código
no significa que el proceso de anotaciones sea necesario; por ejemplo, las anotaciones @Deprecated y
@Override no necesitan proceso normalmente.
Cuando esta opción está habilitada, los procesadores se ejecutarán siempre que se hagan cambios en el editor Java así como siempre que se construya el proyecto. Al habilitar la ejecución de los procesadores en el editor, estos pueden generar errores y avisos al teclear. Por ejemplo, los procesadores pueden marcar en rojo un valor de anotación erróneo para indicar un problema semántico que el compilador solo no sería capaz de descubrir. Sin embargo, algunos procesadores de anotaciones son tan lentos que su ejecución en el editor afecta a la utilización del editor. En esta situación, al inhabilitar esta opción, puede mejorar el rendimiento del editor. Los procesadores seguirán ejecutándose siempre que se construya el proyecto. Esta opción no se aplica a los procesadores de anotaciones de Java 6 que Eclipse sólo puede (por ahora) ejecutar durante una construcción.
Los archivos se generarán en un disco relativo al directorio especificado. El nombre predeterminado de este directorio es ".apt_generated" que al empezar por un signo '.', no aparece en la vista Explorador de paquetes. Los archivos generados tienen el bit "derived" establecido; cuando se limpia un proyecto, todos los archivos derivados bajo el directorio origen generado se eliminarán. Es recomendable utilizar este directorio solamente para los archivos generados por procesadores; no coloque los archivos creados manualmente bajo este directorio y no utilice un directorio preexistente como directorio origen generado.
Las opciones especificadas aquí estarán disponibles a través de la interfaz AnnotationProcessorEnvironment (para procesadores Java 5) o la interfaz ProcessingEnvironment (para procesadores Java 6). Algunas opciones se proporcionan directamente a los procesadores Java 5; especificarlas en este diálogo no tendrá ningún efecto ya que los valores proporcionados automáticamente sobrescribirán los valores establecidos aquí. Las opciones automáticas se describen aquí. Encontrará más información acerca de las opciones de procesador en el tema Diálogo de entrada de Opciones de procesador.