Anotando com java 5 em três passos
Autor – Leandro Silva Artigo do Site www.devmeia.com.br
Anotações são essencialmente metadados, que têm por objetivo simplificar o
desenvolvimento de software, possibilitando que em tempo de compilação,
carregamento ou execução de classes, as suas metainformações sejam
acessadas, bem como de seus métodos e campos.
essa é uma ferramenta potencialmente simples e poderosa para geração de
código e configuração de aplicação.
entendeu a teoria? então vamos anotar o que você já aprendeu...
o primeiro passo: o que anotar?
existem muitas anotações já prontas, com diversas finalidades, que poderíamos
discutir nesse artigo, como por exemplo, as anotações do hibernate. porém,
acho mais interessante nesse primeiro momento, vermos como criar a nossa
própria anotação e, posteriormente, em um outro artigo que ficarei devendo,
estudarmos algumas anotações de terceiros.
para começar, vamos criar a nossa anotação, a configuracampoannotation.
figura 1 – a anotação configuracampoannotation.java
como pode ser visto na figura 1, uma anotação é essencialmente uma interface
acrescida de algumas anotações também. no nosso caso, a principal anotação é
@retention, que determina o momento em que poderemos acessar essa
anotação.
qual é o objetivo dessa anotação que criamos? espere mais um pouco e você
verá.
o segundo passo: onde anotar?
criamos no passo anterior a nossa primeira anotação, a
configuracampoannotation (figura 1). agora, vamos utilizá-la para anotar algo
em algum lugar.
figura 2 – a classe anotada usuario.java
conforme a figura 2, criamos uma classe chamada usuario e anotamos os seus
três campos com a nossa anotação, a configuracampoannotation (figura 1).
o que isso quer dizer? quer dizer que em tempo de execução poderemos extrair
metadados sobre esses campos para utilizarmos conforme a nossa necessidade.
trocando em miúdos, em tempo de execução da nossa aplicação, poderemos
saber qual o tipo, o tamanho e a mascara de cada um dos três campos da classe
usuario.
o terceiro passo: como acessar minhas anotações?
já criamos a nossa notação; já anotamos uma classe; agora, vamos para o
terceiro e último passo: acessar essa anotação e utilizar suas informações.
figura 3 – a classe acessaconfiguracaocampo.java
pronto! concluímos o nosso exemplo. ou não...
ou não, porque talvez você esteja com um pouco de dificuldade para entender o
código da figura 3, por ele trabalhar com reflexão. então, vamos entendê-lo um
pouco melhor.
# usuario1.getclass().getdeclaredfields() – retornar um array com todos
os campos (instâncias da classe field) declarados na classe usuario, mesmo
que estes sejam privados.
# field.getannotaions() – retornar um array contendo todas as anotações de
um campo.
simples, não?
vejamos, então, o resultado da execução dessa classe:
figura 4 – o resultado
conclusão: até onde anotar?
nesse breve artigo aprendemos um pouco sobre como criar uma anotação no
java 5 – em apenas três passos simples e objetivos.
agora, a pergunta que fica no ar é: até onde anotar? boa pergunta, não? só
que essa quem vai responder é você!
problemas que envolvem configuração de aplicação, geração de código, e até
mesmo regras de negócio aplicadas ao domínio da informação podem ser
resolvidos com anotações. você pode encarar esses problemas com outros olhos
(“se os teus olhos forem bons, todo o teu corpo será luz” – mt 6:22).
até o próximo artigo!