O conceito mais básico é: anotações são metadados.
São dados adicionais que você relaciona com classes, métodos, atributos, parâmetros e variáveis.
Os dados podem ser usados em tempo de compilação e de execução, conforme definição da anotação.
Pré-processamento durante a compilação
Em tempo de compilação, as anotações podem servir, por exemplo, para geração de código adicional ou até mesmo de modificação no bytecode da classe.
As anotações de tempo de compilação são removidas no bytecode e não ficam disponíveis em tempo de execução.
Vejamos algumas ideias sobre o que é possível fazer com isso.
Geradores e manipuladores de código
Por exemplo, o Hibernate pode adicionar métodos wrappers aos getters originais da classe para conseguir carregar os dados em modo lazy. Falei grego? Isso significa que se você tem as entidades entidades Cliente
e Conta
e chama um método cliente.getConta()
, na verdade chamará um método substituto gerado pelo Hibernate que, no caso da conta não ter sido já lida do banco de dados, fará um SELECT
e criará o objeto conta
com os respectivos dados, retornando então o valor carregado.
Outro exemplo de pré-processamento é o projeto Lombok. Ele é capaz de gerar as rotinas mais comuns usadas em POJOs, como getters, setters, toString() e hashCode(). Veja um exemplo, veja o que a anotação @Data
é capaz de fazer:
@Data(staticConstructor="of")
public class Company {
private final Person founder;
private String name;
private List<Person> employees;
}
O código acima é equivalente ao seguinte:
public class Company {
private final Person founder;
private String name;
private List<Person> employees;
private Company(final Person founder) {
this.founder = founder;
}
public static Company of(final Person founder) {
return new Company(founder);
}
public Person getFounder() {
return founder;
}
public String getName() {
return name;
}
public void setName(final String name) {
this.name = name;
}
public List<Person> getEmployees() {
return employees;
}
public void setEmployees(final List<Person> employees) {
this.employees = employees;
}
@java.lang.Override
public boolean equals(final java.lang.Object o) {
if (o == this) return true;
if (o == null) return false;
if (o.getClass() != this.getClass()) return false;
final Company other = (Company)o;
if (this.founder == null ? other.founder != null : !this.founder.equals(other.founder)) return false;
if (this.name == null ? other.name != null : !this.name.equals(other.name)) return false;
if (this.employees == null ? other.employees != null : !this.employees.equals(other.employees)) return false;
return true;
}
@java.lang.Override
public int hashCode() {
final int PRIME = 31;
int result = 1;
result = result * PRIME + (this.founder == null ? 0 : this.founder.hashCode());
result = result * PRIME + (this.name == null ? 0 : this.name.hashCode());
result = result * PRIME + (this.employees == null ? 0 : this.employees.hashCode());
return result;
}
@java.lang.Override
public java.lang.String toString() {
return "Company(founder=" + founder + ", name=" + name + ", employees=" + employees + ")";
}
}
Ajuda ao desenvolvedor
Além disso, as anotações podem ser usadas para certos tipos de validação na compilação. Tome por exemplo a anotação @Override
. Ela define que um método da subclasse está sobrescrevendo um método da superclasse. Aparentemente isso não ajuda em nada... até que alguém altere a assinatura do método na superclasse. Se alguém alterar o método na superclasse o seu método da subclasse passaria a ser um método diferente. Nesse caso, o compilador vai avisar que o seu método com @Override
não está está sobrescrevendo mais nada! Isso ajuda muito a detectar problemas, por exemplo, ao atualizar uma biblioteca.
O céu é o limite
Outras ferramentas geram arquivos de configuração baseados nas anotações para melhorar o desempenho no tempo de execução.
Enfim, você mesmo pode fazer o seu processador de anotações para rodar na compilação de um programa e gerar o que você quiser, basta usar a API APT (Annotation Processing Tool), disponível desde o Java. Veja um artigo sobre o assunto (em Inglês).
Inspeção em tempo de execução
Já as anotações que são mantidas em tempo de execução podem ser usadas por bibliotecas e frameworks para identificar os elementos e executar anotações adicionais.
Configuração automática
No caso do Spring, por exemplo, você deve ter visto que pode anotar a classe da seguinte forma:
@Component
public class MessagePrinter { ... }
Qual é a mágica aqui? Quando o Spring for iniciado através do listener no seu web.xml
, ele vai ler todas as classes dentro do(s) pacote(s) configurado(s) e adicionar à lista de componentes gerenciados sempre que encontrar uma anotação como essa.
Aí você não precisa mais daqueles XMLs gigantescos que precisavam ser atualizados sempre que você mudava uma classe de pacote ou a renomeava.
Para mais detalhes sobre o Spring, leia meu artigo Quais anotações usar nos componentes do Spring 3.
Injeção de Dependências
Além disso, uma anotação como @Autowired
permite a você especificar ao Spring que aquele atributo deve ser preenchido com algum componente daquele tipo. Exemplo:
@Autowired ClienteDAO clienteDAO;
Pronto. Sem XML, sem frescura. Se existir uma classe ClienteDAO
com uma anotação do Spring, ele vai automaticamente criar uma instância dela e atribuir ali!
Formatação automática
Muitos frameworks fazem a mágica de enviar e recuperar dados automaticamente de formulários HTML, bancos de dados, arquivos, etc. Isso é bem legal, mas como especificar o formato dos dados? Lembrando que, por exemplo, um atributo de data pode ter diferentes representações num mesmo conjunto de dados.
Por exemplo, no JPA é possível especificar se o campo com um Date
deve salvar apenas a data ou o horário também:
@Temporal(TemporalType.DATE)
@Column(name="CAMPO_DATA")
public Date getData()
Sem isso, você teria que escrever código ou configuração num arquivo.
No Spring, você pode usar a anotação @DateTimeFormat
para definir qual o formato da data quando este for convertido de e para uma String. Assim o Spring pode automaticamente receber os dados submetidos de um formulário HTML e convertê-los adequadamente para os tipos de uma classe.
Ao infinito e além
Mais uma vez, o limite para o uso de anotações em tempo de execução é proporcional à criatividade do desenvolvedor.
Considerações
O maior cuidado que todo desenvolvedor precisa ter, em minha experiência, é atentar para o fato de que as anotações são "estáticas". Isso significa que se um determinado elemento anotado pode ter uma função em um momento e outra função em outro momento, talvez seja o caso de usar uma configuração externa.
Só para citar um exemplo, se você usou anotações para configurar Injeção de Dependências com @Autorired
e depois decidiu mudar o objeto injetado por uma subclasse, vai precisar recompilar o código adicionando um @Qualifier
. Com a configuração em XML, você não precisaria disso. Então, existem alguns casos onde a configuração por XML dá uma maior flexibilidade para o gerenciamento da aplicação fora do ambiente de desenvolvimento.
De qualquer forma, as anotações são um recurso extremamente poderoso e flexível da plataforma Java. Elas são metadados que podem ser lidos por frameworks e bibliotecas em detrimento de configuração via XML e programação imperativa.