Ejercicio 1.2: Ejecución de una revisión del código y aplicación de un arreglo rápido
En este ejercicio se da por supuesto que se ha completado el Ejercicio 1.1: Importación de los recursos necesarios. Lo primero que se presenta en el ejercicio es un caso de ejemplo de usuario. Por lo tanto, se asume el rol del desarrollador de software descrito en el caso de ejemplo de usuario.
Escenario de usuario
Un grupo numeroso de desarrolladores dispersos geográficamente está codificando una nueva aplicación
de software. Es importante que los desarrolladores ejecuten revisiones de código rutinarias con el objeto de comprobar si existen problemas en el código.
Uno de los desarrolladores desea ejecutar una revisión del código para comprobar el comportamiento general
del código. Para revisar el código recién escrito a fin de valorar si satisface las recomendaciones de varias áreas, el desarrollador ejecuta una revisión del código rápida automatizada. Esta revisión aplica diversas categorías de reglas suministradas al código. Cada categoría de reglas comprueba la calidad del código en un área específica como, por ejemplo, el rendimiento.
Cuando finaliza la revisión del código, se muestra una lista de problemas encontrados. Cada problema encontrado representa una cadena de caracteres de código que no se ajusta estrictamente a una regla aplicada. Uno de los problemas encontrados tiene un arreglo rápido disponible, de modo que el desarrollador aplica la solución automatizada y corrige el problema inmediatamente.
En la primera parte del ejercicio, va a realizar las tareas siguientes para ejecutar una revisión del código:
- Seleccionar una revisión del código que ejecutar.
- Ver las reglas aplicadas a la revisión del código.
- Elegir el código al que se va a ejecutar la revisión.
- Ejecutar la revisión del código.
- Ver los problemas encontrados en la revisión del código.
- Seleccionar un problema encontrado para ver la información siguiente sobre el mismo:
- Código fuente
- Descripción, ejemplos y soluciones
A continuación, para aplicar un arreglo rápido a un problema encontrado en la revisión del código, va a llevar
a cabo las tareas siguientes:
- Reconocer cuándo hay un arreglo rápido disponible para un problema encontrado.
- Ver una lista de cambios que va a realizar el arreglo rápido en el código.
- Obtener una vista preliminar del código original y refactorizado antes de aplicar el arreglo rápido.
- Aplicar el arreglo rápido para refactorizar el código.
- Obtener una confirmación una vez que se ha aplicado el arreglo rápido.
Ejercicio
Selección de una revisión del código
Para seleccionar una revisión del código:
- En la barra de herramientas de la vista Revisión del código, pulse el icono Gestionar reglas
.

- En la lista Seleccionar revisión del código, pulse Revisión del código rápida. Se muestran las carpetas de reglas para la revisión del código que ha seleccionado, tal como se muestra en la captura de pantalla siguiente:

- Para ver una de las reglas que se van a aplicar a la revisión del código, expanda la carpeta
Recomendaciones de J2SE y, a continuación, la subcarpeta Nulo. La carpeta Nulo muestra una regla con un nivel de gravedad de problema, tal como se muestra en la captura de pantalla siguiente:

Como en una revisión, los iconos de nivel de gravedad se muestran en la ilustración siguiente:

- Pulse Aceptar para elegir la Revisión del código rápida.
Selección de un base de código para la revisión
Para seleccionar el proyecto como base de código para la revisión:
- En la barra de herramientas de la vista Revisión del código, pulse el icono Revisar
(
) > Proyectos > Revisar CodeReview_Examples.
Ejecución de la revisión del código
Una vez que ha seleccionado la base de código para la revisión, se ejecuta la revisión del código. Puede hacer un seguimiento del estado por medio de la barra de estado que se encuentra en la esquina inferior derecha de la vista.
Visualización de los problemas encontrados en la revisión del código
Cuando finaliza la revisión del código, los problemas encontrados se muestran en la vista Revisión del código, tal como se muestra en la captura de pantalla siguiente:

La vista Revisión del código proporciona la información siguiente:
- Estadísticas de la revisión del código: En la línea que está arriba de los problemas encontrados se muestra información sobre la revisión del código más reciente, es decir, tipo, ámbito, número de reglas y archivos incluidos, y número y gravedad de los problemas encontrados.
- Problemas encontrados en la revisión del código: Los problemas que se han encontrado en la revisión del código se listan en la vista Revisión del código, en carpetas. Cada nombre de carpeta le indica la categoría de las reglas aplicadas y el número de problemas encontrados.
Obtención de más información sobre un problema encontrado en la revisión del código
Para obtener más información sobre un problema encontrado en la revisión del código:
- En la vista Revisión del código, desplácese a la carpeta Recomendaciones de J2SE: Comparación. A continuación, expanda la carpeta para que ver los problemas encontrados que contiene, tal como se muestra en la captura de pantalla siguiente:

