Exercício 1.2: Executando uma Revisão de Código e Aplicando uma Correção Rápida
Este exercício assume que você tenha concluído o Exercício 1.1: Importando os Recursos Obrigatórios. No exercício, você lê primeiro o cenário do usuário. Em seguida, você assume a função de engenheiro de software, descrita no cenário do usuário.
Cenário do Usuário
Um grande grupo de desenvolvedores espalhados pelo mundo está codificando um novo aplicativo de software. É importante que os desenvolvedores executem regularmente revisões de código para verificar problemas no código.
Um dos desenvolvedores quer executar uma revisão de código para ver como ele está indo no geral. Para revisar um código recentemente gravado para avaliar a adesão às boas práticas em várias áreas, o desenvolvedor executa uma revisão de código rápida automatizada. Essa revisão se aplica a várias categorias de regras para codificação fornecidas. Cada categoria de regras verifica a qualidade do código em uma área específica, como o desempenho.
Quando a revisão de código é concluída, você vê uma lista de descobertas. Cada descoberta representa uma cadeia de código que não adere estritamente a uma regra aplicada. Há uma correção rápida disponível para uma das descobertas, então, o desenvolvedor aplica a solução automatizada e corrige o problema rapidamente.
Na primeira parte do exercício, você realiza as seguintes tarefas para executar a revisão de código:
- Selecione uma revisão de código a ser executada.
- Visualize as regras aplicadas à revisão de código.
- Escolha o código que será executado na revisão.
- Execute a revisão de código.
- Visualize as descobertas da revisão de código.
- Selecione uma descoberta para ver as seguintes informações:
- Código fonte.
- Descrição, exemplos e soluções.
Depois, para aplicar uma correção rápida a uma descoberta na revisão de código, você executa as seguintes tarefas:
- Reconheça quando uma correção rápida está disponível para a descoberta.
- Veja uma lista de alterações que serão feitas no código pela correção rápida.
- Visualize o código original e refatorado antes de aplicar a correção rápida.
- Aplique a correção rápida para refatorar o código.
- Obtenha uma confirmação após a aplicação de uma correção rápida.
Exercício
Selecionando uma Revisão de Código
Para selecionar uma revisão de código rápida:
- Na barra de ferramentas, na visualização Complete Code Review, clique no ícone Manage Rules,
.

- Na lista Select Code Review, clique em Quick Code Review. As pastas de regras para a revisão de código selecionadas são exibidas, conforme mostrado na seguinte captura de tela:

- Para ver uma das regras que será aplicada à revisão de código, expanda a pasta J2SE Best Practices e a subpasta Null. A pasta Null mostra uma regra com um nível de gravidade de problema, conforme mostrado na seguinte captura de tela:

Como uma revisão, os ícones de nível de gravidade são mostrados na seguinte figura:

- Clique em OK para escolher a Revisão de Código Rápida.
Selecionando um Código Base a Ser Revisado
Para selecionar o projeto como o código base a ser revisado:
- Na barra de ferramentas, na visualização Revisão de Código, clique no ícone Revisar (
) > Projetos > Revisar CodeReview_Examples.
Executando a Revisão de Código
Depois de selecionar o código base a ser revisado, a revisão de código é executada. Você pode controlar o status verificando a barra de progresso no canto inferior direito da visualização.
Visualizando as Descobertas da Revisão de Código
Quando a revisão de código é concluída, as descobertas são mostradas na visualização Revisão de Código, conforme mostrado na seguinte captura de tela:

A visualização Revisão de Código fornece as seguintes informações:
- Estatísticas da revisão de código: a linha acima das descobertas exibe informações sobre a revisão de código mais recente: tipo, escopo, número de regras e arquivos incluídos e número e gravidade das descobertas.
- Descobertas da revisão de códigos: as descobertas na revisão de código são listadas na visualização Revisão de Código, dentro das pastas. Cada nome de pasta indica a categoria de regras aplicada e o número de descobertas.
Obtendo Informações Adicionais sobre uma Descoberta de Revisão de Código
Para obter informações adicionais sobre uma descoberta na revisão de código:
- Na visualização Revisão de Código, role para a pasta Boas Práticas de J2SE: Comparação. Em seguida, expanda a pasta para mostrar as descobertas contidas, conforme mostrado na seguinte captura de tela:

