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:

  1. Selecione uma revisão de código a ser executada.
  2. Visualize as regras aplicadas à revisão de código.
  3. Escolha o código que será executado na revisão.
  4. Execute a revisão de código.
  5. Visualize as descobertas da revisão de código.
  6. Selecione uma descoberta para ver as seguintes informações:

Depois, para aplicar uma correção rápida a uma descoberta na revisão de código, você executa as seguintes tarefas:

  1. Reconheça quando uma correção rápida está disponível para a descoberta.
  2. Veja uma lista de alterações que serão feitas no código pela correção rápida.
  3. Visualize o código original e refatorado antes de aplicar a correção rápida.
  4. Aplique a correção rápida para refatorar o código.
  5. 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:

  1. Na barra de ferramentas, na visualização Revisão de Código Completo, clique no ícone Gerenciar Regras, texto.
  2. Visualização Revisão de Código

  3. Na lista Revisão de Código Selecionada, clique em Revisão de Código Rápida . As pastas de regras para a revisão de código selecionadas são exibidas, conforme mostrado na seguinte captura de tela:
  4. Janela Preferência, Revisão de Código selecionada

  5. 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:
  6. Janela Preferências, categoria Boas Práticas de J2SE, pasta Comparission expandida

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

    texto

  7. 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:



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:

Descobertas de Revisão de Código, reduzida

A visualização Revisão de Código fornece as seguintes informações:



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:

  1. 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:
  2. Descobertas de Revisão de Código, categoria Boas Práticas do J2SE, pasta Comparission expandida

  3. A primeira descoberta começa com EqualsHashCode_Example.java. Logo em seguida, está a regra que foi aplicada:
  4. Substituir sempre java.lang.Object.equals() e java.lang.Object.hashCode()

  5. 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:
  6. Detalhes para a descoberta de revisão de código selecionada.



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:

texto

  1. Clique com o botão direito do mouse na primeira descoberta na lista, conforme mostrado na próxima captura de tela.
  2. 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.
  3. Menu pop-up Correção Rápida

  4. 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:

  1. 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.
  2. Lista de alterações reduzida da Correção Rápida com código fonte original e refatorado

  3. 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:
  4. Lista de alterações expandida da Correção Rápida

  5. 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.
  6. Após a aplicação da correção rápida, você verá um visto próximo à descoberta que você resolveu.
  7. Descobertas de Revisão de Código com Visto

    Próximo ao visto você verá as seguintes informações:

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:

  1. Selecionou uma revisão de código a ser executada.
  2. Visualizou as regras aplicadas à revisão de código.
  3. Escolheu um corpo de código no qual a revisão será executada.
  4. Executou a revisão de código.
  5. Visualizou as descobertas da revisão de código.
  6. Selecionou uma descoberta para ver as seguintes informaçõ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:

  1. Reconheceu quando uma correção rápida está disponível para uma descoberta.
  2. Viu uma lista de alterações que serão feitas no código pela correção rápida.
  3. Visualizou o código original e refatorado.
  4. Aplicou a correção rápida para refatorar o código.
  5. 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:



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:

Conclua o tutorial revisando os objetivos aprendidos no Resumo: Executando uma Revisão de Código.



Feedback
(C) Direitos Autorais IBM Corporation 2000, 2005. Todos os Direitos Reservados.