Processamento de Anotação

Os processadores de anotações são utilitários que podem gerar códigos Java adicionais ou outros ficheiros e produzir marcadores de problemas, baseados em anotações Java 5 (JSR-175). Os processadores podem basear-se em APIS de Java 5 Mirror ou em APIs de processamento de anotação de Java 6. A área da janela de preferência Processamento de Anotação permite configurar preferências que se aplicam a todos os processadores num projecto ou espaço de trabalho. A área da janela de preferência Caminho do Fornecedor especifica quais os processadores activados e permite a configuração de processadores individuais.

Activar processamento de anotações

O processamento de anotações é desligado por predefinição e tem de ser ligado através da marcação deste quadrado de confirmação para cada projecto que requer a sua utilização. Só precisa de activar o processamento de uma anotação num projecto para que os processadores de anotações operem no código desse projecto. A simples presença de anotações em código não significa que o processamento de anotações seja necessário; por exemplo, normalmente, as anotações @Deprecated e @Override não exigem processamento.

Activar processamento no editor

quando esta opção é activada, os processadores irão ser executados sempre que sejam feitas alterações no editor Java, bem como sempre que o projecto for compilado. A activação de processadores para executarem no editor permite que estes gerem erros e avisos à medida que escreve. Por exemplo, os processadores podem tracejar a vermelho um valor de anotação deteriorado para indicar um problema semântico que o compilador, por si só, não conseguiria descobrir. contudo, alguns processadores de anotações são bastante lentos e ao serem executados no editor irão interferir na capacidade de utilização do editor. Nesta situação, a desactivação desta opção poderá melhorar o desempenho do editor. Os processadores continuarão a executar sempre que o projecto for compilado. Esta opção não se aplica a processadores de anotação Java 6, os quais Eclipse, de momento, pode somente executar durante uma construção.

Directório de origem gerado

Serão gerados ficheiros no disco relativos ao directório especificado. Por predefinição, este directório chama-se ".apt_generated"; uma vez que começa com um '.' possibilita a sua exclusão por filtragem na vista do Explorador de pacotes. Os ficheiros gerados têm a "derivaçãod" conjunto de bits; quando um projecto é limpo, todos os ficheiros no directório de origem gerado serão removidos. Recomenda-se só utilizar este directório para ficheiros gerados por processadores. Não coloque ficheiros criados manualmente neste directório e não utilize um directório já existente como o directório de origem gerado.

Opções de processador

As opções introduzidas aqui estão disponíveis através da interface AnnotationProcessorEnvironment (para processadores Java 5) ou da interface ProcessingEnvironment (para processadores Java 6). Algumas opções são facultadas automaticamente para processadores Java 5; a sua introdução nesta caixa de diálogo não produz efeito, uma vez que os valores facultados automaticamente irão sobrepor-se aos valores definidos aqui. As opções automáticas são descritas aqui. Para mais informações sobre opções de processador, consulte o tópico na caixa de diálogo de entrada de dados Opções de processador.