Metadata facility para Java 📖 Wikipedia

O Metadata Facility para Java (em português: Recurso de Metadados para Java), popularmente conhecido como Anotações (Annotations), é uma especificação para a linguagem de programação Java que define uma API para anexar metadados estruturados e tipados a campos, métodos, classes e pacotes. Esses metadados indicam atributos particulares que podem ser processados por ferramentas de desenvolvimento em tempo de compilação, por ferramentas de implantação (deployment) ou por bibliotecas em tempo de execução (runtime).^[1]

A especificação foi desenvolvida sob o Java Community Process como JSR 175 e foi lançada oficialmente como parte integrante do J2SE 5.0 (codinome Tiger) em 2004.^[2]

Antes da introdução da JSR 175, os desenvolvedores Java utilizavam abordagens paliativas para associar metadados ao código-fonte, principalmente para configurar o comportamento de frameworks corporativos (como os antigos EJBs) ou mapeamentos de banco de dados. As duas técnicas mais comuns eram:

• Arquivos XML externos: Separação completa da configuração em relação ao código, o que frequentemente resultava no chamado "inferno do XML" (XML hell), tornando a manutenção complexa e propensa a erros de digitação não validados pelo compilador.
• Tags Javadoc (XDoclet): Uso de comentários especiais no código-fonte que eram processados por ferramentas de terceiros antes da compilação. Contudo, por serem apenas comentários textuais, não possuíam checagem de tipos e sumiam completamente após a compilação, impossibilitando sua leitura em tempo de execução.^[3]

A JSR 175 resolveu esses problemas ao criar uma sintaxe nativa, limpa e fortemente tipada que faz parte da gramática da linguagem.

As anotações em Java são declaradas de forma semelhante a uma interface, precedidas pelo caractere `@`. Uma vez definida, ela pode ser aplicada sobre os elementos do código:

// Declaração de uma anotação customizada
public @interface InformacaoAutor {
    String nome();
    int ano() default 2026;
}

// Aplicação da anotação sobre uma classe
@InformacaoAutor(nome = "João Silva")
public class MinhaClasse {
    // Código da classe
}

A especificação introduziu "meta-anotações" (anotações aplicadas sobre outras anotações) para configurar o comportamento dos metadados:^[2]

• `@Retention`: Define até quando a anotação fica disponível. Pode ser retida apenas no código-fonte (`SOURCE`), gravada no arquivo `.class` mas ignorada pela máquina virtual (`CLASS`), ou mantida em tempo de execução (`RUNTIME`), permitindo que seja lida via Reflexão (Reflection).
• `@Target`: Define quais elementos sintáticos podem receber a anotação (ex: apenas métodos, apenas classes, variáveis locais, etc.).

A facilidade de metadados transformou profundamente a arquitetura de softwares em Java. Ela permitiu a transição do modelo de configuração imperativo e centralizado para o modelo declarativo. Frameworks populares como o Spring Framework (a partir da versão 2.5), Hibernate e a especificação JPA (Java Persistence API) abandonaram a dependência massiva de arquivos XML em favor de anotações como `@Entity`, `@Autowired`, `@Table` e `@Test` (utilizada no JUnit), tornando o desenvolvimento mais rápido e legível.^[4]

• Anotação (Java)
• Java Community Process
• Reflexão (computação)
• Injeção de dependência

• JSR 175 – A Metadata Facility for the Java Programming Language (em inglês)
• JSR 250 – Common Annotations (Anotações comuns para Java SE e Jakarta EE) (em inglês)
• JSR 269 – Pluggable Annotation Processing API (Interface para processadores de anotações em tempo de compilação) (em inglês)

• Portal da tecnologia
• Portal das tecnologias de informação