This content originally appeared on DEV Community and was authored by Mulher Programadora
Problemas com Padrões de Nomenclatura:
Erros Tipográficos:
- Falhas silenciosas por nomes incorretos (ex.: tsetSafetyOverride em vez de testSafetyOverride).
Uso Indevido:
- Não há como garantir que nomes sejam usados apenas nos elementos certos (ex.: nomear uma classe como TestSafetyMechanisms).
Associação de Parâmetros:
Dificuldade em associar parâmetros aos elementos do programa (ex.: codificar tipos de exceção nos nomes dos métodos de teste).
Solução com Anotações:
Exemplo de Anotação: Criação de uma anotação Test para métodos de teste.
Meta-anotações:
- @Retention(RetentionPolicy.RUNTIME): Manter as anotações em tempo de execução.
- @Target(ElementType.METHOD): Anotação permitida apenas em métodos.
Uso Prático:
- A anotação Test marca métodos estáticos sem parâmetros para testes automáticos que falham se lançarem exceções.
- Exemplo: Classe Sample com métodos anotados como testes (alguns válidos, alguns inválidos).
Ferramenta de Teste Simples:
- Teste Runner: Executa métodos anotados com Test reflexivamente.
- Usa Method.invoke e isAnnotationPresent para detectar e executar métodos anotados.
- Captura e relata exceções lançadas pelos métodos de teste.
Anotações com Parâmetros:
- Teste com Exceções: Criação de uma anotação ExceptionTest para testes que passam se lançarem uma exceção específica.
- Tipo de Parâmetro: Class<? extends Throwable> para especificar o tipo de exceção esperada.
Modificação do Teste Runner:
- Adiciona suporte para ExceptionTest.
- Verifica se a exceção lançada é do tipo correto.
Anotações Repetíveis:
- Uso de Arrays:
- Mudança do parâmetro de ExceptionTest para um array de Class.
Anotações @Repeatable:
Permite anotar o mesmo elemento várias vezes com a mesma anotação.
Exemplo: @Repeatable na anotação ExceptionTest.
Processamento de Anotações Repetíveis:
- Cuidado no Processamento:
- Uso de getAnnotationsByType para acessar anotações repetidas e não repetidas.
- Verificação de ambos os tipos de anotação (individual e contêiner).
Conclusão:
Vantagens das Anotações:
- Superioridade das anotações sobre os padrões de nomenclatura para fornecer informações adicionais ao código-fonte.
- Incentivo ao uso de anotações predefinidas e fornecidas por ferramentas.
Importância das Anotações:
Para Programadores:
- Programadores devem utilizar anotações predefinidas e fornecidas por IDEs ou ferramentas de análise estática para melhorar a qualidade das informações de diagnóstico.
- Este resumo destaca os principais pontos discutidos no trecho sobre a evolução do uso de anotações para substituir os padrões de nomenclatura tradicionais, abordando suas vantagens e fornecendo exemplos práticos e sugestões de implementação.
This content originally appeared on DEV Community and was authored by Mulher Programadora
Mulher Programadora | Sciencx (2024-07-04T18:55:06+00:00) Item 39: Prefira as anotações aos padrões de nomenclatura. Retrieved from https://www.scien.cx/2024/07/04/item-39-prefira-as-anotacoes-aos-padroes-de-nomenclatura/
Please log in to upload a file.
There are no updates yet.
Click the Upload button above to add an update.