- A primeira descoberta começa com EqualsHashCode_Example.java. Logo em seguida, está a regra que foi aplicada:
Substituir sempre java.lang.Object.equals() e java.lang.Object.hashCode()
- Clique duas vezes na primeira descoberta. Os detalhes sobre ela são exibidos em dois lugares, como descrito nos seguintes pontos e na captura de tela:
- Código fonte: exibe o código no local em que ocorre a descoberta e realça o seu local exato.
- Visualização Detalhes da Revisão de Código: descreve a descoberta em mais detalhes e fornece exemplos e soluções para corrigi-la.

Selecionando uma Descoberta que Tem uma Correção Rápida
Você pode dizer que as descobertas na pasta Boas Práticas: Comparação têm uma correção rápida por seus ícones. Como uma revisão, os ícones de correção rápida são mostrados na seguinte figura:

- Clique com o botão direito do mouse na primeira descoberta na lista, conforme mostrado na próxima captura de tela.
- A opção do menu pop-up Correção Rápida varia dependendo da solução. Para a descoberta selecionada, a correção deve implementar hashCode e iguais.

- Clique em Correção Rápida: Implementar HashCode e Iguais.
Aplicando a Correção Rápida
A correção rápida para a descoberta selecionada deve implementar hashCode e iguais.
Para revisar e aplicar a correção rápida à descoberta:
- Você vê uma visualização lado a lado do código, conforme mostrado na seguinte captura de tela. O código fonte original está à esquerda e o código fonte refatorado que deveria ser criado pela correção rápida, à direita. Se você decidir aplicar a correção rápida, ela anexará as linhas de código ausentes que estão realçadas.

- Na seção Alterações a Serem Executadas, expanda a lista para ver exatamente o que a correção rápida irá alterar e como, conforme mostrado na seguinte captura de tela:

- Revise as alterações na lista. Em seguida, clique em OK para aplicar a correção rápida a todas as alterações selecionadas na lista.
- Após a aplicação da correção rápida, você verá um visto próximo à descoberta que você resolveu.

Próximo ao visto você verá as seguintes informações:
- A correção rápida aplicada
- O número da linha no código fonte onde a descoberta está localizada
- A regra na revisão de código para a qual não houve adesão
Você concluiu o Exercício: Executando uma revisão de código e aplicando uma correção rápida.
Agrupamento de Exercício
Você executou todas as tarefas no Exercício: Executando uma revisão de código e aplicando uma correção rápida.
Tarefas para a Execução de uma Revisão de Código
Quando executou essa revisão de código, você realizou as seguintes tarefas:
- Selecionou uma revisão de código a ser executada.
- Visualizou as regras aplicadas à revisão de código.
- Escolheu um corpo de código no qual a revisão será executada.
- Executou a revisão de código.
- Visualizou as descobertas da revisão de código.
- Selecionou uma descoberta para ver as seguintes informações:
- Código fonte.
- Descrição, exemplos e soluções.
Tarefas para Aplicação de uma Correção Rápida
Quando aplicou a correção rápida, você executou o seguinte conjunto de tarefas:
- Reconheceu quando uma correção rápida está disponível para uma descoberta.
- Viu uma lista de alterações que serão feitas no código pela correção rápida.
- Visualizou o código original e o refatorado.
- Aplicou a correção rápida para refatorar o código.
- Obteve uma confirmação de que a correção rápida foi aplicada.
Alavancando o Poder de uma Revisão de Código
Executando proativamente as revisões de código, você pode analisar as descobertas antecipadamente. Isso significa que você também pode eliminá-las logo no início, antes que elas levem aos seguintes problemas:
- Conseqüências no desempenho, na manutenção ou na escalabilidade do aplicativo
- Gastos financeiros, de tempo e de recursos da empresa
Alavancando o Poder de uma Correção Rápida
Aplicando uma correção rápida fornecida, você terá uma forma automatizada para resolver uma descoberta comum. As correções rápidas ajudam das seguintes formas:
- Corrigindo um problema sempre de forma consistente
- Liberando o código e gastando menos tempo com correções
Conclua o tutorial revisando os objetivos aprendidos no Resumo: Executando uma Revisão de Código.