Introdução às anotações Java
O desenvolvimento Java baseado em anotações é, sem dúvida, a última tendência de desenvolvimento [Nota do tradutor: Este é um artigo de 2005. Em 2014, não há dúvida de que o uso de anotações se tornou uma boa solução para o desenvolvimento colaborativo de várias pessoas. Dessa forma, a influência mútua e o acoplamento podem ser muito baixos].
O desenvolvimento baseado em anotações libera os desenvolvedores Java de arquivos de configuração complicados. As anotações foram introduzidas pela primeira vez no Java 5.0. As anotações são um dos recursos desta versão do JDK, transferindo o trabalho dos programadores para escrever arquivos de API de amostra Java para o compilador. . O código e a documentação são mais fáceis de manter quando o código-fonte e a documentação da API separados não são mais mantidos. Os exemplos de código gerados também têm menos probabilidade de conter bugs.
As anotações Java são um dos principais recursos do JDK 5, tornando o desenvolvimento mais simples e fácil. As anotações são como uma espécie de meta-informação (meta, que pode ser entendida como informação adicional para programas especiais verem) e podem ser adicionadas ao código. , pode ser usado em declarações de pacotes, declarações de tipo, construtores, métodos, campos, parâmetros e variáveis. Eles fornecem uma maneira eficiente de indicar se um método depende de outros métodos, se é completo, se a classe faz referência a outras classes, etc.
Citando o site oficial da Oracle, "Isso (desenvolvimento baseado em anotações) nos permite evitar ter que escrever uma documentação de API separada em muitos casos. Precisamos apenas habilitar ferramentas para gerar anotações a partir do código-fonte. Este estilo de programação declarativo foi formado. Os programadores dizem, o que precisa ser feito, é só deixar a ferramenta fazer de acordo com o código."
Simplificando, as anotações são um mecanismo que associa metatags a elementos do programa, permitindo ao compilador ou JVM extrair o comportamento do programa a partir de elementos anotados e gerar código interdependente quando necessário.
Na primeira parte desta série de artigos, apresentarei algumas anotações básicas de Java, seus benefícios e alguns exemplos de uso.
Noções básicas de anotação Java
Você precisa entender duas coisas. Uma é a "anotação" (anotação, semelhante a um novo objeto) e a outra é o "tipo de anotação" (tipo de anotação, semelhante a uma definição de classe). usado em No seu código, ele realmente tem um ciclo de vida e escopo de aplicação. O tipo de anotação é usado para definir anotações. type é o tipo construído real usado e a anotação é apenas um uso específico desse tipo.
Ao definir um tipo de anotação, você precisa usar uma marca “arroba” (@, algumas pessoas na China pronunciam como um círculo), seguida pela palavra-chave interface, mais o nome da anotação. Por outro lado, usando o formulário. de anotação também é Primeiro escreva o símbolo "arroba" (@), seguido do tipo de anotação. Esta é a forma mais simples de anotação. Além disso, ao usar anotações, você pode adicionar parênteses após o nome para incluir os parâmetros necessários. ser aprovado. Próximo Você verá exemplos deles:
Exemplo de definição do tipo de anotação: (Tipo de anotação, tipo de anotação, semelhante à definição de uma classe)
Copie o código do código da seguinte forma:
public @interface MinhaAnnotação {
String doAlgo();
}
Usando anotações (instâncias de anotação) em código normal
Copie o código do código da seguinte forma:
@MyAnnotation (doSomething="O que fazer")
public void meumétodo() {
....
}
Tipos de anotação Java (tipos de anotação)
Existem três tipos de anotações:
Marcador: as anotações do tipo marcador não possuem elementos, apenas um nome.
definição:
Copie o código do código da seguinte forma:
// Este tipo de anotação é como um rótulo, sem status
// Um pouco como a interface Serializable sem definição de método
public @interface AMarkerAnnotation {
}
usar:
Copie o código do código da seguinte forma:
@AMarkerAnnotation
public void meumétodo() {
....
}
Anotações de elemento único: anotações de elemento único ou de valor único carregam apenas um dado. Elas podem ser expressas como dados = valor entre parênteses ou apenas um valor pode ser passado (método de escrita simples).
definição:
Copie o código do código da seguinte forma:
public @interface SingleElementAnnotation
{
String doAlgo();
}
usar:
Copie o código do código da seguinte forma:
@SingleElementAnnotation ("Você só pode passar valores do tipo correspondente")
public void meumétodo() {
....
}
Anotações de valor completo ou de vários valores: as anotações do tipo de valor completo têm vários membros de dados. Portanto, os parâmetros devem ser passados usando o formato de sintaxe data=valor completo para cada membro.
definição:
Copie o código do código da seguinte forma:
public @interface FullValueAnnotation {
String doAlgo();
contagem interna;
String data();
}
usar:
Copie o código do código da seguinte forma:
@FullValueAnnotation (doSomething="valor do parâmetro", contagem=1,
data="09-09-2005")
public void meumétodo() {
....
}
Considerações para definir tipos de anotação Java
Coisas a serem observadas ao definir os tipos de anotação:
1. A declaração da anotação deve começar com um símbolo de arroba (@), seguido por uma palavra-chave de interface e o nome da anotação.
2. A declaração do método na anotação não aceita nenhum parâmetro (apenas se parece com um método, mas é essencialmente um domínio de atributos).
3. A declaração do método na anotação não pode ter cláusula throws.
4. Os tipos de retorno do método nas anotações só podem ser os seguintes:
@primitives (6 tipos de dados primitivos, int, byte, etc.)
@String(string)
@Class(classe, como String.class)
@enum(enumeração)
@array dos tipos acima (array, os elementos do array só podem ser um dos tipos acima)
Tipos de anotação Java
Existem dois tipos de anotações no JDK5:
1. Anotações simples (tipos de anotação simples): Esses são os tipos básicos fornecidos pelo Tiger (Tiger é o codinome do JDK1.5?) E só podem ser usados para anotar código comum, mas não podem ser usados para criar outro tipo de anotação personalizado; .
2.Meta anotações: Projetadas especificamente para anotar declarações de outros tipos de anotação. Simplificando, elas são chamadas de anotações de anotações.