- El primer problema encontrado empieza con EqualsHashCode_Example.java. La regla que se ha aplicado se indica a continuación del mismo, por ejemplo:
Alterar siempre temporalmente java.lang.Object.equals() y java.lang.Object.hashCode()
- Efectúe una doble pulsación en el primer problema encontrado. Los detalles sobre
el mismo aparecen en dos ubicaciones, tal como se indica en la captura de pantalla y en los puntos siguientes:
- Código fuente: Muestra el código en el que se ha encontrado el problema y resalta la ubicación exacta del mismo.
- Vista Detalles de la revisión del código: Describe más detalladamente el problema encontrado y proporciona ejemplos y soluciones para corregirlo.

Selección de un problema encontrado que dispone de un arreglo rápido
Puede saber si ambos problemas encontrados en la carpeta Recomendaciones: Comparación disponen de un arreglo rápido por los iconos correspondientes. Como en una revisión, los iconos de arreglo rápido se muestran en la ilustración siguiente:

- Pulse el botón derecho del ratón sobre el primer problema encontrado de la lista, tal como se muestra en la captura de pantalla siguiente.
- La elección
del menú emergente Arreglo rápido varía en función de la solución. Para el problema encontrado que ha seleccionado, el arreglo implementa hashCode y equals.

- Pulse Arreglo rápido: Implementar hashCode y equals.
Aplicación del arreglo rápido
El arreglo rápido para el problema encontrado que ha seleccionado implementa hashCode y equals.
Para revisar y aplicar el arreglo rápido al problema encontrado:
- Se visualiza una vista del código al lado de la otra, tal como se muestra en la captura de pantalla siguiente. El código fuente original se encuentra a la izquierda y el código fuente refactorizado que va a crear el arreglo rápido está situado a la derecha. Si decide aplicar el arreglo rápido, añade las líneas de código resaltadas que faltan.

- En la sección Cambios a realizar, expanda la lista para ver exactamente lo que va a cambiar el arreglo rápido y de qué modo, tal como se muestra en la captura de pantalla siguiente:

- Revise los cambios de la lista y, a continuación, pulse Aceptar para aplicar el arreglo rápido a todos los cambios seleccionados de la lista.
- Una vez que se ha aplicado el arreglo rápido, se muestra una marca de selección junto al problema encontrado resuelto.

Junto a la marca de selección se muestra la información siguiente:
- El arreglo rápido que se ha aplicado
- El número de línea donde está el problema encontrado en el código fuente
- La regla de la revisión del código no satisfecha
Ha completado el Ejercicio: Ejecución de una revisión del código y aplicación de un arreglo rápido.
Conclusión del ejercicio
Ha llevado a cabo todas las tareas del Ejercicio: Ejecución de una revisión del código y aplicación de un arreglo rápido.
Tareas para la ejecución de una revisión del código
Al ejecutar esta revisión del código, ha realizado las tareas siguientes:
- Seleccionar una revisión del código que ejecutar.
- Ver las reglas aplicadas a la revisión del código.
- Elegir un cuerpo de código en el que ejecutar la revisión.
- Ejecutar la revisión del código.
- Ver los problemas encontrados en la revisión del código.
- Seleccionar un problema encontrado para ver la información siguiente sobre el mismo:
- Código fuente.
- Descripción, ejemplos y soluciones.
Tareas para la aplicación de un arreglo rápido
Al aplicar el arreglo rápido, ha realizado el conjunto de tareas siguiente:
- Reconocer cuándo hay un arreglo rápido disponible para un problema encontrado.
- Ver una lista de cambios que va a realizar el arreglo rápido en el código.
- Obtener una vista preliminar del código original y refactorizado.
- Aplicar el arreglo rápido para refactorizar el código.
- Obtener una confirmación de que el arreglo rápido se ha aplicado.
Aprovechamiento de la potencia de una revisión del código
La ejecución proactiva de revisiones de código le permite analizar antes los problemas encontrados, lo que significa que también puede resolverlos más pronto, antes de que produzcan los problemas siguientes:
- Afectar al rendimiento, el mantenimiento o la escalabilidad de la aplicación
- Costar a la empresa dinero, tiempo y recursos
Aprovechamiento de la potencia de un arreglo rápido
Al aplicar un arreglo rápido suministrado, dispone de un procedimiento automatizado para resolver un problema encontrado común. Los arreglos rápidos le ayudan de los modos siguientes:
- Corregir un problema de forma coherente cada vez
- Liberar el código y tardar menos tiempo en arreglar problemas.
Para finalizar la guía de aprendizaje revise los objetivos del curso en Resumen: Ejecución de una revisión del código.