Java: Usando Anotações Predefinidas - dummies

Os tipos e o conteúdo das anotações em Java, como os comentários, são limitados apenas pela sua imaginação. Sim, o Java fornece algumas anotações predefinidas, mas você também pode criar anotações que descrevem os elementos do programa da maneira que desejar. A idéia é que você descreva como uma anotação deve funcionar, fornecer dados para isso e o compilador cuida do resto.

As anotações sempre começam com o símbolo @ (at). Então, quando você vê @Documentado, você sabe que está vendo uma anotação. As seções a seguir indicam mais sobre anotações predefinidas e personalizadas.

Uma anotação predefinida é aquela que existe como parte do Java. Você encontra essas anotações no java. lang. pacote de anotação. Para usá-los, você adiciona import java. lang. anotação. *; para o início do seu pedido. A seguinte lista fornece uma visão geral das anotações predefinidas:

• @Deprecated: Às vezes, um elemento - uma classe, método, campo ou outro recurso de programação - é substituído por um elemento mais novo ou simplesmente não é mais necessário.

  Quando isso acontece, você marca o elemento como obsoleto para que os desenvolvedores sabem que precisam atualizar seu código e parar de usar esse elemento específico. A adição da anotação @Deprecated produz o status obsoleto do elemento na documentação gerada por Javadoc (um utilitário que é usado para criar documentação automaticamente com base no conteúdo dos arquivos de seu código).

• @Documentado: sempre que marcar um elemento como documentado, o utilitário Javadoc o exibe no arquivo de documentação que ele cria com base no conteúdo do arquivo de origem.

• @FunctionalInterface: Especifica que a interface é uma interface funcional usada para classes anônimas e expressões lambda.

• @Inherited : As classes podem herdar características de uma classe pai. Por padrão, isso inclui funcionalidade, como métodos, mas não inclui as anotações da classe pai. Usando a anotação @ Inherited informa Java para aplicar as anotações da classe pai para a subclasse também.

• @Override: Especifica que um elemento de classe filho está substituindo um elemento superclasse (classe pai). Se esta anotação estiver presente e a superclasse não tiver um elemento do mesmo nome, o compilador produz um erro para que você saiba que algo está errado com a substituição.

• @Repeatable: a maioria das anotações são aplicadas apenas uma vez para um elemento específico. No entanto, em alguns casos, você precisa aplicar a anotação mais de uma vez. Esta anotação diz a Java que é aceitável aplicar a anotação a um elemento específico mais de uma vez.

• @Retenção: uma anotação pode afetar apenas o código-fonte; o código fonte eo compilador; ou o código-fonte, compilador e JVM. Esta anotação define o efeito que outra anotação deve ter. Por exemplo, você pode precisar apenas de uma anotação específica da documentação para afetar o código-fonte e o compilador.

• @SafeVarargs: é possível executar operações que não são seguras nos argumentos passados ​​para um método ou construtor. Esta anotação diz que o código não faz nada inseguro e, portanto, não exige todas as verificações usuais. Reduzir o número de cheques torna o aplicativo executado mais rápido.

• @SuppressWarnings: o compilador Java exibe uma série de avisos para sinalizar possíveis problemas. Por exemplo, se você tentar usar um método obsoleto em seu código, o compilador exibirá uma mensagem de aviso sobre isso. Esta anotação indica ao compilador que não exiba tais avisos para o elemento afetado.

• @Target: quando você cria suas próprias anotações, pode ser útil dizer ao compilador que essas anotações devem afetar apenas um tipo de elemento específico. Por exemplo, se você criar um bloco de autor que se destina a aparecer apenas no nível do pacote, você pode limitar a anotação apenas ao tipo de elemento usando a anotação @Target.