Processamento de Anotações

Os processadores de anotações são programas utilitários que podem gerar código Java adicional ou outros arquivos e produzir marcadores de problemas, com base em anotações do Java 5 (JSR-175). Os processadores podem ser baseados nas APIs de Espelhamento do Java 5 ou nas APIs de Processamento de Anotação do Java 6. A área de janela de preferência do Processamento de Anotações permite a configuração de preferências que se aplicam a todos os processadores em um projeto ou espaço de trabalho. A área de janela de preferência do Caminho do Depósito de Informações do Provedor especifica quais processadores estão ativados e permite a configuração de processadores individuais.

Ativar processamentos de anotações

O processamento de anotações fica desativado por padrão, e deve ser ativado selecionando essa caixa de opções para cada projeto que precisar dele. Só é necessário ativar o processamento de anotações em um projeto para que os processadores de anotações funcionem no código do projeto. A simples presença de anotações no código não significa que o processamento de anotações seja necessário; por exemplo, as anotações @Deprecated e @Override geralmente não requerem processamento.

Ativar Processamento no Editor

Quando essa opção estiver ativada, os processadores serão executados sempre que forem feitas alterações no editor Java, bem como sempre que o projeto for construído. A ativação de processadores para execução no editor permite que eles gerem erros e avisos importantes à medida que você digita. Por exemplo, os processadores poderão rabiscar em vermelho um valor de anotação inválido para indicar um problema semântico que o compilador conseguirá descobrir sozinho. No entanto, alguns processadores são lentos o suficiente que executá-los no editor interferirá na usabilidade do editor. Nesta situação, desativar essa opção poderá aprimorar o desempenho do editor. Os processadores ainda executarão sempre que o projeto for construído. Esta opção não se aplica aos processadores de anotação do Java 6, que o Eclipse só pode (agora) executar durante um build.

Diretório de Origem Gerado

Serão gerados arquivos no disco em relação ao diretório especificado. Por padrão, este diretório é chamado de ".apt_generated", que desde que comece com '.' faz com que ele seja filtrado na visualização Explorador de Pacotes. Os arquivos gerados possuem o conjunto de bits "derivado"; quando um projeto é limpo, todos os arquivos derivados no diretório de origem gerado são removidos. Recomenda-se utilizar esse diretório apenas para arquivos gerados pelos processadores; não coloque nenhum arquivo criado manualmente nesse diretório e não utilize um diretório preexistente como o diretório de origem gerado.

Opções do Processador

As opções digitadas aqui serão disponibilizadas via interface AnnotationProcessorEnvironment (para processadores Java 5) ou ProcessingEnvironment (para processadores Java 6). Determinadas opções são fornecidas automaticamente para os processadores Java 5; digitá-las nesse diálogo não terá efeito, uma vez que os valores fornecidos automaticamente substituirão os valores definidos ali. As opções automáticas são descritas aqui. Informações adicionais sobre as opções do processador estão no tópico no diálogo de entrada Opções do Processador.